BejelentkezésBemutató kérése

2.7. fejezet

Az Enterprise telepítése és a licenc alkalmazása

Mi változik az Enterprise kiadás telepítésekor, hogyan igényelhet licencet az Adverant-fiókjából, a három importálási mód az összes elutasítási kóddal, és hogyan alakította át a Harrow Port Authority a Community próbaverzióját helyben Enterprise kiadássá adatvesztés nélkül.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

17 perc olvasási idő

Egy Enterprise telepítésnek két fele van, és ezek különböző utakon érkeznek. Az Enterprise képfájlok az Enterprise charttal érkeznek, amelyeket egy letöltési tokennel (pull token) kell lehúzni. A licenc egy aláírt fájlként érkezik az Ön Adverant-fiókjából, amelyet a futó telepítésbe kell importálnia. Egyik fél sem működik a másik nélkül: a licenc nélküli képfájlok a Community alapszinten futnak, az Enterprise képfájlok nélküli licencnek pedig nincs mit bekapcsolnia.

A Harrow Port Authoritynál ebben a sorrendben csináltuk, hat héttel a 2.6. fejezetben (A Community telepítése Kubernetesre) leírt Community próbaüzem után. Az Enterprise chartra történő frissítés egyetlen karbantartási ablakot vett igénybe; a licenc importálása két percig tartott. Ez a fejezet mindkét felet lefedi. Egy tiszta telepítéssel kezdődik, és egy meglévő Community telepítés helyben történő átállításával zárul.

Két párhuzamos sáv, amelyek egy jobb oldali, „Enterprise telepítés” feliratú dobozba futnak be. Felső sáv: az „Adverant-fiók: Letöltések” az „Enterprise chart és annak képfájl-zárolása” elemhez vezet, majd a „helm install vagy helm upgrade, edition: enterprise” lépéshez, amelyhez egy „letöltési token minden csomóponton” feliratú oldalsó doboz csatlakozik. Alsó sáv: az „Adverant-fiók: Telepítések” az „aláírt licencfájl” elemhez vezet, majd az „importálás a futó telepítésbe” lépéshez. Mindkét sáv a jobb oldali dobozban találkozik. Alatta egy képaláírás olvasható: „a licenc nélküli képfájlok a Community alapszinten futnak”.
Az Enterprise telepítés két fele, és hogy melyik honnan származik.

Miben tér el a Community kiadástól

Két érték, és a chart, amely beolvassa őket.

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

Az értékfájlban minden más pontosan úgy marad, ahogy volt, mindenekelőtt a telepítés neve és a kulcsőrzők. A két kulcsnak egyeznie kell, és a chart elutasítja a edition: enterprise értéket a enterprise.enabled: false értékkel, vagy fordítva.

A kiadásnak meg kell egyeznie a chart képfájl-zárolásával (images lock) is. Minden chart-csomag egy adott kiadás zárolását hordozza, és az Enterprise zárolás felsorolja a Community képfájlokat, valamint az Enterprise buildeket. Ha egy Enterprise értékfájlt a Community chartra irányít, a renderelés a files/images.lock.json is the community lock; this install is edition enterprise hibával leáll. Az Enterprise telepítéshez tehát az Enterprise chartra van szükség.

Az Enterprise chart és a csomag az Adverant-fiókja Letöltések (Downloads) oldalán található, amely követi az Ön licencét. A chart fájl neve megegyezik a Community változatéval, nexus-1.0.0-alpha.1.tgz, ezért tartsa a kettőt külön mappában. Ellenőrizze pontosan úgy, ahogyan a 2.4. fejezet (Kiadás beszerzése és ellenőrzése) leírja, azon kiadási kulcs alapján, amelynek az ujjlenyomatát már ellenőrizte:

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

Ezután futtassa a 2.4. fejezetben (Kiadás beszerzése és ellenőrzése) található aláírás-ellenőrző ciklust a enterprise/nexus/files/images.lock.json fájlon. Ez lefedi az Enterprise képfájlokat és a megosztottakat is.

