Prihlásiť saRezervovať brífing

Kapitola 2.7

Inštalácia edície Enterprise a aplikovanie licencie

Čo sa zmení pri inštalácii edície Enterprise, ako požiadať o licenciu z účtu Adverant, tri spôsoby jej importu vrátane všetkých kódov odmietnutia a ako spoločnosť Harrow Port Authority previedla svoju pilotnú prevádzku edície Community priamo na edíciu Enterprise bez akejkoľvek straty dát.

Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

17 min čítania

Inštalácia edície Enterprise má dve polovice a prichádzajú rôznymi cestami. Obrazy Enterprise prichádzajú s balíkom chart pre Enterprise, stiahnuté pomocou sťahovacieho tokenu (pull token). Licencia prichádza ako podpísaný súbor z vášho účtu Adverant a importujete ju do bežiacej inštalácie. Žiadna polovica nefunguje bez tej druhej: obrazy bez licencie bežia na základnej úrovni Community a licencia bez obrazov Enterprise nemá čo zapnúť.

V Harrow Port Authority sme to urobili v tomto poradí, šesť týždňov po pilotnej prevádzke Community v kapitole 2.6, Inštalácia edície Community v prostredí Kubernetes. Inovácia na balík chart pre Enterprise trvala jedno okno údržby; import licencie trval dve minúty. Táto kapitola pokrýva obe polovice. Začína čistou inštaláciou a končí presunom existujúcej inštalácie Community na mieste.

Dve paralelné vetvy vedúce do jedného poľa vpravo s označením „Inštalácia Enterprise“. Horná vetva: „Účet Adverant: Stiahnutia“ vedie k „Balík chart pre Enterprise a jeho zámok obrazov“, potom k „helm install alebo helm upgrade, edition: enterprise“, s pripojeným bočným poľom „sťahovací token na každom uzle“. Dolná vetva: „Účet Adverant: Nasadenia“ vedie k „podpísaný súbor licencie“, potom k „import do bežiacej inštalácie“. Obe vetvy sa stretávajú v pravom poli. Pod ním je riadok popisu „obrazy bez licencie bežia na základnej úrovni Community“.
Dve polovice inštalácie Enterprise a odkiaľ každá z nich pochádza.

Rozdiely oproti edícii Community

Dve hodnoty a balík chart, ktorý ich číta.

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

Všetko ostatné v súbore hodnôt zostáva presne tak, ako bolo, predovšetkým názov inštalácie a správcovia kľúčov (custodians). Tieto dva kľúče sa musia zhodovať a balík chart odmietne edition: enterprise s enterprise.enabled: false, alebo naopak.

Edícia sa musí zhodovať aj so zámkom obrazov balíka chart. Každý balík chart nesie zámok pre jednu edíciu a zámok Enterprise uvádza obrazy Community plus zostavy Enterprise. Ak nasmerujete súbor hodnôt Enterprise na balík chart pre Community, vykreslenie sa zastaví s files/images.lock.json is the community lock; this install is edition enterprise. Inštalácia Enterprise teda potrebuje balík chart pre Enterprise.

Balík chart a balík pre Enterprise sa nachádzajú na stránke Stiahnutia (Downloads) vo vašom účte Adverant, ktorá nadväzuje na vašu licenciu. Súbor balíka chart má rovnaký názov ako ten pre Community, nexus-1.0.0-alpha.1.tgz, preto ich uchovávajte v oddelených priečinkoch. Skontrolujte ho presne tak, ako opisuje kapitola 2.4, Získanie a overenie vydania, oproti kľúču vydania, ktorého odtlačok ste skontrolovali:

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

Potom spustite slučku overenia podpisov z kapitoly 2.4, Získanie a overenie vydania, nad súborom enterprise/nexus/files/images.lock.json. Pokrýva obrazy Enterprise, ako aj tie zdieľané.

Token na sťahovanie (pull token)

Obrazy Community sú verejné. Obrazy Enterprise potrebujú sťahovací token zo stránky Sťahovacie tokeny a inštalačné príkazy (Pull tokens and install commands) vo vašom účte, nakonfigurovaný pre behové prostredie kontajnerov vašich uzlov tak, ako ukazuje kapitola 2.4, Získanie a overenie vydania, krok 3. V systéme k3s je to položka configs pre registry.adverant.ai v súbore /etc/rancher/k3s/registries.yaml na každom uzle.

