Útgáfa 1.0.0-alpha.1nýjast
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

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ð.
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: trueAllt 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.json1.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:
Settu sóknarlykilinn á hvern hnútpunkt fyrir skref 6.
Notaðu Enterprise-gildin (lyklana tvo hér að ofan) í skrefi 4.
Í 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.
- Skráðu þig inn á Adverant-reikninginn þinn á
https://account.adverant.ai. - Í uppsetningunni skaltu opna Þessi uppsetning (This installation) og síðan Leyfi (Licence). Þar birtist einnota kóði og fingrafar uppsetningarinnar.
- Á 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.
- Ýttu á yfirtökuhnappinn. Uppsetningin bætist við Uppsetningar (Deployments) á reikningnum þínum, ásamt útgáfu hennar og stöðu leyfis.
- 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.
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á.
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).
Með nexusctl
nexusctl licence import <licence-id>.jsonnexusctl 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ð.
Settu sóknarlykilinn á hvern hnútpunkt og endurræstu gámaumhverfið þar.
Sæktu Enterprise-pakkann af niðurhalssíðunni (Downloads) og sannreyndu hann og myndir hans eins og lýst er hér að ofan.
Breyttu gildunum tveimur í núverandi gildaskrá þinni:
edition: enterpriseogenterprise.enabled: true. Breyttu engu öðru.Keyrðu forathugun (preflight) með nýju skránni.
nexusctl preflight --context harrow-prod --values harrow-values.yamlUppfæ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 45mVið 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: 2Bí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=900sFlyttu inn leyfið, með einhverri af leiðunum þremur hér að ofan.
Í 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á.
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.
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 þá.




