InnskráningBóka kynningu

Kafli 2.7

Uppsetning á Enterprise og virkjun leyfis

Hvað breytist þegar þú setur upp Enterprise-útgáfuna, hvernig á að biðja um leyfi af Adverant-reikningnum þínum, þrjár leiðir til að flytja það inn ásamt öllum höfnunarkóðum og hvernig Harrow Port Authority færði Community-tilraunaverkefni sitt yfir í Enterprise á staðnum án þess að tapa neinu.

Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

17 mínútna lestur

Enterprise-uppsetning skiptist í tvo helminga og þeir berast eftir ólíkum leiðum. Enterprise-myndirnar fylgja Enterprise-pakkanum (chart) og eru sóttar með sóknarlykli (pull token). Leyfið kemur sem undirrituð skrá af Adverant-reikningnum þínum og þú flytur hana inn í keyrandi uppsetninguna. Hvorugur helmingurinn virkar án hins: myndir án leyfis keyra á Community-grunnstigi og leyfi án Enterprise-mynda hefur ekkert til að kveikja á.

Hjá Harrow Port Authority gerðum við þetta í þeirri röð, sex vikum eftir Community-tilraunaverkefnið í kafla 2.6, Uppsetning á Community á Kubernetes. Uppfærslan í Enterprise-pakkann tók einn viðhaldsglugga; innflutningur á leyfinu tók tvær mínútur. Þessi kafli fjallar um báða helmingana. Hann byrjar á nýrri uppsetningu og endar á því að núverandi Community-uppsetning er færð á sama stað.

Tvær samhliða brautir sem liggja inn í einn reit hægra megin merktan „Enterprise installation“. Efri braut: „Adverant account: Downloads“ liggur í „Enterprise chart and its images lock“, síðan í „helm install or helm upgrade, edition: enterprise“, með hliðarreitnum „pull token on every node“ tengdum við sig. Neðri braut: „Adverant account: Deployments“ liggur í „signed licence file“, síðan í „import into the running installation“. Báðar brautir mætast við reitinn hægra megin. Undir honum stendur skýringarlínan „images without a licence run at the Community floor“.
Helmingarnir tveir í Enterprise-uppsetningu og hvaðan hvor um sig kemur.

Hvað er ólíkt með Community

Tvö gildi og pakkinn sem les þau.

# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
  enabled: true

Allt annað í gildaskránni (values file) helst nákvæmlega eins og það var, einkum heiti uppsetningarinnar og vörsluaðilarnir. Lyklarnir tveir verða að stemma og pakkinn hafnar edition: enterprise með enterprise.enabled: false, eða öfugt.

Útgáfan verður einnig að stemma við myndalæsingu (images lock) pakkans. Hver pakki inniheldur læsingu fyrir eina útgáfu og Enterprise-læsingin telur upp Community-myndirnar auk Enterprise-útgáfnanna. Ef Enterprise-gildaskrá er beint að Community-pakkanum stöðvast úrvinnslan með files/images.lock.json is the community lock; this install is edition enterprise. Því þarf Enterprise-uppsetningin Enterprise-pakkann.

Enterprise-pakkinn og safnpakkinn eru á niðurhalssíðunni (Downloads) á Adverant-reikningnum þínum, sem fylgir leyfinu þínu. Pakkaskráin heitir það sama og sú fyrir Community, nexus-1.0.0-alpha.1.tgz, svo geymdu þær í aðskildum möppum. Sannreyndu hana nákvæmlega eins og lýst er í kafla 2.4, Að sækja og sannreyna útgáfu, gegn útgáfulyklinum sem þú athugaðir fingrafarið á:

nexusctl verify enterprise/nexus-1.0.0-alpha.1.tgz
tar -xzf enterprise/nexus-1.0.0-alpha.1.tgz -C enterprise
jq -r '.version, .edition' enterprise/nexus/files/images.lock.json
1.0.0-alpha.1
enterprise

Keyrðu síðan undirskriftarlykkjuna úr kafla 2.4, Að sækja og sannreyna útgáfu, yfir enterprise/nexus/files/images.lock.json. Hún nær bæði yfir Enterprise-myndirnar og þær samnýttu.