A letöltési token (pull token)

A Community képfájlok nyilvánosak. Az Enterprise képfájlokhoz szükség van egy letöltési tokenre a fiókja Letöltési tokenek és telepítési parancsok (Pull tokens and install commands) oldaláról, amelyet a csomópontok konténer-futtatókörnyezetéhez kell konfigurálni, ahogyan azt a 2.4. fejezet (Kiadás beszerzése és ellenőrzése) 3. lépése mutatja. A k3s esetében ez egy configs bejegyzés a registry.adverant.ai számára a /etc/rancher/k3s/registries.yaml fájlban, minden csomóponton.

Készítsen fürtönként egy tokent, és adjon meg neki egy olyan lejárati dátumot, amelyet biztosan észrevesz. Amikor egy token lejár, a futó podok tovább működnek, de egy olyan csomópontra átütemezett pod, amelyen még nincs meg a képfájl, nem tudja azt lehúzni. Mi a token lejárati dátumát ugyanabba a naptárba írjuk be, mint a tanúsítványét.

Új Enterprise telepítés

Ha kezdettől fogva az Enterprise kiadást telepíti, kövesse a 2.6. fejezetet (A Community telepítése Kubernetesre) lépésről lépésre, három eltéréssel:

  1. Helyezze el a letöltési tokent minden csomóponton a 6. lépés előtt.

  2. Használja az Enterprise értékeket (a fenti két kulcsot) a 4. lépésben.

  3. A 6. lépésben telepítsen a letöltött Enterprise chart fájlból:

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

A telepítési parancs után minden megegyezik a 2.6. fejezetben (A Community telepítése Kubernetesre) leírtakkal, beleértve a --wait kapcsolóra vonatkozó szabályt is: ne használja. Ha ehelyett a nexusctl paranccsal telepít, adja hozzá a --edition enterprise kapcsolót a parancshoz:

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

Amikor minden munkafolyamat (workload) készen áll, menjen végig az első futtatáson a 2.12. fejezet (Az első futtatás) szerint. A licenc egyike annak a hat dolognak, amelyet a konzol felsorol, mielőtt bárki bejelentkezne. Amíg nincs importálva, a telepítés a Community alapszinten fut, és minden Enterprise terület szürkén, lakattal jelenik meg.

A licenc igénylése

Az Adveranttól származó licencet egy adott telepítés személyazonosságára állítják ki, arra, amelyet a kulcstároló a telepítéskor a keys.installationName alatt létrehozott. Ezért a fióknak tudnia kell, melyik telepítésre gondol, mielőtt kiállíthatna egyet.

  1. Jelentkezzen be az Adverant-fiókjába a https://account.adverant.ai címen.
  2. A telepítésen nyissa meg az Ez a telepítés (This installation), majd a Licenc (Licence) menüpontot. Itt látható egy egyszer használatos kód és a telepítés ujjlenyomata.
  3. A fiókjában nyissa meg a Telepítés igénylése (Claim a deployment) oldalt, és adja meg a kódot. Ezután hasonlítsa össze a fiók által fogadott ujjlenyomatot azzal, amelyet a telepítés mutat, csoportonként; minden csoportnak egyeznie kell.
  4. Nyomja meg az igénylés gombot. A telepítés bekerül a fiókja Telepítések (Deployments) listájába, a verziójával és a licencállapotával együtt.
  5. Az Adverant kiállítja a licencet az adott telepítéshez. Töltse le a fájlt a fiókjából; a neve a licencazonosítója után <licence-id>.json lesz.

Egy igénylőkód csak egyszer és rövid ideig használható. Ha lejár, a fiók CLAIM_CODE_EXPIRED hibával elutasítja, a telepítés pedig egy újat jelenít meg.

Telepítés igénylése
Telepítés igénylése
Telepítés igénylése az Adverant-fiókban. Először az egyszer használatos kódot kell megadni, majd az ujjlenyomatot kell összehasonlítani négyes csoportokban, így senki sem igényelhet olyan telepítést, amely előtt nem áll ott személyesen.

