Přihlásit seDomluvit prezentaci

Kapitola 2.7

Instalace edice Enterprise a uplatnění licence

Co se změní při instalaci edice Enterprise, jak požádat o licenci ze svého účtu Adverant, tři způsoby jejího importu včetně všech kódů zamítnutí a jak organizace Harrow Port Authority převedla svůj pilotní provoz edice Community na Enterprise přímo na místě bez ztráty dat.

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

17 min čtení

Instalace edice Enterprise má dvě poloviny a každá přichází jinou cestou. Obrazy Enterprise přicházejí s chartem Enterprise a stahují se pomocí stahovacího tokenu (pull token). Licence přichází jako podepsaný soubor z vašeho účtu Adverant a importujete ji do běžící instalace. Žádná polovina nefunguje bez té druhé: obrazy bez licence běží na základní úrovni Community a licence bez obrazů Enterprise nemá co zapnout.

V Harrow Port Authority jsme to provedli v tomto pořadí, šest týdnů po pilotním provozu edice Community v kapitole 2.6, Instalace edice Community v prostředí Kubernetes. Upgrade na chart Enterprise zabral jedno servisní okno; import licence trval dvě minuty. Tato kapitola pokrývá obě poloviny. Začíná čistou instalací a končí převodem stávající instalace Community na místě.

Dvě souběžné větve vedoucí do jednoho pole vpravo označeného „Instalace Enterprise“. Horní větev: „Účet Adverant: Ke stažení“ vede k „Chart Enterprise a jeho zámek obrazů“, poté k „helm install nebo helm upgrade, edition: enterprise“, k němuž je připojeno vedlejší pole „stahovací token na každém uzlu“. Dolní větev: „Účet Adverant: Nasazení“ vede k „podepsaný licenční soubor“, poté k „import do běžící instalace“. Obě větve se setkávají v poli vpravo. Pod ním je popisek „obrazy bez licence běží na základní úrovni Community“.
Dvě poloviny instalace Enterprise a odkud každá z nich pochází.

Rozdíly oproti edici Community

Dvě hodnoty a chart, který je čte.

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

Vše ostatní v souboru hodnot zůstává přesně tak, jak bylo, především název instalace a správci klíčů (custodians). Tyto dva klíče si musí odpovídat a chart odmítne edition: enterprise s enterprise.enabled: false nebo naopak.

Edice musí také odpovídat zámku obrazů (images lock) daného chartu. Každý balíček chartu nese zámek pro jednu edici a zámek Enterprise obsahuje obrazy Community plus sestavení Enterprise. Pokud nasměrujete soubor hodnot Enterprise na chart Community, vykreslování se zastaví s chybou files/images.lock.json is the community lock; this install is edition enterprise. Instalace Enterprise tedy vyžaduje chart Enterprise.

Chart a balíček Enterprise najdete na stránce Ke stažení (Downloads) ve svém účtu Adverant, který je navázán na vaši licenci. Soubor chartu má stejný název jako ten pro Community, nexus-1.0.0-alpha.1.tgz, proto uchovávejte oba v oddělených složkách. Zkontrolujte jej přesně tak, jak popisuje kapitola 2.4, Získání a ověření vydání, oproti klíči vydání, jehož otisk jste zkontrolovali:

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

Poté spusťte smyčku ověření podpisů z kapitoly 2.4, Získání a ověření vydání, nad souborem enterprise/nexus/files/images.lock.json. Pokrývá jak obrazy Enterprise, tak ty sdílené.

Token pro stahování

Obrazy Community jsou veřejné. Obrazy Enterprise vyžadují stahovací token ze stránky Stahovací tokeny a instalační příkazy (Pull tokens and install commands) ve vašem účtu, nakonfigurovaný pro kontejnerový runtime vašich uzlů, jak ukazuje kapitola 2.4, Získání a ověření vydání, krok 3. V prostředí k3s je to položka configs pro registry.adverant.ai v souboru /etc/rancher/k3s/registries.yaml na každém uzlu.