Vytvorte jeden token pre každý klaster a nastavte mu dátum ukončenia platnosti, ktorý si všimnete. Keď platnosť tokenu vyprší, bežiace pody pokračujú v činnosti, ale pod preplánovaný na uzol, ktorý ešte obraz nemá, ho nedokáže stiahnuť. Dátum ukončenia platnosti tokenu sme vložili do toho istého kalendára ako dátum certifikátu.

Čistá inštalácia edície Enterprise

Ak inštalujete Enterprise od začiatku, postupujte podľa kapitoly 2.6, Inštalácia edície Community v prostredí Kubernetes, krok za krokom, s tromi rozdielmi:

  1. Vložte sťahovací token na každý uzol pred krokom 6.

  2. Použite hodnoty Enterprise (dva kľúče uvedené vyššie) v kroku 4.

  3. V kroku 6 inštalujte zo súboru balíka chart pre Enterprise, ktorý ste stiahli:

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

Všetko po inštalačnom príkaze je rovnaké ako v kapitole 2.6, Inštalácia edície Community v prostredí Kubernetes, a rovnaké je aj pravidlo o --wait: nepoužívajte ho. Ak namiesto toho inštalujete pomocou nexusctl, pridajte do príkazu --edition enterprise:

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

Keď je každá pracovná záťaž pripravená, prejdite prvým spustením v kapitole 2.12, Prvé spustenie. Licencia je jednou zo šiestich vecí, ktoré konzola uvádza predtým, ako sa ktokoľvek prihlási. Kým nie je importovaná, inštalácia beží na základnej úrovni Community a každá oblasť Enterprise je zobrazená sivo so zámkom.

Žiadosť o licenciu

Licencia od spoločnosti Adverant sa vydáva pre identitu jednej inštalácie, tú, ktorú úložisko kľúčov vytvorilo pod keys.installationName pri inštalácii. Účet teda potrebuje vedieť, ktorú inštaláciu máte na mysli, predtým ako ju môže vydať.

  1. Prihláste sa do svojho účtu Adverant na adrese https://account.adverant.ai.
  2. V inštalácii otvorte Táto inštalácia (This installation) a potom Licencia (Licence). Zobrazí sa jednorazový kód a odtlačok inštalácie.
  3. Vo svojom účte otvorte Priradiť nasadenie (Claim a deployment) a zadajte kód. Potom porovnajte odtlačok, ktorý účet prijal, s tým, ktorý zobrazuje inštalácia, skupinu po skupine; každá skupina sa musí zhodovať.
  4. Stlačte tlačidlo priradenia. Inštalácia sa pridá do časti Nasadenia (Deployments) vo vašom účte, so svojou verziou a stavom licencie.
  5. Adverant vydá licenciu pre túto inštaláciu. Stiahnite si súbor zo svojho účtu; je pomenovaný podľa identifikátora licencie, <licence-id>.json.

Kód priradenia funguje raz a len krátky čas. Ak jeho platnosť vyprší, účet ho odmietne s CLAIM_CODE_EXPIRED a inštalácia zobrazí nový.

Priradiť nasadenie
Priradiť nasadenie
Priradenie nasadenia v účte Adverant. Najprv sa zadá jednorazový kód, potom sa odtlačok porovná v skupinách po štyroch, takže nikto si nemôže priradiť inštaláciu, pred ktorou nestojí.

Existujú ešte dve ďalšie cesty a kapitola 2.13, Licencie, pokrýva obe v plnom rozsahu. Zariadenia (appliances) a súpravy pre okrajové siete (edge kits) nemajú obrazovku na zobrazenie kódu, takže sa priraďujú pomocou kľúča priradenia vytlačeného na škatuli, zadaného v časti Zadať kľúč priradenia (Enter a claim key) alebo načítaného zo súboru objednávky od výrobcu. Inštalácia bez spojenia s vonkajšou sieťou používa Offline výmenu (Offline exchange): vytvorí podpísaný súbor žiadosti o licenciu, vy ho prenesiete do svojho účtu a súbor licencie prinesiete späť. Raz ročne rovnakým spôsobom vytvorí podpísaný výkaz o používaní. Každý súbor vo výmene je podpísaný, takže súbor zmenený po ceste je odmietnutý, s LICENCE_REQUEST_SIGNATURE_INVALID pre žiadosť a USAGE_FILE_SIGNATURE_INVALID pre súbor o používaní.

Offline výmena
Offline výmena
Offline výmena v účte Adverant. Podpísané súbory sa prenášajú ručne v oboch smeroch a súbor zmenený po ceste je menovite odmietnutý.

Čo obsahuje súbor licencie