Két másik út is létezik, és a 2.13. fejezet (Licencek) mindkettőt részletesen bemutatja. A célgépek (appliances) és a peremhálózati készletek (edge kits) nem rendelkeznek képernyővel a kód megjelenítéséhez, ezért a dobozra nyomtatott igénylőkulccsal lehet őket igényelni, amelyet az Igénylőkulcs megadása (Enter a claim key) oldalon kell begépelni, vagy a gyártó rendelési fájljából kell beolvasni. A kifelé vezető úttal nem rendelkező telepítések az Offline cserét (Offline exchange) használják: a rendszer készít egy aláírt licencigénylő fájlt, Ön elviszi azt a fiókjába, majd visszaviszi a licencfájlt. Évente egyszer ugyanígy készít egy aláírt használati kimutatást is. A csere során minden fájl alá van írva, így az útközben módosított fájlokat a rendszer elutasítja: az igénylést LICENCE_REQUEST_SIGNATURE_INVALID, a használati fájlt pedig USAGE_FILE_SIGNATURE_INVALID kóddal.

Offline csere
Offline csere
Az offline csere az Adverant-fiókban. Az aláírt fájlok mindkét irányban kézben utaznak, és az útközben módosított fájlokat a rendszer név szerint elutasítja.

Mit tartalmaz a licencfájl

A licenc egy nexus-licence/v1 formátumú JSON-dokumentum, amelyet az Adverant kétszer írt alá két független kulccsal. Önnek nem kell elolvasnia, de hasznos tudni, mi van benne, ha valaki megkérdezi, mit vásároltak.

Mező Mit tartalmaz
licence_id A licenc saját azonosítója, egy kisbetűs UUID (univerzálisan egyedi azonosító)
type alpha, evaluation vagy commercial
licensee A szervezet neve és Adverant ügyfél-azonosítója
scope A telepítés, amelyhez szól, és bármely szervezet, amelyet a jogosultság megnevez
edition enterprise
grants Az általa feloldott funkciócsoportok, egyenként a teljes telepítésre vagy a megnevezett szervezetekre
add_ons és domain_packs Külön licencelt képességek; a Logisztikai és tengerészeti csomag (Logistics and maritime pack) például ilyen
metric Hogyan számolják a licencet (named-seat, per-core vagy per-environment), valamint a mennyiség
term starts_on, ends_on, valamint a figyelmeztetési és türelmi napok száma
matrix A kiadási mátrix verziója, amely alapján íródott
signatures Az Adverant két aláírása

Egy próbaverziós (evaluation) licenc legfeljebb 30 napig érvényes, legfeljebb öt megnevezett személyre, türelmi idő nélkül. Egy kereskedelmi licenc a lejárat előtt 30 nappal figyelmeztet, majd alapértelmezés szerint 30 nap türelmi időt biztosít. Hogy mi történik ennek a létrának az egyes fokain, azt a 2.13. fejezet (Licencek) tartalmazza.

Az aláírások a dokumentumot abban a formában védik, ahogyan az Adverant elkészítette. Pontosan úgy küldje el, ahogyan megkapta; ne nyissa meg olyan szerkesztőben, amely esetleg átformázhatja.

A licenc importálása

Csak telepítési adminisztrátor importálhat licencet: a telepítést birtokló teljes szervezet tulajdonosa vagy adminisztrátora, miközben be van jelentkezve. Egy teljes jogosultságú platformadminisztrátor szintén importálhat licencet. A licenc soha nem egy chart-érték vagy egy podba csatolt fájl. A bejelentkezési szolgáltatásba (nexus-auth) kerül, amely offline ellenőrzi azt a saját képfájljába épített megbízhatósági gyökerek (trust roots) alapján, és egyetlen tranzakcióban rögzíti. Háromféleképpen importálhatja, és mindegyik ugyanoda vezet.

A konzolon