Vytvořte jeden token pro každý cluster a nastavte mu datum vypršení platnosti, kterého si všimnete. Když platnost tokenu vyprší, běžící pody pokračují v činnosti, ale pod přeplánovaný na uzel, který daný obraz ještě nemá, jej nemůže stáhnout. Datum vypršení platnosti tokenu zapisujeme do stejného kalendáře jako u certifikátu.

Čistá instalace edice Enterprise

Pokud instalujete edici Enterprise od začátku, postupujte podle kapitoly 2.6, Instalace edice Community v prostředí Kubernetes, krok za krokem, se třemi rozdíly:

  1. Před krokem 6 vložte stahovací token na každý uzel.

  2. V kroku 4 použijte hodnoty Enterprise (dva klíče uvedené výše).

  3. V kroku 6 proveďte instalaci ze souboru chartu Enterprise, který jste stáhli:

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

Vše po instalačním příkazu je stejné jako v kapitole 2.6, Instalace edice Community v prostředí Kubernetes, a totéž platí pro pravidlo ohledně --wait: nepoužívejte jej. Pokud místo toho instalujete pomocí nexusctl, přidejte do příkazu --edition enterprise:

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

Když jsou všechny úlohy (workloads) připraveny, projděte prvním spuštěním v kapitole 2.12, První spuštění. Licence je jednou ze šesti věcí, které konzole vypíše předtím, než se kdokoli přihlásí. Dokud není importována, instalace běží na základní úrovni Community a každá oblast Enterprise je zobrazena zašedle se zámkem.

Žádost o licenci

Licence od společnosti Adverant se vydává pro identitu jedné instalace – tu, kterou úložiště klíčů vytvořilo pod keys.installationName při instalaci. Účet tedy potřebuje vědět, kterou instalaci máte na mysli, než může licenci vydat.

  1. Přihlaste se ke svému účtu Adverant na adrese https://account.adverant.ai.
  2. V instalaci otevřete Tuto instalaci (This installation) a poté Licence. Zobrazí se jednorázový kód a otisk instalace.
  3. Ve svém účtu otevřete Nárokovat nasazení (Claim a deployment) a zadejte kód. Poté porovnejte otisk, který účet obdržel, s tím, který zobrazuje instalace, skupinu po skupině; každá skupina se musí shodovat.
  4. Stiskněte tlačítko pro nárokování. Instalace se připojí k položce Nasazení (Deployments) ve vašem účtu, se svou verzí a stavem licence.
  5. Adverant vydá licenci pro danou instalaci. Stáhněte soubor ze svého účtu; je pojmenován podle ID své licence, <licence-id>.json.

Kód pro nárokování funguje jednou a po krátkou dobu. Pokud vyprší, účet jej odmítne s chybou CLAIM_CODE_EXPIRED a instalace zobrazí nový.

Nárokovat nasazení
Nárokovat nasazení
Nárokování nasazení v účtu Adverant. Nejprve se zadá jednorázový kód, poté se porovná otisk ve skupinách po čtyřech, takže si nikdo nemůže nárokovat instalaci, před kterou přímo nestojí.

Existují ještě dvě další cesty a kapitola 2.13, Licence, obě podrobně popisuje. Zařízení (appliances) a sady pro okraj sítě (edge kits) nemají obrazovku, na které by zobrazily kód, takže se nárokují pomocí klíče pro nárokování vytištěného na krabici, který se zadá na stránce Zadat klíč pro nárokování (Enter a claim key) nebo se načte ze souboru objednávky výrobce. Instalace bez připojení ven využívá Offline výměnu (Offline exchange): vytvoří podepsaný soubor žádosti o licenci, ten přenesete do svého účtu a soubor licence přinesete zpět. Jednou ročně stejným způsobem vytvoří podepsaný výkaz o využití. Každý soubor ve výměně je podepsán, takže soubor změněný po cestě je odmítnut, s kódem LICENCE_REQUEST_SIGNATURE_INVALID pro žádost a USAGE_FILE_SIGNATURE_INVALID pro soubor o využití.

Offline výměna
Offline výměna
Offline výměna v účtu Adverant. Podepsané soubory putují ručně oběma směry a soubor změněný po cestě je jmenovitě odmítnut.

Co obsahuje licenční soubor