Niðurhalstáknið

Community-myndir eru opinberar. Enterprise-myndir þurfa sóknarlykil af síðunni Sóknarlyklar og uppsetningarskipanir (Pull tokens and install commands) á reikningnum þínum, stilltan fyrir gámaumhverfi (container runtime) hnútpunktanna þinna eins og kafli 2.4, Að sækja og sannreyna útgáfu, skref 3, sýnir. Á k3s er það configs-færsla fyrir registry.adverant.ai í /etc/rancher/k3s/registries.yaml á hverjum hnútpunkti.

Búðu til einn lykil fyrir hvern klasa og gefðu honum gildistíma sem þú tekur eftir. Þegar lykill rennur út halda keyrandi belgjar (pods) áfram, en belgur sem er endurúthlutaður á hnútpunkt sem er ekki enn kominn með myndina getur ekki sótt hana. Við settum lokadagsetningu lykilsins í sama dagatal og skírteinisins.

Ný uppsetning á Enterprise

Ef þú ert að setja upp Enterprise frá grunni skaltu fylgja kafla 2.6, Uppsetning á Community á Kubernetes, skref fyrir skref, með þremur frávikum:

  1. Settu sóknarlykilinn á hvern hnútpunkt fyrir skref 6.

  2. Notaðu Enterprise-gildin (lyklana tvo hér að ofan) í skrefi 4.

  3. Í skrefi 6 skaltu setja upp úr Enterprise-pakkaskránni sem þú sóttir:

    helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

Allt á eftir uppsetningarskipuninni er eins og í kafla 2.6, Uppsetning á Community á Kubernetes, og það sama gildir um regluna varðandi --wait: ekki nota það. Ef þú setur upp með nexusctl í staðinn skaltu bæta --edition enterprise við skipunina:

nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterprise

Þegar öll vinnuálög eru tilbúin skaltu fara í gegnum fyrstu keyrsluna í kafla 2.12, Fyrsta keyrslan. Leyfið er eitt af þeim sex atriðum sem stjórnborðið telur upp áður en nokkur skráir sig inn. Þangað til það er flutt inn keyrir uppsetningin á Community-grunnstigi og öll Enterprise-svæði eru sýnd grá með lás.

Beðið um leyfið

Leyfi frá Adverant er gefið út fyrir auðkenni einnar uppsetningar, það sem lyklageymslan bjó til undir keys.installationName við uppsetningu. Reikningurinn þarf því að vita hvaða uppsetningu þú átt við áður en hann getur gefið út leyfi.

  1. Skráðu þig inn á Adverant-reikninginn þinn á https://account.adverant.ai.
  2. Í uppsetningunni skaltu opna Þessi uppsetning (This installation) og síðan Leyfi (Licence). Þar birtist einnota kóði og fingrafar uppsetningarinnar.
  3. Á reikningnum þínum skaltu opnaTaka yfir uppsetningu (Claim a deployment) og slá inn kóðann. Berðu síðan saman fingrafarið sem reikningurinn fékk við það sem uppsetningin sýnir, hóp fyrir hóp; hver hópur verður að stemma.
  4. Ýttu á yfirtökuhnappinn. Uppsetningin bætist við Uppsetningar (Deployments) á reikningnum þínum, ásamt útgáfu hennar og stöðu leyfis.
  5. Adverant gefur út leyfið fyrir þá uppsetningu. Sæktu skrána af reikningnum þínum; hún er nefnd eftir leyfisauðkenninu sínu, <licence-id>.json.

Yfirtökukóði virkar einu sinni og í stuttan tíma. Ef hann rennur út hafnar reikningurinn honum með CLAIM_CODE_EXPIRED og uppsetningin sýnir nýjan.

Taka yfir uppsetningu
Taka yfir uppsetningu
Uppsetning tekin yfir á Adverant-reikningnum. Einnota kóðinn fer fyrst inn, síðan er fingrafarið borið saman í fjögurra stafa hópum, svo enginn geti tekið yfir uppsetningu sem hann stendur ekki fyrir framan.