Az első futtatás során nyissa meg a Hat dolog, mielőtt bárki bejelentkezne (Six things before anyone signs in), majd a Licenc (Licence) menüpontot. A Licenc importálása (Import the licence) oldal fogadja a fájlt: húzza rá az oldalra, vagy válassza ki. Az oldal offline ellenőrzi azt magán a telepítésen, majd felsorolja az általa megnyitott funkciócsoportokat, feltüntetve, hogy melyik hogyan van védve és meddig érvényes. A licencben nem szereplő csoportok továbbra is a listán maradnak, szürkén.

Később ugyanez az importálás az Új licenc importálása (Import a new licence) gombbal érhető el a telepítés licencoldalán. Amikor egy licenc lejárt, a korlátozott licencoldal a Megújított licenc importálása (Import a renewed licence) lehetőséget kínálja fel.

Licenc importálása
Licenc importálása
A licenc importálása a konzolon. A fájlt maga a telepítés ellenőrzi; az oldal funkciócsoportonként felsorolja, hogy mit old fel, és az aláírás-ellenőrzésen megbukott fájlt a rendszer a saját hibakódjával együtt hiányzóként kezeli.

A nexusctl használatával

nexusctl licence import <licence-id>.json

A nexusctl változatlan formában elküldi a fájlt a telepítés importálási útvonalára telepítési adminisztrátorként, és jelenti a licenc állapotát vagy az alábbi táblázatban szereplő elutasítási kódot.

Az API-n keresztül

Az importálási útvonal a bejelentkezési szolgáltatás alkalmazásprogramozási felületének (API) része, az Ön hosts.auth címén. A törzs (body) maga a licencdokumentum, bájtról bájtra:

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

A <admin-token> egy bejelentkezett telepítési adminisztrátor hozzáférési tokenje. Használja a --data-binary kapcsolót, soha ne a -d kapcsolót, mert az eltávolítja a sortöréseket, és így megváltoztatja az elküldött bájtokat. Az útvonal nem fogad el lekérdezési karakterláncot (query string), és a törzsben sem lehet más a dokumentumon kívül; azt a törzset, amely a legfelső szintjén egy szervezetet vagy személyt próbál megnevezni, a rendszer még azelőtt elutasítja, hogy bármit is beolvasna belőle.

A sikeres importálás 201 Created válasszal tér vissza. Lerövidítve a törzs így néz ki:

{
  "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
}

A organizations azokat a telepítésen lévő szervezeteket számolja meg, amelyek mostantól rendelkeznek a licenccel. A tenants_without_organisation azokat a licencben megnevezett szervezeteket számolja meg, amelyek nem találhatók meg ezen a telepítésen.

Amikor az importálást elutasítják

Az elutasított importálás semmit sem változtat meg: nem íródik új sor, és a hatályos licenc – ha van ilyen – változatlan marad. A telepítés auditnaplója minden kísérletet rögzít, beleértve az elutasítottakat is.