Licence je dokument JSON ve formátu nexus-licence/v1, dvakrát podepsaný společností Adverant dvěma nezávislými klíči. Nemusíte jej číst, ale je užitečné vědět, co v něm je, když se někdo zeptá, co jste zakoupili.

Pole Co uvádí
licence_id Vlastní ID licence, malými písmeny psané UUID (univerzálně jedinečný identifikátor)
type alpha, evaluation nebo commercial
licensee Název organizace a zákaznické ID u společnosti Adverant
scope Instalace, pro kterou je určena, a případné organizace jmenované v udělení (grant)
edition enterprise
grants Skupiny funkcí, které odemyká, každou buď pro celou instalaci, nebo pro jmenované organizace
add_ons a domain_packs Schopnosti licencované samostatně; jedním z nich je balíček Logistika a námořní doprava (Logistics and maritime pack)
metric Jak se licence počítá, named-seat, per-core nebo per-environment, a množství
term starts_on, ends_on a dny upozornění a odkladu (grace)
matrix Verze matice edic, vůči které byla sepsána
signatures Dva podpisy společnosti Adverant

Zkušební licence trvá nejvýše 30 dní, pro nejvýše pět jmenovaných osob, bez odkladu. Komerční licence upozorňuje 30 dní před koncem platnosti a poté ve výchozím nastavení poskytuje 30 dní odkladu. Co se děje na jednotlivých stupních tohoto žebříčku, je uvedeno v kapitole 2.13, Licence.

Podpisy pokrývají dokument tak, jak jej společnost Adverant vytvořila. Odešlete jej přesně tak, jak jste jej obdrželi; neotevírejte jej v editoru, který by jej mohl upravit či naformátovat.

Import licence

Licenci může importovat pouze administrátor instalace: vlastník nebo administrátor celé organizace, která instalaci vlastní, když je do ní přihlášen. Importovat ji může také plný administrátor platformy. Licence nikdy není hodnotou chartu ani souborem připojeným do podu. Putuje do přihlašovací služby nexus-auth, která ji offline zkontroluje vůči kořenům důvěryhodnosti zabudovaným do jejího vlastního obrazu a zaznamená ji v jediné transakci. Importovat ji můžete třemi způsoby a všechny končí na stejném místě.

V konzoli

Během prvního spuštění otevřete Šest věcí předtím, než se kdokoli přihlásí (Six things before anyone signs in), a poté Licence. Stránka Importovat licenci (Import the licence) přijme soubor: přetáhněte jej na stránku nebo jej vyberte. Stránka jej offline zkontroluje přímo v samotné instalaci a poté vypíše skupiny funkcí, které otevírá, spolu s tím, jak je každá chráněna a do kdy. Skupiny, které licence nezahrnuje, zůstávají vypsané a zašedlé.

Později je tentýž import dostupný pod tlačítkem Importovat novou licenci na stránce licence dané instalace. Když platnost licence vypršela, omezená stránka licence nabízí tlačítko Importovat obnovenou licenci.

Importovat licenci
Importovat licenci
Import licence v konzoli. Soubor je zkontrolován v samotné instalaci; stránka vypíše, co odemyká podle skupin funkcí, a se souborem, který neprojde kontrolou podpisu, se zachází jako s chybějícím a zobrazí se příslušný kód.

Pomocí nexusctl

nexusctl licence import <licence-id>.json

Příkaz nexusctl odešle soubor beze změny na importní cestu instalace jako administrátor instalace a ohlásí stav licence nebo kód odmítnutí z tabulky níže.

Prostřednictvím API

Importní cesta je součástí aplikačního programovacího rozhraní (API) přihlašovací služby na vaší adrese hosts.auth. Tělem požadavku je dokument licence, bajt po bajtu:

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 přístupový token přihlášeného administrátora instalace. Použijte --data-binary, nikdy -d, který odstraňuje zalomení řádků a tím mění odesílané bajty. Cesta nepřijímá žádný řetězec dotazu (query string) a v těle nic jiného než samotný dokument; tělo, které se na své nejvyšší úrovni pokusí jmenovat organizaci nebo osobu, je odmítnuto dříve, než se cokoli přečte.