Tvær aðrar leiðir eru til og kafli 2.13, Leyfi, fjallar ítarlega um þær báðar. Tæki (appliances) og jaðarbúnaður (edge kits) hafa engan skjá til að sýna kóða, svo þau eru tekin yfir með yfirtökulykli sem prentaður er á kassann, sleginn inn á Slá inn yfirtökulykil (Enter a claim key) eða lesinn úr pöntunarskrá framleiðanda. Uppsetning án útleiðar notar Ótengd skipti (Offline exchange): hún býr til undirritaða leyfisbeiðniskrá, þú flytur hana á reikninginn þinn og flytur leyfisskrána til baka. Einu sinni á ári býr hún til undirritað notkunaryfirlit á sama hátt. Hver skrá í skiptunum er undirrituð, svo skrá sem breytist á leiðinni er hafnað, með LICENCE_REQUEST_SIGNATURE_INVALID fyrir beiðni og USAGE_FILE_SIGNATURE_INVALID fyrir notkunarskrá.

Ótengd skipti
Ótengd skipti
Ótengdu skiptin á Adverant-reikningnum. Undirritaðar skrár berast handvirkt í báðar áttir og skrá sem breytist á leiðinni er hafnað með nafni.

Hvað leyfisskráin geymir

Leyfið er JSON-skjal á sniðinu nexus-licence/v1, undirritað tvisvar af Adverant með tveimur óháðum lyklum. Þú þarft ekki að lesa það, en það hjálpar að vita hvað er í því þegar einhver spyr hvað þú hafir keypt.

Reitur Hvað stendur í því
licence_id Eigið auðkenni leyfisins, UUID (universally unique identifier) í lágstöfum
type alpha, evaluation eða commercial
licensee Heiti skipulagsheildarinnar og viðskiptavinaauðkenni hjá Adverant
scope Uppsetningin sem það er fyrir og allar skipulagsheildir sem úthlutun nefnir
edition enterprise
grants Eiginleikahóparnir sem það opnar, hver um sig fyrir alla uppsetninguna eða fyrir tilgreindar skipulagsheildir
add_ons og domain_packs Getuþættir með sérstöku leyfi; Birgða- og siglingapakkinn (Logistics and maritime pack) er einn slíkur
metric Hvernig leyfið er talið, named-seat, per-core eða per-environment, og magnið
term starts_on, ends_on, og fjöldi viðvörunar- og greiðslufrestsdaga
matrix Útgáfa útgáfufylkisins sem það var skrifað gegn
signatures Tvær undirskriftir Adverant

Prufuútgáfuleyfi gildir í mesta lagi í 30 daga, fyrir allt að fimm nafngreinda einstaklinga, án frests. Viðskiptaleyfi varar við 30 dögum áður en það rennur út og veitir síðan 30 daga frest (grace period) samkvæmt sjálfgefinni stillingu. Hvað gerist á hverju þrepi þess stiga kemur fram í kafla 2.13, Leyfi.

Undirskriftirnar ná yfir skjalið eins og Adverant bjó það til. Sendu það nákvæmlega eins og þú fékkst það; ekki opna það í ritli sem gæti sniðið það til.

Leyfið flutt inn

Aðeins uppsetningarstjóri getur flutt inn leyfi: eigandi eða stjórnandi allrar skipulagsheildarinnar sem á uppsetninguna, á meðan hann er skráður inn í hana. Fullur kerfisstjóri (platform administrator) getur einnig flutt það inn. Leyfið er aldrei pakkagildi eða skrá sem tengd er inn í belg. Það fer inn í innskráningarþjónustuna, nexus-auth, sem athugar það án nettengingar gegn traustrótunum sem eru innbyggðar í eigin mynd hennar og skráir það í einni færslu. Þú getur flutt það inn á þrjá vegu og þeir enda allir á sama stað.

Í stjórnborðinu