Kód Állapot Mit jelent Teendők
LICENCE_SIGNATURE_INVALID 422 Az Adverant két aláírásának egyike hiányzik vagy nem ellenőrizhető; a fájlt az aláírás után módosították Kérje el újra a fájlt az Adveranttól; ne szerkessze
LICENCE_FORMAT_INVALID 422 A fájl nem olyan licenc, amelyet ez a kiadás be tud olvasni Küldje el a fájlt pontosan úgy, ahogyan az Adverant átadta
LICENCE_ROOT_UNKNOWN 422 Olyan kulccsal írták alá, amelyben ez a telepítés nem bízik meg Kérjen egy olyan licencet, amelyet ennek a kiadásnak a megbízhatósági gyökereihez írtak alá, vagy frissítsen
LICENCE_MATRIX_MISMATCH 422 Olyan kiadási mátrix alapján íródott, amelyet ez a kiadás nem tud értelmezni, vagy olyan csoportot engedélyez, amelyet ez a kiadás nem ismer Frissítsen, vagy kérjen egy ehhez a kiadáshoz írt licencet
LICENCE_OTHER_INSTALLATION 409 Egy másik telepítéshez állították ki Kérjen egy olyan licencet, amelyet ennek a telepítésnek a személyazonosságára állítottak ki
TRANSITION_NOT_PERMITTED 409 Ezzel az azonosítóval már importáltak licencet; mindegyik csak egyszer importálható Kérjen új licencet az Adveranttól, ha a feltételeknek változniuk kell
LICENCE_REVOKED 403 Az Adverant visszavonta ezt a licencet Kérjen egy újat az Adveranttól
LICENCE_LOCKED 403 A licenc futamideje még nem kezdődött el; addig a Community alapszint érvényes Importálja újra az első érvényességi napon vagy azután
RECORD_NOT_FOUND 404 A telepítést még nem deklarálták, így nincs személyazonossága, amely alapján ellenőrizni lehetne Fejezze be az első adminisztrátori lépést (2.12. fejezet, Az első futtatás), majd importálja
VALIDATION_FAILED 400 A törzs olvashatatlan volt, meghaladta az 1 MiB méretet, vagy lekérdezési karakterláncot küldtek Küldje el a fájlt a teljes törzsként, lekérdezés nélkül

Még egy kód érkezhet vissza sikeres importáláskor, elutasítás helyett értesítésként: a LICENCE_CLOCK_BEHIND_FLOOR azt jelenti, hogy a telepítés órája korábbi időpontot mutat, mint a legutóbbi időpont, amelyet már látott, ezért a rendszer a licencet azon a későbbi időponton értelmezi. Az óra visszaállítása soha nem éleszt újra egy lejárt licencet. Csak egy olyan idő-visszaállító token csökkenti ezt a küszöböt, amelyet az Adverant ír alá a telepítés számára.

A Community helyben történő átalakítása Enterprise kiadássá

A Harrow-nál így csináltuk. Semmit sem kell újratelepíteni és semmit sem kell migrálni: ez ugyanaz a telepítés, ugyanazzal a személyazonossággal és ugyanazokkal az adatokkal, csak több minden van bekapcsolva rajta. A telepítés neve és a kulcsőrzők pontosan úgy maradnak, ahogy voltak; frissítéskor a kulcsőrzési kampó (custody hook) ellenőrzi, hogy a kulcstároló már inicializálva van-e, és nem csinál semmi mást.

  1. Helyezze el a letöltési tokent minden csomóponton, és indítsa újra ott a konténer-futtatókörnyezetet.

  2. Töltse le az Enterprise chartot a Letöltések (Downloads) oldalról, és ellenőrizze azt, valamint a képfájljait a fentiek szerint.

  3. Módosítsa a két értéket a meglévő értékfájljában: edition: enterprise és enterprise.enabled: true. Semmi mást ne változtasson meg.

  4. Futtassa az előzetes ellenőrzést (preflight) az új fájllal.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Frissítse a kiadást az Enterprise chartra, ismét a --wait nélkül.

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

    Frissítéskor a kampók (hooks) az új podok elindulása előtt futnak le, és minden migráció csak azokat a fájlokat alkalmazza, amelyeket korábban még nem alkalmazott. A generált titkokat a rendszer visszaolvassa a telepítésből és megtartja. A Helm a következővel zárul:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Várja meg a munkafolyamatokat, pontosan úgy, ahogyan a 2.6. fejezet (A Community telepítése Kubernetesre) 7. lépésében szerepel.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Importálja a licencet a fenti három módszer bármelyikével.

  8. A konzolon nyissa meg az Ez a telepítés (This installation), majd a Licenc (Licence), végül a Váltás Enterprise-ra (Move to Enterprise) menüpontot. Az oldal beolvassa a licencet, és megmutatja, mi lesz letöltve és mi fog változni, mielőtt bármi is történne. Emellett megszámolja a szervezet munkatársait és tartalmait, és mindegyiket megtartottként jelöli meg. Nyomja meg a Letöltés és bekapcsolás (Fetch and switch on) gombot. Minden egyes részt ellenőriz a rendszer az Adverant kiadási kulcsa alapján a használat előtt, és a funkciócsoportok egyesével kapcsolnak be.

