PrijavaRezervirajte predstavitev

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

17 min branja

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.

Dva vzporedna pasova, ki vodita v eno polje na desni z oznako »Namestitev Enterprise«. Zgornji pas: »Račun Adverant: Prenosi« vodi do »Grafikon Helm Enterprise in zaklep njegovih slik«, nato do »helm install ali helm upgrade, edition: enterprise«, ki se mu pridruži stransko polje »žeton za prenos na vsakem vozlišču«. Spodnji pas: »Račun Adverant: Postavitve« vodi do »podpisana datoteka licence«, nato do »uvoz v delujočo namestitev«. Oba pasova se srečata v desnem polju. Pod njim je napis »slike brez licence delujejo na osnovni ravni Community«.
Dve polovici namestitve Enterprise in od kod vsaka izvira.

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: true

Vse 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.json
1.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:

  1. Pred 6. korakom namestite žeton za prenos na vsako vozlišče.

  2. V 4. koraku uporabite vrednosti Enterprise (zgornja dva ključa).

  3. 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 enterprise

Ko 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.

  1. Prijavite se v svoj račun Adverant na naslovu https://account.adverant.ai.
  2. V namestitvi odprite Ta namestitev in nato Licenca. Prikažeta se enkratna koda in prstni odtis namestitve.
  3. 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.
  4. Pritisnite gumb za prevzem. Namestitev se pridruži razdelku Postavitve v vašem računu, skupaj s svojo različico in stanjem licence.
  5. 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.

Prevzem postavitve
Prevzem postavitve
Prevzem postavitve v računu Adverant. Najprej se vnese enkratna koda, nato se prstni odtis primerja v skupinah po štiri, tako da nihče ne more prevzeti namestitve, pred katero ne stoji.

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.

Izmenjava brez povezave
Izmenjava brez povezave
Izmenjava brez povezave v računu Adverant. Podpisane datoteke potujejo ročno v obe smeri, datoteka, spremenjena na poti, pa je poimensko zavrnjena.

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.

Uvoz licence
Uvoz licence
Uvažanje licence v konzoli. Datoteka se preveri v sami namestitvi; stran navede, kaj odklene po skupinah funkcij, datoteka, ki ne opravi preverjanja podpisa, pa se obravnava kot odsotna, skupaj s pripadajočo kodo.

Z orodjem nexusctl

nexusctl licence import <licence-id>.json

nexusctl 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.

  1. Namestite žeton za prenos na vsako vozlišče in tam znova zaženite izvajalno okolje vsebnikov.

  2. Pridobite karto Enterprise iz razdelka Prenosi ter preverite karto in njene slike, kot je opisano zgoraj.

  3. Spremenite dve vrednosti v svoji obstoječi datoteki z vrednostmi: edition: enterprise in enterprise.enabled: true. Ne spreminjajte ničesar drugega.

  4. Zaženite predhodno preverjanje z novo datoteko.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Nadgradite 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 45m

    Ob 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: 2
  6. Poč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=900s
  7. Uvozite licenco na katerega koli od zgornjih treh načinov.

  8. 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.

Iz izdaje Community v Enterprise
Iz izdaje Community v Enterprise
Prehod namestitve Community na Enterprise. Stran potrdi, da je licenca pristna, in navede, kaj bo pridobljeno, preden se kar koli pridobi; ljudje in datoteke organizacije so označeni kot ohranjeni.

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.

Licenca in kaj odklene
Licenca in kaj odklene
To je stran z licenco namestitve Enterprise. Številke na vrhu podajajo sedeže in obdobje veljavnosti; pod njimi je navedena vsaka skupina funkcij z načinom zaščite, skupine zunaj licence pa ostanejo osivele.

Č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.