Licencia je dokument JSON vo formáte nexus-licence/v1, dvakrát podpísaný spoločnosťou Adverant dvoma nezávislými kľúčmi. Nemusíte ho čítať, ale pomáha vedieť, čo je v ňom, keď sa niekto opýta, čo ste kúpili.

Pole Čo uvádza
licence_id Vlastný identifikátor licencie, UUID (univerzálne jedinečný identifikátor) malými písmenami
type alpha, evaluation alebo commercial
licensee Názov organizácie a identifikátor zákazníka Adverant
scope Inštalácia, pre ktorú je určená, a prípadné organizácie, ktoré udelenie menuje
edition enterprise
grants Skupiny funkcií, ktoré odomyká, každú pre celú inštaláciu alebo pre menované organizácie
add_ons a domain_packs Schopnosti licencované samostatne; jedným z nich je balík Logistika a námorná doprava (Logistics and maritime pack)
metric Ako sa licencia počíta, named-seat, per-core alebo per-environment, a množstvo
term starts_on, ends_on a dni upozornenia a odkladu
matrix Verzia matice edícií, voči ktorej bola napísaná
signatures Dva podpisy spoločnosti Adverant

Skúšobná licencia trvá najviac 30 dní, pre najviac päť menovaných osôb, bez odkladu. Komerčná licencia upozorňuje 30 dní pred ukončením platnosti a potom štandardne poskytuje 30 dní odkladu. Čo sa deje na každom stupni tohto rebríčka, je uvedené v kapitole 2.13, Licencie.

Podpisy pokrývajú dokument tak, ako ho spoločnosť Adverant vytvorila. Odošlite ho presne tak, ako ste ho dostali; neotvárajte ho v editore, ktorý by ho mohol upraviť.

Import licencie

Licenciu môže importovať iba správca inštalácie: vlastník alebo správca celej organizácie, ktorá inštaláciu vlastní, kým je do nej prihlásený. Importovať ju môže aj plný správca platformy. Licencia nikdy nie je hodnotou balíka chart ani súborom pripojeným do podu. Ide do prihlasovacej služby nexus-auth, ktorá ju skontroluje offline voči koreňom dôveryhodnosti zabudovaným do jej vlastného obrazu a zaznamená ju v jednej transakcii. Môžete ju importovať tromi spôsobmi a všetky končia na tom istom mieste.

V konzole

Počas prvého spustenia otvorte Šesť vecí predtým, ako sa ktokoľvek prihlási (Six things before anyone signs in), a potom Licencia (Licence). Stránka Importovať licenciu (Import the licence) prijme súbor: presuňte ho na stránku alebo ho vyberte. Stránka ho skontroluje offline priamo v inštalácii, potom vypíše skupiny funkcií, ktoré otvára, s informáciou, ako je každá chránená a dokedy. Skupiny, ktoré licencia nezahŕňa, zostanú vypísané sivo.

Neskôr je ten istý import dostupný cez tlačidlo Importovať novú licenciu (Import a new licence) na stránke licencie danej inštalácie. Keď platnosť licencie vyprší, obmedzená stránka licencie ponúka Importovať obnovenú licenciu (Import a renewed licence).

Importovať licenciu
Importovať licenciu
Importovanie licencie v konzole. Súbor sa kontroluje priamo v inštalácii; stránka vypisuje, čo odomyká podľa skupín funkcií, a súbor, ktorý neprejde kontrolou podpisu, sa považuje za neprítomný, s príslušným kódom.

Pomocou nexusctl

nexusctl licence import <licence-id>.json

nexusctl odošle súbor nezmenený na importovaciu trasu inštalácie ako správca inštalácie a oznámi stav licencie alebo kód odmietnutia z tabuľky nižšie.

Cez API

Importovacia trasa je súčasťou aplikačného programovacieho rozhrania (API) prihlasovacej služby na vašej adrese hosts.auth. Telom je dokument licencie, bajt po bajte:

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 prístupový token prihláseného správcu inštalácie. Použite --data-binary, nikdy nie -d, ktorý odstraňuje zalomenia riadkov, a tým mení odosielané bajty. Trasa neprijíma žiadny reťazec dopytu (query string) a v tele nič okrem dokumentu; telo, ktoré sa na najvyššej úrovni pokúša pomenovať organizáciu alebo osobu, je odmietnuté skôr, ako sa čokoľvek prečíta.

Úspešný import odpovie 201 Created. Skrátené telo vyzerá takto:

{
  "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 počíta organizácie v inštalácii, ktoré teraz držia licenciu. tenants_without_organisation počíta organizácie, ktoré licencia menuje, ale táto inštalácia ich nemá.

Keď je import odmietnutý

Odmietnutý import nič nemení: nezapíše sa žiadny riadok a platná licencia, ak nejaká existuje, zostane tak, ako bola. Auditný záznam inštalácie zaznamenáva každý pokus, vrátane tých odmietnutých.

Kód Stav Čo to znamená Čo robiť
LICENCE_SIGNATURE_INVALID 422 Jeden z dvoch podpisov spoločnosti Adverant chýba alebo sa nepodarilo overiť jeho platnosť; súbor bol po podpísaní zmenený Požiadajte spoločnosť Adverant o súbor znova; neupravujte ho
LICENCE_FORMAT_INVALID 422 Súbor nie je licenciou, ktorú toto vydanie dokáže prečítať Odošlite súbor presne tak, ako ho spoločnosť Adverant poskytla
LICENCE_ROOT_UNKNOWN 422 Je podpísaný kľúčom, ktorému táto inštalácia nedôveruje Požiadajte o licenciu podpísanú pre korene dôveryhodnosti tohto vydania, alebo vykonajte inováciu
LICENCE_MATRIX_MISMATCH 422 Je napísaná voči matici edícií, ktorú toto vydanie nečíta, alebo udeľuje skupinu, ktorú toto vydanie nepozná Vykonajte inováciu alebo požiadajte o licenciu napísanú pre toto vydanie
LICENCE_OTHER_INSTALLATION 409 Bola vydaná pre inú inštaláciu Požiadajte o licenciu vydanú pre identitu tejto inštalácie
TRANSITION_NOT_PERMITTED 409 Licencia s týmto identifikátorom už bola importovaná; každá sa importuje raz Ak sa musia zmeniť podmienky, požiadajte spoločnosť Adverant o novú licenciu
LICENCE_REVOKED 403 Spoločnosť Adverant túto licenciu stiahla Požiadajte spoločnosť Adverant o novú
LICENCE_LOCKED 403 Obdobie platnosti licencie sa ešte nezačalo; dovtedy platí základná úroveň Community Importujte ju znova v prvý deň jej platnosti alebo neskôr
RECORD_NOT_FOUND 404 Inštalácia ešte nebola deklarovaná, takže nemá žiadnu identitu na porovnanie Dokončite krok prvého správcu (kapitola 2.12, Prvé spustenie) a potom vykonajte import
VALIDATION_FAILED 400 Telo bolo nečitateľné alebo malo viac ako 1 MiB, prípadne bol odoslaný reťazec dopytu Odošlite súbor ako celé telo, bez dopytu

Pri úspešnom importe sa môže vrátiť ešte jeden kód, skôr ako upozornenie než odmietnutie: LICENCE_CLOCK_BEHIND_FLOOR znamená, že hodiny inštalácie ukazujú skorší čas ako najneskorší čas, ktorý už zaznamenala, takže licencia sa číta k tomuto neskoršiemu času. Posunutie hodín späť nikdy neoživí licenciu po skončení platnosti. Iba token na resetovanie času, ktorý spoločnosť Adverant podpíše pre danú inštaláciu, zníži túto spodnú hranicu.

Priamy prechod z edície Community na Enterprise

Toto sme urobili v Harrow. Nič sa nepreinštalováva a nič sa nemigruje: je to tá istá inštalácia, s tou istou identitou a tými istými údajmi, len je z nej zapnuté viac. Názov inštalácie a správcovia kľúčov zostávajú presne tak, ako boli; pri inovácii prípojný bod správy kľúčov (custody hook) skontroluje, či je úložisko kľúčov už inicializované, a neurobí nič iné.

  1. Vložte sťahovací token na každý uzol a reštartujte tam behové prostredie kontajnerov.

  2. Stiahnite si balík chart pre Enterprise z časti Stiahnutia (Downloads) a overte ho spolu s jeho obrazmi tak, ako je uvedené vyššie.

  3. Zmeňte dve hodnoty vo svojom existujúcom súbore hodnôt: edition: enterprise a enterprise.enabled: true. Nemeňte nič iné.

  4. Spustite predbežnú kontrolu (preflight) s novým súborom.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Inovujte vydanie na balík chart pre Enterprise, opäť bez --wait.

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

    Pri inovácii sa prípojné body (hooks) spustia pred nasadením nových podov a každá migrácia použije iba tie súbory, ktoré ešte predtým nepoužila. Vygenerované tajomstvá sa načítajú späť z inštalácie a zachovajú sa. Helm končí s:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Počkajte na pracovné záťaže, presne ako v kapitole 2.6, Inštalácia edície Community v prostredí Kubernetes, krok 7.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Importujte licenciu ktorýmkoľvek z troch spôsobov uvedených vyššie.

  8. V konzole otvorte Táto inštalácia (This installation), potom Licencia (Licence) a potom Prejsť na Enterprise (Move to Enterprise). Stránka prečíta licenciu a pred vykonaním akýchkoľvek krokov ukáže, čo sa stiahne a čo sa zmení. Taktiež spočíta ľudí a obsah organizácie a označí ich ako zachované. Stlačte Stiahnuť a zapnúť (Fetch and switch on). Každá časť sa pred použitím skontroluje voči kľúču vydania spoločnosti Adverant a skupiny funkcií sa zapínajú jedna po druhej.

Naše okno trvalo hodinu; práca v ňom trvala asi dvadsať minút, z čoho väčšinu tvorilo čakanie na schému počas behu prípojných bodov. Ľudia z pilotnej prevádzky sa nasledujúce ráno prihlásili do toho istého pracovného priestoru, pričom oblasti ponuky pre Enterprise už neboli sivé.

Z Community na Enterprise
Z Community na Enterprise
Presun inštalácie Community na Enterprise. Stránka potvrdzuje, že licencia je pravá, a vypisuje, čo sa stiahne, skôr ako sa čokoľvek stiahne; ľudia a súbory organizácie sú označené ako zachované.

Po importe

Stránka licencie v časti Táto inštalácia vypisuje každú skupinu funkcií v licencii s jej počtom miest a obdobím platnosti. Uvádza tiež, ako je každá časť dodávaná, napríklad skompilovaná a licencovaná pre skupinu Enterprise, alebo s otvoreným zdrojovým kódom pre základnú úroveň Community. Skupiny mimo licencie zostávajú vypísané sivo. Správcovia môžu zúžiť dosah skupiny v rámci organizácie; nikto okrem spoločnosti Adverant nemôže rozšíriť to, čo licencia udeľuje.

Stav licencie sa pri každom čítaní znova vypočíta z dokumentu a dátumu, takže vypršanie platnosti nastane bez naplánovanej úlohy. Každý v inštalácii vidí v konzole rovnaké upozornenie, keď sa blíži koniec: LICENCE_ENDS_SOON od 30 dní pred koncom, potom LICENCE_IN_GRACE počas odkladného obdobia. Členovia vidia upozornenie a dátumy; samotnú licenciu vidia iba správcovia inštalácie. Kapitola 2.13, Licencie, pokrýva obnovenie a rebríček vypršania platnosti.

Licencia a čo odomyká
Licencia a čo odomyká
Toto je stránka licencie inštalácie Enterprise. Údaje v hornej časti udávajú počet miest a obdobie platnosti; pod nimi je vypísaná každá skupina funkcií s informáciou, ako je chránená, a skupiny mimo licencie zostávajú sivé.

Ak tento postup zlyhá

Čo vidíte Príčina Čo robiť
edition=enterprise but enterprise.enabled=false: they must agree Bol zmenený iba jeden z dvoch kľúčov Zmeňte oba
files/images.lock.json is the community lock; this install is edition enterprise Bol použitý balík chart pre Community Použite balík chart pre Enterprise z časti Stiahnutia (Downloads)
image ... is a enterprise image; a community install takes only community images Názov obrazu Enterprise sa dostal do vykresľovania Community Skontrolujte edition a priečinok balíka chart
ImagePullBackOff na obraze Enterprise po inovácii Uzol nemá sťahovací token alebo jeho token už nie je platný Skontrolujte registries.yaml na danom uzle alebo vytvorte nový token
Kód odmietnutia licencie Pozrite si tabuľku odmietnutí vyššie Postupujte podľa príslušného riadka; nič sa nezmenilo

Keď stránka licencie zobrazuje Enterprise a skupiny, ktoré ste očakávali, inštalácia je licencovaná. Ďalšou zastávkou je prvé spustenie v kapitole 2.12, Prvé spustenie, ak ste si inštaláciu ešte nepriradili. Ak ste tak už urobili, asistent stále potrebuje vlastné kľúče modelov umelej inteligencie (AI) organizácie predtým, ako dokáže komukoľvek odpovedať. Kapitola 2.14, Poskytovatelia a modely AI, ukazuje, ako ich pripojiť.