A karbantartási ablakunk egyórás volt; a munka ezen belül nagyjából húsz percet vett igénybe, aminek a nagy részét a sémára való várakozás tette ki, miközben a kampók futottak. A próbaüzem résztvevői másnap reggel ugyanabba a munkatérbe jelentkeztek be, de a menü Enterprise területei már nem voltak beszürkítve.

Váltás Communityről Enterprise-ra
Váltás Communityről Enterprise-ra
Community telepítés átállítása Enterprise-ra. Az oldal megerősíti, hogy a licenc eredeti, és felsorolja, mi lesz letöltve, mielőtt bármit is letöltene; a szervezet munkatársai és fájljai megtartottként vannak megjelölve.

Az importálás után

Az Ez a telepítés (This installation) alatti licencoldal felsorolja a licencben szereplő összes funkciócsoportot a felhasználói helyekkel (seats) és a futamidővel együtt. Azt is megmutatja, hogy az egyes részek hogyan érhetők el: például lefordítva és licencelve egy Enterprise csoport esetében, vagy nyílt forráskódként a Community alapszinten. A licencen kívüli csoportok továbbra is a listán maradnak, szürkén. Az adminisztrátorok szűkíthetik, hogy egy csoport mire terjedjen ki a szervezeten belül; az Adveranton kívül azonban senki sem bővítheti ki azt, amit a licenc biztosít.

A licenc állapotát a rendszer minden beolvasáskor újra kiszámítja a dokumentumból és a dátumból, így a lejárat ütemezett feladat (scheduled job) nélkül is bekövetkezik. A telepítésen mindenki ugyanazt az értesítést látja a konzolon, ahogy közeledik a lejárat: LICENCE_ENDS_SOON a lejárat előtt 30 nappal, majd LICENCE_IN_GRACE a türelmi időszak alatt. A tagok látják az értesítést és a dátumokat; magát a licencet csak a telepítési adminisztrátorok látják. A 2.13. fejezet (Licencek) ismerteti a megújítást és a lejárati létrát.

A licenc és amit felold
A licenc és amit felold
Ez egy Enterprise telepítés licencoldala. A felül látható számok a felhasználói helyeket és a futamidőt mutatják; alattuk minden funkciócsoport fel van sorolva a védelem módjával együtt, a licencen kívüli csoportok pedig szürkék maradnak.

Ha ez sikertelen

Amit lát Ok Teendők
edition=enterprise but enterprise.enabled=false: they must agree A két kulcs közül csak az egyiket módosították Módosítsa mindkettőt
files/images.lock.json is the community lock; this install is edition enterprise A Community chartot használták Használja az Enterprise chartot a Letöltések (Downloads) oldalról
image ... is a enterprise image; a community install takes only community images Egy Enterprise képfájlnév került egy Community renderelésbe Ellenőrizze a edition értéket és a chart mappáját
ImagePullBackOff egy Enterprise képfájlon a frissítés után Egy csomópontnak nincs letöltési tokenje, vagy a tokenje már nem érvényes Ellenőrizze a registries.yaml fájlt az adott csomóponton, vagy készítsen új tokent
Licencelutasítási kód Lásd a fenti elutasítási táblázatot Kövesse a hozzá tartozó sort; semmi sem változott

Amikor a licencoldal az Enterprise kiadást és a várt csoportokat mutatja, a telepítés licencelése megtörtént. A következő állomás az első futtatás a 2.12. fejezetben (Az első futtatás), ha még nem igényelte a telepítést. Ha már igényelte, az asszisztensnek még szüksége van a szervezet saját mesterséges intelligencia (AI) modellkulcsaira, mielőtt bárkinek válaszolni tudna. A 2.14. fejezet (AI-szolgáltatók és modellek) bemutatja, hogyan kell csatlakoztatni őket.