Í fyrstu keyrslunni skaltu opna Sex atriði áður en nokkur skráir sig inn (Six things before anyone signs in) og síðan Leyfi (Licence). Síðan Flytja inn leyfið (Import the licence) tekur við skránni: slepptu henni á síðuna eða veldu hana. Síðan athugar hana án nettengingar á uppsetningunni sjálfri, telur síðan upp eiginleikahópana sem hún opnar, ásamt því hvernig hver þeirra er varinn og hversu lengi. Hópar sem leyfið inniheldur ekki haldast á listanum, gráir.

Síðar er sami innflutningur gerður með hnappinum Flytja inn nýtt leyfi (Import a new licence) á leyfissíðu uppsetningarinnar. Þegar leyfi er runnið út býður takmarkaða leyfissíðan upp á Flytja inn endurnýjað leyfi (Import a renewed licence).

Flytja inn leyfið
Flytja inn leyfið
Leyfið flutt inn í stjórnborðinu. Skráin er athuguð á uppsetningunni sjálfri; síðan telur upp hvað hún opnar eftir eiginleikahópum, og skrá sem stenst ekki undirskriftarathugunina er meðhöndluð sem fjarverandi, ásamt kóða sínum.

Með nexusctl

nexusctl licence import <licence-id>.json

nexusctl sendir skrána, óbreytta, á innflutningsleið uppsetningarinnar sem uppsetningarstjóri og tilkynnir stöðu leyfisins eða höfnunarkóðann úr töflunni hér að neðan.

Í gegnum API

Innflutningsleiðin er hluti af forritaskilum (API) innskráningarþjónustunnar, á hosts.auth-vistfanginu þínu. Meginmálið er leyfisskjalið, bæti fyrir bæti:

curl -sS -X POST https://auth.harrow.example/api/v1/installation/licence \
  -H "authorization: Bearer <admin-token>" \
  -H "content-type: application/json" \
  --data-binary @<licence-id>.json

<admin-token> er aðgangslykill innskráðs uppsetningarstjóra. Notaðu --data-binary, aldrei -d, sem fjarlægir línuskil og breytir þannig bætunum sem þú sendir. Leiðin tekur engan fyrirspurnarstreng og ekkert í meginmálinu nema skjalið; meginmáli sem reynir að nefna skipulagsheild eða einstakling á efsta stigi er hafnað áður en nokkuð er lesið.

Gildur innflutningur svarar með 201 Created. Stytt lítur meginmálið svona út:

{
  "licence": {
    "licence_id": "<licence-id>",
    "state": "licensed",
    "edition": "enterprise",
    "licensee": {"name": "Harrow Port Authority", "customer_id": "<customer-id>"},
    "term": {"starts_on": "2026-12-01", "ends_on": "2027-11-30", "warn_days": 30, "grace_days": 30},
    "groups": ["enterprise-base", "..."]
  },
  "organizations": 1,
  "tenants_without_organisation": 0
}

organizations telur skipulagsheildirnar á uppsetningunni sem eru nú með leyfið. tenants_without_organisation telur skipulagsheildir sem leyfið nefnir en þessi uppsetning geymir ekki.

Þegar innflutningi er hafnað

Innflutningur sem er hafnað breytir engu: engin röð er skrifuð og gildandi leyfi, ef það er til staðar, helst eins og það var. Atburðaskrá (audit log) uppsetningarinnar skráir hverja tilraun, þar á meðal þær sem var hafnað.