Úspěšný import odpoví 201 Created. Zkrácené tělo vypadá 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čítá organizace v instalaci, které nyní drží licenci. tenants_without_organisation počítá organizace jmenované v licenci, které tato instalace neobsahuje.

Když je import odmítnut

Odmítnutý import nic nemění: nezapíše se žádný řádek a platná licence, pokud nějaká existuje, zůstává tak, jak byla. Auditní protokol instalace zaznamenává každý pokus, včetně těch odmítnutých.

Kód Stav Co to znamená Co dělat
LICENCE_SIGNATURE_INVALID 422 Jeden ze dvou podpisů společnosti Adverant chybí nebo neprošel ověřením; soubor byl po podepsání změněn Požádejte společnost Adverant o soubor znovu; neupravujte jej
LICENCE_FORMAT_INVALID 422 Soubor není licencí, kterou toto vydání dokáže přečíst Odešlete soubor přesně tak, jak jej společnost Adverant poskytla
LICENCE_ROOT_UNKNOWN 422 Je podepsán klíčem, kterému tato instalace nedůvěřuje Požádejte o licenci podepsanou pro kořeny důvěryhodnosti tohoto vydání, nebo proveďte upgrade
LICENCE_MATRIX_MISMATCH 422 Je sepsána vůči matici edic, kterou toto vydání nečte, nebo uděluje skupinu, kterou toto vydání nezná Proveďte upgrade, nebo požádejte o licenci sepsanou pro toto vydání
LICENCE_OTHER_INSTALLATION 409 Byla vydána pro jinou instalaci Požádejte o licenci vydanou pro identitu této instalace
TRANSITION_NOT_PERMITTED 409 Licence s tímto ID již byla importována; každá se importuje pouze jednou Pokud se musí změnit podmínky, požádejte společnost Adverant o novou licenci
LICENCE_REVOKED 403 Společnost Adverant tuto licenci stáhla Požádejte společnost Adverant o novou
LICENCE_LOCKED 403 Doba platnosti licence ještě nezačala; do té doby platí základní úroveň Community Importujte ji znovu v první den její platnosti nebo později
RECORD_NOT_FOUND 404 Instalace ještě nebyla deklarována, takže nemá žádnou identitu, vůči které by bylo možné provést kontrolu Dokončete krok prvního administrátora (kapitola 2.12, První spuštění) a poté proveďte import
VALIDATION_FAILED 400 Tělo bylo nečitelné nebo větší než 1 MiB, případně byl odeslán řetězec dotazu Odešlete soubor jako celé tělo, bez dotazu

Při úspěšném importu se může vrátit ještě jeden kód, spíše jako upozornění než odmítnutí: LICENCE_CLOCK_BEHIND_FLOOR znamená, že hodiny instalace ukazují dřívější čas než nejnovější čas, který již zaznamenaly, takže licence se čte k tomuto pozdějšímu času. Posunutí hodin zpět nikdy neoživí vypršelou licenci. Základní časovou hranici sníží pouze token pro resetování času, který společnost Adverant pro danou instalaci podepíše.

Přechod z edice Community na Enterprise na místě

Takto jsme to udělali v Harrow. Nic se nepřeinstalovává a nic se nemigruje: je to tatáž instalace, se stejnou identitou a stejnými daty, jen je v ní zapnuto více funkcí. Název instalace a správci klíčů zůstávají přesně tak, jak byli; při upgradu háček (hook) správy klíčů zkontroluje, zda je úložiště klíčů již inicializováno, a neudělá nic dalšího.

  1. Vložte stahovací token na každý uzel a restartujte na něm kontejnerový runtime.

  2. Stáhněte chart Enterprise ze stránky Ke stažení (Downloads) a ověřte jej i jeho obrazy podle postupu výše.

  3. Změňte dvě hodnoty ve svém stávajícím souboru hodnot: edition: enterprise a enterprise.enabled: true. Nic jiného neměňte.

  4. Spusťte předběžnou kontrolu (preflight) s novým souborem.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Proveďte upgrade vydání na chart Enterprise, opět bez --wait.

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

    Při upgradu se háčky (hooks) spustí před nasazením nových podů a každá migrace aplikuje pouze ty soubory, které ještě neaplikovala. Vygenerované tajné údaje (secrets) se načtou zpět z instalace a zachovají se. Helm skončí s:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Počkejte na úlohy (workloads), přesně jako v kapitole 2.6, Instalace edice Community v prostředí Kubernetes, krok 7.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Importujte licenci jedním ze tří výše uvedených způsobů.

  8. V konzoli otevřete Tuto instalaci (This installation), poté Licence a následně Přejít na Enterprise (Move to Enterprise). Stránka načte licenci a předtím, než se cokoli stane, ukáže, co se stáhne a co se změní. Také spočítá osoby a obsah organizace a označí je jako zachované. Stiskněte Stáhnout a zapnout. Každá část je před použitím zkontrolována vůči klíči vydání společnosti Adverant a skupiny funkcí se zapínají jedna po druhé.

