Različica 1.0.0-alpha.1najnovejša
Poglavje 2.7
Namestitev izdaje Enterprise in uveljavitev licence
Kaj se spremeni ob namestitvi izdaje Enterprise, kako zahtevati licenco prek računa Adverant, trije načini uvoza z vsemi kodami zavrnitev ter kako je organizacija Harrow Port Authority nadgradila svojo pilotno izdajo Community v izdajo Enterprise kar na obstoječi namestitvi in brez izgube podatkov.
To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

Namestitev Enterprise ima dve polovici, ki prispeta po različnih poteh. Slike Enterprise pridejo s karto Enterprise in se prenesejo z žetonom za prenos. Licenca pride kot podpisana datoteka iz vašega računa Adverant, nato pa jo uvozite v delujočo namestitev. Nobena polovica ne deluje brez druge: slike brez licence delujejo na osnovni ravni Community, licenca brez slik Enterprise pa nima česa vklopiti.
Pri Harrow Port Authority smo to izvedli v tem vrstnem redu, šest tednov po pilotnem projektu Community v poglavju 2.6, Nameščanje izdaje Community v okolju Kubernetes. Nadgradnja na karto Enterprise je vzela eno vzdrževalno okno; uvoz licence pa je trajal dve minuti. To poglavje obravnava obe polovici. Začne se s svežo namestitvijo in konča s prehodom obstoječe namestitve Community na istem mestu.
Razlike v primerjavi z izdajo Community
Dve vrednosti in karta, ki ju prebere.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueVse drugo v datoteki z vrednostmi ostane natanko tako, kot je bilo, predvsem ime namestitve in skrbniki. Ključa se morata ujemati, zato karta zavrne edition: enterprise z enterprise.enabled: false ali obratno.
Izdaja se mora ujemati tudi z zaklepom slik karte. Vsak paket karte nosi zaklep za eno izdajo, zaklep Enterprise pa navaja slike Community in gradnje Enterprise. Če datoteko z vrednostmi Enterprise usmerite na karto Community, se upodabljanje ustavi z files/images.lock.json is the community lock; this install is edition enterprise. Namestitev Enterprise torej potrebuje karto Enterprise.
Karta in sveženj Enterprise sta na strani Prenosi v vašem računu Adverant, ki sledi vaši licenci. Datoteka karte ima enako ime kot tista za Community, nexus-1.0.0-alpha.1.tgz, zato ju hranite v ločenih mapah. Preverite jo natanko tako, kot opisuje poglavje 2.4, Pridobivanje in preverjanje izdaje, glede na ključ izdaje, katerega prstni odtis ste preverili:
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
Nato zaženite zanko za preverjanje podpisov iz poglavja 2.4, Pridobivanje in preverjanje izdaje, nad enterprise/nexus/files/images.lock.json. Ta zajema tako slike Enterprise kot tudi skupne slike.
Žeton za prenos (pull token)
Slike Community so javne. Slike Enterprise potrebujejo žeton za prenos s strani Žetoni za prenos in ukazi za namestitev v vašem računu, konfiguriran za izvajalno okolje vsebnikov vaših vozlišč, kot prikazuje poglavje 2.4, Pridobivanje in preverjanje izdaje, 3. korak. V k3s je to vnos configs za registry.adverant.ai v /etc/rancher/k3s/registries.yaml na vsakem vozlišču.
Ustvarite en žeton na gručo in mu določite datum poteka, ki ga boste opazili. Ko žeton poteče, delujoči podi delujejo naprej, vendar pod, ki je prerazporejen na vozlišče, ki slike še nima, le-te ne more prenesti. Datum poteka žetona smo vpisali v isti koledar kot datum poteka potrdila.
Nova namestitev izdaje Enterprise
Če nameščate Enterprise od začetka, sledite poglavju 2.6, Nameščanje izdaje Community v okolju Kubernetes, korak za korakom, s tremi razlikami:
Pred 6. korakom namestite žeton za prenos na vsako vozlišče.
V 4. koraku uporabite vrednosti Enterprise (zgornja dva ključa).
V 6. koraku namestite iz datoteke karte Enterprise, ki ste jo prenesli:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Vse po ukazu za namestitev je enako kot v poglavju 2.6, Nameščanje izdaje Community v okolju Kubernetes, enako pa velja tudi za pravilo glede --wait: ne uporabljajte ga. Če namesto tega nameščate z nexusctl, ukazu dodajte --edition enterprise:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseKo so vse delovne obremenitve pripravljene, pojdite skozi prvi zagon v poglavju 2.12, Prvi zagon. Licenca je ena od šestih stvari, ki jih konzola navede, preden se kdor koli prijavi. Dokler ni uvožena, namestitev deluje na osnovni ravni Community in vsako področje Enterprise je prikazano osivelo s ključavnico.
Zahtevek za licenco
Licenca družbe Adverant se izda za identiteto ene namestitve – tisto, ki jo je shramba ključev ustvarila pod keys.installationName ob namestitvi. Račun mora torej vedeti, katero namestitev mislite, preden lahko izda licenco.
- Prijavite se v svoj račun Adverant na naslovu
https://account.adverant.ai. - V namestitvi odprite Ta namestitev in nato Licenca. Prikažeta se enkratna koda in prstni odtis namestitve.
- V svojem računu odprite Prevzem postavitve in vnesite kodo. Nato primerjajte prstni odtis, ki ga je prejel račun, s tistim, ki ga prikazuje namestitev, skupino za skupino; ujemati se mora vsaka skupina.
- Pritisnite gumb za prevzem. Namestitev se pridruži razdelku Postavitve v vašem računu, skupaj s svojo različico in stanjem licence.
- Adverant izda licenco za to namestitev. Prenesite datoteko iz svojega računa; poimenovana je po svojem ID-ju licence,
<licence-id>.json.
Koda za prevzem deluje enkrat in le kratek čas. Če poteče, jo račun zavrne z CLAIM_CODE_EXPIRED, namestitev pa prikaže novo.
Obstajata še dve drugi poti in poglavje 2.13, Licence, podrobno obravnava obe. Naprave in kompleti za robno omrežje nimajo zaslona za prikaz kode, zato se prevzamejo s ključem za prevzem, natisnjenim na škatli, ki ga vtipkate v Vnos ključa za prevzem ali preberete iz datoteke naročila proizvajalca. Namestitev brez izhodne povezave uporablja Izmenjavo brez povezave: ustvari podpisano datoteko z zahtevo za licenco, vi jo prenesete v svoj račun in datoteko z licenco prinesete nazaj. Enkrat letno na enak način ustvari podpisano izjavo o uporabi. Vsaka datoteka v izmenjavi je podpisana, zato je datoteka, spremenjena na poti, zavrnjena z LICENCE_REQUEST_SIGNATURE_INVALID za zahtevo in USAGE_FILE_SIGNATURE_INVALID za datoteko o uporabi.
Kaj vsebuje datoteka licence
Licenca je dokument JSON v formatu nexus-licence/v1, ki ga je Adverant dvakrat podpisal z dvema neodvisnima ključema. Ni vam ga treba brati, vendar je koristno vedeti, kaj je v njem, ko nekdo vpraša, kaj ste kupili.
| Polje | Kaj navaja |
|---|---|
licence_id |
Lastni ID licence, UUID (univerzalno edinstven identifikator) z malimi črkami |
type |
alpha, evaluation ali commercial |
licensee |
Ime organizacije in ID stranke Adverant |
scope |
Namestitev, za katero velja, in vse organizacije, ki jih podelitev imenuje |
edition |
enterprise |
grants |
Skupine funkcij, ki jih odklene, vsako za celotno namestitev ali za imenovane organizacije |
add_ons in domain_packs |
Zmožnosti, licencirane ločeno; ena takih je paket za logistiko in pomorstvo |
metric |
Kako se licenca šteje, named-seat, per-core ali per-environment, in količina |
term |
starts_on, ends_on ter dnevi opozorila in odloga |
matrix |
Različica matrike izdaj, za katero je bila napisana |
signatures |
Dva podpisa družbe Adverant |
Preizkusna licenca traja največ 30 dni, za največ pet imenovanih oseb, brez obdobja odloga. Komercialna licenca opozori 30 dni pred iztekom in nato privzeto omogoča 30 dni odloga. Kaj se zgodi na vsaki stopnici te lestvice, je opisano v poglavju 2.13, Licence.
Podpisa ščitita dokument v obliki, kot ga je ustvaril Adverant. Pošljite ga natanko takšnega, kot ste ga prejeli; ne odpirajte ga v urejevalniku, ki bi ga lahko preoblikoval.
Uvoz licence
Licenco lahko uvozi le skrbnik namestitve: lastnik ali skrbnik celotne organizacije, ki ima v lasti namestitev, medtem ko je vanjo prijavljen. Uvozi jo lahko tudi polni skrbnik platforme. Licenca nikoli ni vrednost karte ali datoteka, priklopljena v pod. Gre v storitev za prijavo, nexus-auth, ki jo preveri brez povezave glede na korene zaupanja, vgrajene v njeno lastno sliko, in jo zapiše v eni transakciji. Uvozite jo lahko na tri načine in vsi vodijo na isto mesto.
V konzoli
Med prvim zagonom odprite Šest stvari, preden se kdor koli prijavi, in nato Licenca. Stran Uvoz licence sprejme datoteko: povlecite jo na stran ali jo izberite. Stran jo preveri brez povezave v sami namestitvi, nato pa navede skupine funkcij, ki jih odpira, ter kako je vsaka zaščitena in do kdaj. Skupine, ki jih licenca ne vključuje, ostanejo navedene in osivele.
Pozneje je isti uvoz na voljo prek gumba Uvozi novo licenco na strani z licenco namestitve. Ko licenca poteče, omejena stran z licenco ponudi možnost Uvozi podaljšano licenco.
Z orodjem nexusctl
nexusctl licence import <licence-id>.jsonnexusctl pošlje nespremenjeno datoteko na uvozno pot namestitve kot skrbnik namestitve in sporoči stanje licence ali kodo zavrnitve iz spodnje tabele.
Prek vmesnika API
Uvozna pot je del aplikacijskega programskega vmesnika (API) storitve za prijavo na vašem naslovu hosts.auth. Telo zahtevka je dokument licence, bajt za bajtom:
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> je žeton za dostop prijavljenega skrbnika namestitve. Uporabite --data-binary, nikoli -d, saj ta odstrani prelome vrstic in s tem spremeni bajte, ki jih pošljete. Pot ne sprejme nobenega poizvedovalnega niza in v telesu ničesar drugega kot dokument; telo, ki poskuša na najvišji ravni imenovati organizacijo ali osebo, je zavrnjeno, preden se kar koli prebere.
Uspešen uvoz odgovori z 201 Created. Skrajšano telo izgleda takole:
{
"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 šteje organizacije v namestitvi, ki imajo zdaj licenco. tenants_without_organisation šteje organizacije, ki jih licenca imenuje, vendar jih ta namestitev nima.
Ko je uvoz zavrnjen
Zavrnjen uvoz ne spremeni ničesar: nobena vrstica se ne zapiše, veljavna licenca, če obstaja, pa ostane takšna, kot je bila. Dnevnik revizije namestitve beleži vsak poskus, vključno z zavrnjenimi.
| Koda | Stanje | Kaj pomeni | Kaj storiti |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Eden od dveh podpisov družbe Adverant manjka ali ni veljaven; datoteka je bila po podpisu spremenjena | Znova prosite Adverant za datoteko; ne urejajte je |
LICENCE_FORMAT_INVALID |
422 | Datoteka ni licenca, ki bi jo ta izdaja znala prebrati | Pošljite datoteko natanko takšno, kot vam jo je dal Adverant |
LICENCE_ROOT_UNKNOWN |
422 | Podpisana je s ključem, ki mu ta namestitev ne zaupa | Prosite za licenco, podpisano za korene zaupanja te izdaje, ali opravite nadgradnjo |
LICENCE_MATRIX_MISMATCH |
422 | Napisana je za matriko izdaj, ki je ta izdaja ne bere, ali podeljuje skupino, ki je ta izdaja ne pozna | Opravite nadgradnjo ali prosite za licenco, napisano za to izdajo |
LICENCE_OTHER_INSTALLATION |
409 | Izdana je bila za drugo namestitev | Prosite za licenco, izdano za identiteto te namestitve |
TRANSITION_NOT_PERMITTED |
409 | Licenca s tem ID-jem je bila že uvožena; vsaka se uvozi le enkrat | Prosite Adverant za novo licenco, če se morajo pogoji spremeniti |
LICENCE_REVOKED |
403 | Adverant je to licenco umaknil | Prosite Adverant za novo |
LICENCE_LOCKED |
403 | Obdobje veljavnosti licence se še ni začelo; do takrat velja osnovna raven Community | Znova jo uvozite na njen prvi dan ali pozneje |
RECORD_NOT_FOUND |
404 | Namestitev še ni bila deklarirana, zato nima identitete za preverjanje | Dokončajte korak prvega skrbnika (poglavje 2.12, Prvi zagon), nato uvozite |
VALIDATION_FAILED |
400 | Telo ni bilo berljivo ali je presegalo 1 MiB, ali pa je bil poslan poizvedovalni niz | Pošljite datoteko kot celotno telo, brez poizvedbe |
Ob uspešnem uvozu se lahko vrne še ena koda, kot obvestilo in ne zavrnitev: LICENCE_CLOCK_BEHIND_FLOOR pomeni, da ura namestitve kaže zgodnejši čas od najnovejšega časa, ki ga je že zaznala, zato se licenca bere ob tistem poznejšem času. Premik ure nazaj nikoli ne oživi potekle licence. Le žeton za ponastavitev časa, ki ga Adverant podpiše za namestitev, zniža to mejo.
Nadgradnja iz izdaje Community v izdajo Enterprise na obstoječi namestitvi
To je tisto, kar smo naredili pri Harrowu. Nič se ne namesti znova in nič se ne seli: gre za isto namestitev, z isto identiteto in istimi podatki, le da je več tega vklopljenega. Ime namestitve in skrbniki ostanejo natanko takšni, kot so bili; ob nadgradnji kavelj za skrbništvo preveri, ali je shramba ključev že inicializirana, in ne naredi ničesar drugega.
Namestite žeton za prenos na vsako vozlišče in tam znova zaženite izvajalno okolje vsebnikov.
Pridobite karto Enterprise iz razdelka Prenosi ter preverite karto in njene slike, kot je opisano zgoraj.
Spremenite dve vrednosti v svoji obstoječi datoteki z vrednostmi:
edition: enterpriseinenterprise.enabled: true. Ne spreminjajte ničesar drugega.Zaženite predhodno preverjanje z novo datoteko.
nexusctl preflight --context harrow-prod --values harrow-values.yamlNadgradite izdajo na karto Enterprise, spet brez
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mOb nadgradnji se kavlji zaženejo, preden se zavrtijo novi podi, in vsaka selitev uveljavi le datoteke, ki jih prej še ni uveljavila. Ustvarjene skrivnosti se preberejo nazaj iz namestitve in ohranijo. Helm konča z:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Počakajte na delovne obremenitve, natanko tako kot v poglavju 2.6, Nameščanje izdaje Community v okolju Kubernetes, 7. korak.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sUvozite licenco na katerega koli od zgornjih treh načinov.
V konzoli odprite Ta namestitev, nato Licenca in nato Prehod na Enterprise. Stran prebere licenco in prikaže, kaj bo pridobljeno in kaj se bo spremenilo, preden se kar koli zgodi. Prav tako prešteje ljudi in vsebino organizacije ter vsakega označi kot ohranjenega. Pritisnite Pridobi in vklopi. Vsak del se pred uporabo preveri glede na ključ izdaje družbe Adverant, skupine funkcij pa se vklapljajo ena za drugo.
Naše okno je bilo dolgo eno uro; delo znotraj njega je trajalo približno dvajset minut, od tega večino časa čakanje na shemo med izvajanjem kavljev. Udeleženci pilotnega projekta so se naslednje jutro prijavili v isti delovni prostor, kjer področja Enterprise v meniju niso bila več osivela.
Po uvozu
Stran z licenco pod Ta namestitev navaja vsako skupino funkcij v licenci z njenimi sedeži in obdobjem veljavnosti. Pove tudi, kako je vsak del dobavljen, na primer preveden in licenciran za skupino Enterprise ali odprtokoden za osnovno raven Community. Skupine zunaj licence ostanejo navedene in osivele. Skrbniki lahko zožijo doseg skupine znotraj organizacije; nihče razen družbe Adverant pa ne more razširiti tistega, kar podeljuje licenca.
Stanje licence se ob vsakem branju znova izračuna iz dokumenta in datuma, zato do poteka pride brez načrtovanega opravila. Vsi v namestitvi vidijo enako obvestilo v konzoli, ko se bliža konec: LICENCE_ENDS_SOON od 30 dni pred koncem, nato LICENCE_IN_GRACE med obdobjem odloga. Člani vidijo obvestilo in datume; le skrbniki namestitve vidijo samo licenco. Poglavje 2.13, Licence, obravnava podaljšanje in lestvico poteka.
Če to ne uspe
| Kaj vidite | Vzrok | Kaj storiti |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Spremenjen je bil le eden od dveh ključev | Spremenite oba |
files/images.lock.json is the community lock; this install is edition enterprise |
Uporabljena je bila karta Community | Uporabite karto Enterprise iz razdelka Prenosi |
image ... is a enterprise image; a community install takes only community images |
Ime slike Enterprise je doseglo upodabljanje Community | Preverite edition in mapo karte |
ImagePullBackOff na sliki Enterprise po nadgradnji |
Vozlišče nima žetona za prenos ali pa njegov žeton ni več veljaven | Preverite registries.yaml na tem vozlišču ali ustvarite nov žeton |
| Koda zavrnitve licence | Glejte zgornjo tabelo zavrnitev | Sledite njeni vrstici; nič ni bilo spremenjeno |
Ko stran z licenco prikazuje Enterprise in skupine, ki ste jih pričakovali, je namestitev licencirana. Naslednja postaja je prvi zagon v poglavju 2.12, Prvi zagon, če namestitve še niste prevzeli. Če ste jo, pomočnik še vedno potrebuje lastne ključe modelov umetne inteligence (UI) organizacije, preden lahko komur koli odgovori. Poglavje 2.14, Ponudniki in modeli UI, prikazuje, kako jih povezati.