Kóði Staða Hvað það þýðir Hvað skal gera
LICENCE_SIGNATURE_INVALID 422 Önnur af tveimur undirskriftum Adverant vantar eða stenst ekki sannreyningu; skránni var breytt eftir undirritun Biddu Adverant um skrána aftur; ekki breyta henni
LICENCE_FORMAT_INVALID 422 Skráin er ekki leyfi sem þessi útgáfa getur lesið Sendu skrána nákvæmlega eins og Adverant afhenti hana
LICENCE_ROOT_UNKNOWN 422 Hún er undirrituð með lykli sem þessi uppsetning treystir ekki Biddu um leyfi sem er undirritað fyrir traustrótir þessarar útgáfu, eða uppfærðu
LICENCE_MATRIX_MISMATCH 422 Það er skrifað gegn útgáfufylki sem þessi útgáfa les ekki, eða veitir hóp sem þessi útgáfa þekkir ekki Uppfærðu, eða biddu um leyfi sem er skrifað gegn þessari útgáfu
LICENCE_OTHER_INSTALLATION 409 Það var gefið út fyrir aðra uppsetningu Biddu um leyfi sem er gefið út fyrir auðkenni þessarar uppsetningar
TRANSITION_NOT_PERMITTED 409 Leyfi með þessu auðkenni hefur þegar verið flutt inn; hvert leyfi er flutt inn einu sinni Biddu Adverant um nýtt leyfi ef skilmálarnir þurfa að breytast
LICENCE_REVOKED 403 Adverant hefur afturkallað þetta leyfi Biddu Adverant um nýtt
LICENCE_LOCKED 403 Gildistími leyfisins er ekki hafinn; Community-grunnstigið gildir þangað til Flyttu það inn aftur á fyrsta degi þess eða síðar
RECORD_NOT_FOUND 404 Uppsetningin hefur ekki enn verið lýst yfir, svo hún hefur ekkert auðkenni til að bera saman við Ljúktu við skref fyrsta stjórnandans (kafli 2.12, Fyrsta keyrslan) og flyttu svo inn
VALIDATION_FAILED 400 Meginmálið var ólæsilegt eða yfir 1 MiB, eða fyrirspurnarstrengur var sendur Sendu skrána sem allt meginmálið, án fyrirspurnar

Einn kóði til viðbótar getur borist við vel heppnaðan innflutning, sem tilkynning frekar en höfnun: LICENCE_CLOCK_BEHIND_FLOOR þýðir að klukka uppsetningarinnar sýnir tíma sem er á undan nýjasta tímanum sem hún hefur þegar séð, þannig að leyfið er lesið á þeim síðari tíma. Að færa klukku aftur á bak endurvekur aldrei útrunnið leyfi. Aðeins tímaendurstillingarlykill sem Adverant undirritar fyrir uppsetninguna lækkar grunnmarkið.

Community fært yfir í Enterprise á staðnum

Þetta er það sem við gerðum hjá Harrow. Ekkert er sett upp aftur og ekkert er flutt: þetta er sama uppsetningin, með sama auðkenni og sömu gögnum, og kveikt á meiru af henni. Heiti uppsetningarinnar og vörsluaðilarnir haldast nákvæmlega eins og þeir voru; við uppfærslu athugar vörslukrókurinn (custody hook) hvort lyklageymslan sé þegar frumstillt og gerir ekkert annað.

  1. Settu sóknarlykilinn á hvern hnútpunkt og endurræstu gámaumhverfið þar.

  2. Sæktu Enterprise-pakkann af niðurhalssíðunni (Downloads) og sannreyndu hann og myndir hans eins og lýst er hér að ofan.

  3. Breyttu gildunum tveimur í núverandi gildaskrá þinni: edition: enterprise og enterprise.enabled: true. Breyttu engu öðru.

  4. Keyrðu forathugun (preflight) með nýju skránni.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Uppfærðu útgáfuna í Enterprise-pakkann, aftur án --wait.

    helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

    Við uppfærslu keyra krókarnir áður en nýju belgirnir rúlla inn, og hver gagnagrunnsfærsla (migration) virkjar aðeins þær skrár sem hún hefur ekki virkjað áður. Leyndarmálin sem voru búin til eru lesin aftur úr uppsetningunni og þeim haldið. Helm endar á:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Bíddu eftir vinnuálögunum, nákvæmlega eins og í kafla 2.6, Uppsetning á Community á Kubernetes, skrefi 7.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Flyttu inn leyfið, með einhverri af leiðunum þremur hér að ofan.

  8. Í stjórnborðinu skaltu opna Þessi uppsetning (This installation), síðan Leyfi (Licence) og svo Færa í Enterprise (Move to Enterprise). Síðan les leyfið og sýnir hvað verður sótt og hvað mun breytast áður en nokkuð gerist. Hún telur einnig fólk og efni skipulagsheildarinnar og merkir hvort tveggja sem varðveitt. Ýttu á Sækja og kveikja á (Fetch and switch on). Hver hluti er athugaður gegn útgáfulykli Adverant áður en hann er notaður og eiginleikahóparnir kveikja á sér einn í einu.