Naše servisní okno mělo hodinu; samotná práce v něm zabrala asi dvacet minut, z čehož většinu tvořilo čekání na schéma během běhu háčků. Lidé z pilotního provozu se následující ráno přihlásili do stejného pracovního prostoru, přičemž oblasti Enterprise v nabídce již nebyly zašedlé.

Z edice Community na Enterprise
Z edice Community na Enterprise
Převod instalace Community na Enterprise. Stránka potvrdí pravost licence a před stažením čehokoli vypíše, co se bude stahovat; osoby a soubory organizace jsou označeny jako zachované.

Po importu

Stránka licence pod položkou Tato instalace (This installation) vypisuje každou skupinu funkcí v licenci spolu s počtem míst a dobou platnosti. Uvádí také, jak je každá část dodávána, například zkompilovaná a licencovaná pro skupinu Enterprise, nebo jako open source pro základní úroveň Community. Skupiny mimo licenci zůstávají vypsané a zašedlé. Administrátoři mohou zúžit dosah skupiny uvnitř organizace; nikdo kromě společnosti Adverant nemůže rozšířit to, co licence uděluje.

Stav licence se při každém čtení znovu vypočítá z dokumentu a data, takže k vypršení platnosti dochází bez plánované úlohy. Všichni v instalaci vidí v konzoli stejné upozornění, když se blíží konec: LICENCE_ENDS_SOON od 30 dnů před koncem, poté LICENCE_IN_GRACE během doby odkladu. Členové vidí upozornění a data; samotnou licenci vidí pouze administrátoři instalace. Kapitola 2.13, Licence, pokrývá obnovení a žebříček vypršení platnosti.

Licence a co odemyká
Licence a co odemyká
Toto je stránka licence instalace Enterprise. Čísla v horní části udávají počet míst a dobu platnosti; pod nimi je vypsána každá skupina funkcí se způsobem její ochrany a skupiny mimo licenci zůstávají zašedlé.

Pokud to selže

Co vidíte Příčina Co dělat
edition=enterprise but enterprise.enabled=false: they must agree Byl změněn pouze jeden ze dvou klíčů Změňte oba
files/images.lock.json is the community lock; this install is edition enterprise Byl použit chart Community Použijte chart Enterprise ze stránky Ke stažení (Downloads)
image ... is a enterprise image; a community install takes only community images Název obrazu Enterprise se dostal do vykreslování Community Zkontrolujte edition a složku chartu
ImagePullBackOff u obrazu Enterprise po upgradu Uzel nemá žádný stahovací token, nebo jeho token již není platný Zkontrolujte registries.yaml na daném uzlu, nebo vytvořte nový token
Kód odmítnutí licence Viz tabulka odmítnutí výše Postupujte podle příslušného řádku; nic nebylo změněno

Když stránka licence zobrazuje Enterprise a skupiny, které jste očekávali, instalace je licencována. Další zastávkou je první spuštění v kapitole 2.12, První spuštění, pokud jste si instalaci ještě nenárokovali. Pokud ano, asistent stále potřebuje vlastní klíče modelů umělé inteligence (AI) dané organizace, než bude moci komukoli odpovědět. Kapitola 2.14, Poskytovatelé a modely AI, ukazuje, jak je připojit.