Glugginn okkar var klukkustund; vinnan innan hans tók um tuttugu mínútur, mest af því bið eftir skemanu á meðan krókarnir keyrðu. Fólkið í tilraunaverkefninu skráði sig inn næsta morgun á sama vinnusvæði, þar sem Enterprise-svæðin í valmyndinni voru ekki lengur grá.

Frá Community yfir í Enterprise
Frá Community yfir í Enterprise
Community-uppsetning færð í Enterprise. Síðan staðfestir að leyfið sé ósvikið og telur upp hvað verður sótt áður en nokkuð er sótt; fólk og skrár skipulagsheildarinnar eru merkt sem varðveitt.

Eftir innflutninginn

Leyfissíðan undir Þessi uppsetning (This installation) telur upp hvern eiginleikahóp í leyfinu ásamt sætafjölda og gildistíma. Hún segir einnig hvernig hver hluti er afhentur, til dæmis þýddur (compiled) og með leyfi fyrir Enterprise-hóp, eða opinn hugbúnaður fyrir Community-grunnstigið. Hópar utan leyfisins haldast á listanum, gráir. Stjórnendur geta þrengt það sem hópur nær til innan skipulagsheildarinnar; enginn nema Adverant getur víkkað það sem leyfi veitir.

Staða leyfisins er reiknuð út aftur út frá skjalinu og dagsetningunni við hvern lestur, þannig að gildislok verða án tímasetts verks. Allir á uppsetningunni sjá sömu tilkynninguna í stjórnborðinu þegar líður að lokum: LICENCE_ENDS_SOON frá 30 dögum fyrir lok, síðan LICENCE_IN_GRACE á freststímabilinu. Meðlimir sjá tilkynninguna og dagsetningarnar; aðeins uppsetningarstjórar sjá leyfið sjálft. Kafli 2.13, Leyfi, fjallar um endurnýjun og gildislokastigann.

Leyfi og hvað það opnar
Leyfi og hvað það opnar
Þetta er leyfissíða Enterprise-uppsetningar. Tölurnar efst gefa upp sæti og gildistíma; fyrir neðan þær er hver eiginleikahópur talinn upp ásamt því hvernig hann er varinn, og hóparnir utan leyfisins haldast gráir.

Ef þetta mistekst

Hvað þér sjáið Orsök Hvað skal gera
edition=enterprise but enterprise.enabled=false: they must agree Aðeins öðrum af lyklunum tveimur var breytt Breyttu báðum
files/images.lock.json is the community lock; this install is edition enterprise Community-pakkinn var notaður Notaðu Enterprise-pakkann af niðurhalssíðunni (Downloads)
image ... is a enterprise image; a community install takes only community images Heiti á Enterprise-mynd barst í Community-úrvinnslu Athugaðu edition og pakkamöppuna
ImagePullBackOff á Enterprise-mynd eftir uppfærsluna Hnútpunktur er ekki með sóknarlykil, eða lykillinn hans er ekki lengur gildur Athugaðu registries.yaml á þeim hnútpunkti, eða búðu til nýjan lykil
Höfnunarkóði leyfis Sjá höfnunartöfluna hér að ofan Fylgdu röðinni hans; engu var breytt

Þegar leyfissíðan sýnir Enterprise og hópana sem þú áttir von á er uppsetningin komin með leyfi. Næsta stopp er fyrsta keyrslan í kafla 2.12, Fyrsta keyrslan, ef þú hefur ekki tekið yfir uppsetninguna ennþá. Ef þú hefur gert það þarf aðstoðarmaðurinn samt eigin lykla skipulagsheildarinnar fyrir líkön með gervigreind (AI) áður en hann getur svarað nokkrum. Kafli 2.14, Gervigreindarveitur og líkön, sýnir hvernig á að tengja þá.