Versija 1.0.0-alpha.1naujausia
2.7 skyrius
Enterprise leidimo diegimas ir licencijos pritaikymas
Kas keičiasi įdiegus Enterprise leidimą, kaip užsakyti licenciją iš savo Adverant paskyros, trys jos importavimo būdai su kiekvienu atmetimo kodu ir kaip Harrow Port Authority vietoje perkėlė savo bandomąją Community versiją į Enterprise nieko neprarasdama.
Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

„Enterprise“ diegimas turi dvi dalis, ir jos atkeliauja skirtingais keliais. „Enterprise“ atvaizdai pateikiami su „Enterprise“ diagrama, atsiunčiama naudojant atsiuntimo prieigos raktą. Licencija gaunama kaip pasirašytas failas iš jūsų Adverant paskyros, ir jūs jį importuojate į veikiantį diegimą. Nė viena dalis neveikia be kitos: atvaizdai be licencijos veikia „Community“ baziniame lygyje, o licencija be „Enterprise“ atvaizdų neturi ko įjungti.
Harrow Port Authority tai atlikome būtent tokia tvarka, praėjus šešioms savaitėms po „Community“ bandomojo projekto, aprašyto 2.6 skyriuje „„Community“ diegimas Kubernetes aplinkoje“. Atnaujinimas į „Enterprise“ diagramą užtruko vieną techninės priežiūros langą; licencijos importavimas truko dvi minutes. Šiame skyriuje aptariamos abi dalys. Pradedama nuo naujo diegimo, o baigiama esamo „Community“ diegimo perkėlimu toje pačioje vietoje.
Kuo skiriasi nuo Community
Dvi reikšmės ir jas nuskaitanti diagrama.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueVisa kita reikšmių faile lieka tiksliai taip, kaip buvo, o visų pirma – diegimo pavadinimas ir saugotojai. Abu raktai turi sutapti, todėl diagrama atmeta edition: enterprise su enterprise.enabled: false arba atvirkščiai.
Laida taip pat turi sutapti su diagramos atvaizdų užraktu. Kiekvienas diagramos paketas turi vienos laidos užraktą, o „Enterprise“ užrakte išvardyti „Community“ atvaizdai bei „Enterprise“ dariniai. Nukreipus „Enterprise“ reikšmių failą į „Community“ diagramą, generavimas sustoja su files/images.lock.json is the community lock; this install is edition enterprise. Taigi „Enterprise“ diegimui reikalinga „Enterprise“ diagrama.
„Enterprise“ diagrama ir rinkinys yra jūsų Adverant paskyros puslapyje „Downloads“, kuris priskirtas jūsų licencijai. Diagramos failas turi tokį patį pavadinimą kaip ir „Community“ failas – nexus-1.0.0-alpha.1.tgz, todėl laikykite juos atskiruose aplankuose. Patikrinkite jį tiksliai taip, kaip aprašyta 2.4 skyriuje „Leidimo gavimas ir patikrinimas“, naudodami leidimo raktą, kurio kontrolinį kodą jau patikrinote:
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
Tada paleiskite parašo tikrinimo ciklą iš 2.4 skyriaus „Leidimo gavimas ir patikrinimas“ failui enterprise/nexus/files/images.lock.json. Jis apima tiek „Enterprise“, tiek bendrai naudojamus atvaizdus.
Atsiuntimo prieigos raktas
„Community“ atvaizdai yra vieši. „Enterprise“ atvaizdams reikalingas atsiuntimo prieigos raktas iš jūsų paskyros puslapio „Pull tokens and install commands“, sukonfigūruotas jūsų mazgų konteinerių vykdymo aplinkai, kaip parodyta 2.4 skyriaus „Leidimo gavimas ir patikrinimas“ 3 žingsnyje. k3s aplinkoje tai yra configs įrašas, skirtas registry.adverant.ai faile /etc/rancher/k3s/registries.yaml kiekviename mazge.
Sukurkite po vieną prieigos raktą kiekvienam klasteriui ir nustatykite jam galiojimo pabaigos datą, kurią pastebėtumėte. Kai prieigos rakto galiojimas baigiasi, veikiantys pod'ai toliau dirba, tačiau pod'as, perkeltas į mazgą, kuriame dar nėra atvaizdo, negali jo atsisiųsti. Prieigos rakto galiojimo pabaigos datą įrašėme į tą patį kalendorių kaip ir sertifikato.
Naujas Enterprise diegimas
Jei diegiate „Enterprise“ nuo pat pradžių, žingsnis po žingsnio vadovaukitės 2.6 skyriumi „„Community“ diegimas Kubernetes aplinkoje“ su trimis skirtumais:
Įdėkite atsiuntimo prieigos raktą į kiekvieną mazgą prieš 6 žingsnį.
4 žingsnyje naudokite „Enterprise“ reikšmes (du aukščiau nurodytus raktus).
6 žingsnyje diekite iš atsisiųsto „Enterprise“ diagramos failo:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Viskas po diegimo komandos yra taip pat, kaip ir 2.6 skyriuje „„Community“ diegimas Kubernetes aplinkoje“, įskaitant taisyklę dėl --wait: nenaudokite jo. Jei vietoj to diegiate su nexusctl, prie komandos pridėkite --edition enterprise:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseKai visi darbo krūviai bus paruošti, atlikite pirmojo paleidimo veiksmus, aprašytus 2.12 skyriuje „Pirmasis paleidimas“. Licencija yra vienas iš šešių dalykų, kuriuos pultas išvardija prieš bet kam prisijungiant. Kol ji neimportuota, diegimas veikia „Community“ baziniame lygyje, o visos „Enterprise“ sritys rodomos pilkai su spynos piktograma.
Licencijos užsakymas
Adverant licencija išduodama vieno diegimo tapatybei – tai, kurią raktų saugykla sukūrė po keys.installationName diegimo metu. Todėl prieš išduodant licenciją paskyrai reikia žinoti, kurį diegimą turite omenyje.
- Prisijunkite prie savo Adverant paskyros adresu
https://account.adverant.ai. - Diegime atidarykite „This installation“, tada – „Licence“. Čia rodomas vienkartinis kodas ir diegimo kontrolinis kodas.
- Savo paskyroje atidarykite „Claim a deployment“ ir įveskite kodą. Tada grupė po grupės palyginkite paskyros gautą kontrolinį kodą su tuo, kurį rodo diegimas; kiekviena grupė turi sutapti.
- Paspauskite priskyrimo mygtuką. Diegimas įtraukiamas į jūsų paskyros skiltį „Deployments“ su jo versija ir licencijos būsena.
- Adverant išduoda licenciją tam diegimui. Atsisiųskite failą iš savo paskyros; jis pavadintas pagal licencijos ID:
<licence-id>.json.
Priskyrimo kodas veikia vieną kartą ir trumpą laiką. Jei jo galiojimas baigiasi, paskyra jį atmeta su CLAIM_CODE_EXPIRED, o diegimas parodo naują kodą.
Yra du kiti būdai, ir 2.13 skyriuje „Licencijos“ jie abu išsamiai aprašyti. Įrenginiai ir periferiniai rinkiniai neturi ekrano kodui parodyti, todėl jie priskiriami naudojant ant dėžės išspausdintą priskyrimo raktą, kuris įvedamas skiltyje „Enter a claim key“ arba nuskaitomas iš gamintojo užsakymo failo. Diegimas be išorinio ryšio naudoja „Offline exchange“ (keitimąsi neprisijungus): jis sukuria pasirašytą licencijos užklausos failą, jūs jį perkeliate į savo paskyrą ir parnešate licencijos failą atgal. Kartą per metus tokiu pat būdu sukuriamas pasirašytas naudojimo ataskaitos failas. Kiekvienas šių mainų failas yra pasirašytas, todėl pakeliui pakeistas failas atmetamas su klaida LICENCE_REQUEST_SIGNATURE_INVALID užklausai ir USAGE_FILE_SIGNATURE_INVALID naudojimo failui.
Kas yra licencijos faile
Licencija yra JSON dokumentas nexus-licence/v1 formatu, du kartus pasirašytas Adverant dviem nepriklausomais raktais. Jums nereikia jo skaityti, bet naudinga žinoti, kas jame yra, kai kas nors paklausia, ką įsigijote.
| Laukas | Ką tai reiškia |
|---|---|
licence_id |
Pačios licencijos ID, mažųjų raidžių UUID (universalusis unikalusis identifikatorius) |
type |
alpha, evaluation arba commercial |
licensee |
Organizacijos pavadinimas ir Adverant kliento ID |
scope |
Diegimas, kuriam ji skirta, ir bet kurios teisių suteikime nurodytos organizacijos |
edition |
enterprise |
grants |
Funkcijų grupės, kurias ji atrakina visam diegimui arba nurodytoms organizacijoms |
add_ons ir domain_packs |
Atskirai licencijuojamos galimybės; viena iš jų yra „Logistics and maritime pack“ (logistikos ir jūrų laivybos paketas) |
metric |
Kaip skaičiuojama licencija – named-seat, per-core arba per-environment – ir kiekis |
term |
starts_on, ends_on bei įspėjimo ir lengvatinio laikotarpio dienos |
matrix |
Laidų matricos versija, pagal kurią ji buvo sudaryta |
signatures |
Du Adverant parašai |
Bandomoji licencija galioja ne ilgiau kaip 30 dienų, skirta ne daugiau kaip penkiems vardiniams naudotojams ir neturi lengvatinio laikotarpio. Komercinė licencija pagal numatytuosius nustatymus įspėja likus 30 dienų iki galiojimo pabaigos ir suteikia 30 dienų lengvatinį laikotarpį. Kas nutinka kiekviename šios sekos etape, aprašyta 2.13 skyriuje „Licencijos“.
Parašai apsaugo dokumentą tokį, kokį jį sukūrė Adverant. Siųskite jį tiksliai tokį, kokį gavote; neatidarykite jo redaktoriuje, kuris galėtų pakeisti jo formatavimą.
Licencijos importavimas
Licenciją importuoti gali tik diegimo administratorius: visos organizacijos, kuriai priklauso diegimas, savininkas arba administratorius, prisijungęs prie jo. Pilnateisis platformos administratorius taip pat gali ją importuoti. Licencija niekada nėra diagramos reikšmė ar į pod'ą prijungtas failas. Ji patenka į prisijungimo paslaugą nexus-auth, kuri neprisijungus patikrina ją pagal į jos pačios atvaizdą įdiegtus patikimumo šaltinius ir įrašo viena operacija. Ją galite importuoti trimis būdais, ir jie visi baigiasi toje pačioje vietoje.
Pulte
Pirmojo paleidimo metu atidarykite „Six things before anyone signs in“, tada – „Licence“. Puslapis „Import the licence“ priima failą: nuvilkite jį į puslapį arba pasirinkite. Puslapis neprisijungus patikrina jį pačiame diegime, tada išvardija funkcijų grupes, kurias jis atveria, nurodydamas, kaip kiekviena yra apsaugota ir iki kada. Grupės, kurių licencija neapima, lieka sąraše pilkos.
Vėliau tas pats importavimas atliekamas paspaudus mygtuką Import a new licence diegimo licencijos puslapyje. Kai licencijos galiojimas baigiasi, apribotame licencijos puslapyje siūloma Import a renewed licence.
Naudojant nexusctl
nexusctl licence import <licence-id>.jsonnexusctl nusiunčia nepakeistą failą į diegimo importavimo maršrutą diegimo administratoriaus teisėmis ir praneša licencijos būseną arba atmetimo kodą iš žemiau esančios lentelės.
Per API
Importavimo maršrutas yra prisijungimo paslaugos aplikacijų programavimo sąsajos (API) dalis jūsų hosts.auth adresu. Užklausos turinys yra licencijos dokumentas, baitas po baito:
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> yra prisijungusio diegimo administratoriaus prieigos raktas. Naudokite --data-binary, niekada nenaudokite -d, kuris pašalina eilučių lūžius ir taip pakeičia siunčiamus baitus. Maršrutas nepriima jokios užklausos eilutės ir nieko kito turinyje, išskyrus patį dokumentą; turinys, kuriame aukščiausiame lygyje bandoma nurodyti organizaciją ar asmenį, atmetamas dar prieš pradedant bet ką skaityti.
Sėkmingas importavimas grąžina 201 Created. Sutrumpintas atsakymo turinys atrodo taip:
{
"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 suskaičiuoja diegime esančias organizacijas, kurios dabar turi licenciją. tenants_without_organisation suskaičiuoja licencijoje nurodytas organizacijas, kurių šiame diegime nėra.
Kai importavimas atmetamas
Atmestas importavimas niekoekeičia: jokia eilutė neįrašoma, o galiojanti licencija, jei tokia yra, lieka tokia, kokia buvo. Diegimo audito žurnalas registruoja kiekvieną bandymą, įskaitant ir atmestus.
| Kodas | Būsena | Ką tai reiškia | Ką daryti |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Trūksta vieno iš dviejų Adverant parašų arba jo nepavyksta patikrinti; failas buvo pakeistas po pasirašymo | Paprašykite Adverant failo dar kartą; neredaguokite jo |
LICENCE_FORMAT_INVALID |
422 | Failas nėra licencija, kurią šis leidimas gali nuskaityti | Siųskite failą tiksliai tokį, kokį jį davė Adverant |
LICENCE_ROOT_UNKNOWN |
422 | Jis pasirašytas raktu, kuriuo šis diegimas nepasitiki | Paprašykite licencijos, pasirašytos šio leidimo patikimumo šaltiniams, arba atnaujinkite sistemą |
LICENCE_MATRIX_MISMATCH |
422 | Ji sudaryta pagal laidų matricą, kurios šis leidimas nenuskaito, arba suteikia grupę, kurios šis leidimas nežino | Atnaujinkite sistemą arba paprašykite šiam leidimui sudarytos licencijos |
LICENCE_OTHER_INSTALLATION |
409 | Ji buvo išduota kitam diegimui | Paprašykite licencijos, išduotos šio diegimo tapatybei |
TRANSITION_NOT_PERMITTED |
409 | Licencija su šiuo ID jau buvo importuota; kiekviena importuojama vieną kartą | Paprašykite Adverant naujos licencijos, jei sąlygos turi keistis |
LICENCE_REVOKED |
403 | Adverant atšaukė šią licenciją | Paprašykite Adverant naujos licencijos |
LICENCE_LOCKED |
403 | Licencijos galiojimo laikas dar neprasidėjo; iki tol taikomas „Community“ bazinis lygis | Importuokite ją dar kartą pirmąją jos galiojimo dieną arba vėliau |
RECORD_NOT_FOUND |
404 | Diegimas dar nebuvo deklaruotas, todėl neturi tapatybės, su kuria būtų galima palyginti | Užbaikite pirmojo administratoriaus žingsnį (2.12 skyrius „Pirmasis paleidimas“), tada importuokite |
VALIDATION_FAILED |
400 | Turinys buvo neperskaitomas, viršijo 1 MiB arba buvo išsiųsta užklausos eilutė | Siųskite failą kaip visą užklausos turinį, be užklausos eilutės |
Sėkmingai importavus gali būti grąžintas dar vienas kodas kaip pranešimas, o ne atmetimas: LICENCE_CLOCK_BEHIND_FLOOR reiškia, kad diegimo laikrodis rodo ankstesnį laiką nei vėliausias jo jau matytas laikas, todėl licencija vertinama pagal tą vėlesnį laiką. Laikrodžio atsukimas atgal niekada neatgaivina pasibaigusio galiojimo licencijos. Tik laiko atstatymo prieigos raktas, kurį Adverant pasirašo šiam diegimui, gali sumažinti užfiksuotą laiko ribą.
Community perkėlimas į Enterprise vietoje
Būtent tai mes padarėme Harrow. Niekas neperdiegiama ir niekas nemigruojama: tai tas pats diegimas, su ta pačia tapatybe ir tais pačiais duomenimis, tik jame įjungta daugiau funkcijų. Diegimo pavadinimas ir saugotojai lieka tiksliai tokie, kokie buvo; atnaujinimo metu saugojimo gaudyklė patikrina, ar raktų saugykla jau inicijuota, ir daugiau nieko nedaro.
Įdėkite atsiuntimo prieigos raktą į kiekvieną mazgą ir ten iš naujo paleiskite konteinerių vykdymo aplinką.
Atsisiųskite „Enterprise“ diagramą iš „Downloads“ ir patikrinkite ją bei jos atvaizdus, kaip nurodyta aukščiau.
Pakeiskite dvi reikšmes esamame reikšmių faile:
edition: enterpriseirenterprise.enabled: true. Daugiau nieko nekeiskite.Paleiskite išankstinę patikrą (preflight) su naujuoju failu.
nexusctl preflight --context harrow-prod --values harrow-values.yamlAtnaujinkite leidimą į „Enterprise“ diagramą, vėlgi be
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mAtnaujinimo metu gaudyklės paleidžiamos prieš pradedant veikti naujiems pod'ams, ir kiekviena migracija pritaiko tik tuos failus, kurių dar nebuvo pritaikiusi anksčiau. Sugeneruotos paslaptys nuskaitomos iš diegimo ir išsaugomos. Helm baigia darbą pranešimu:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Palaukite, kol bus paruošti darbo krūviai, tiksliai taip, kaip nurodyta 2.6 skyriaus „„Community“ diegimas Kubernetes aplinkoje“ 7 žingsnyje.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImportuokite licenciją bet kuriuo iš trijų aukščiau nurodytų būdų.
Pulte atidarykite „This installation“, tada – „Licence“, tada – „Move to Enterprise“. Puslapis nuskaito licenciją ir prieš bet kam įvykstant parodo, kas bus atsiųsta ir kas pasikeis. Jis taip pat suskaičiuoja organizacijos žmones bei turinį ir pažymi, kad kiekvienas iš jų bus išsaugotas. Paspauskite Fetch and switch on. Kiekviena dalis prieš naudojimą patikrinama pagal Adverant leidimo raktą, ir funkcijų grupės įjungiamos po vieną.
Mūsų techninės priežiūros langas buvo viena valanda; darbas jame užtruko apie dvidešimt minučių, iš kurių didžiąją dalį sudarė schemos laukimas, kol veikė gaudyklės. Bandomojo projekto dalyviai kitą rytą prisijungė prie tos pačios darbo erdvės, kurioje meniu „Enterprise“ sritys nebebuvo pilkos.
Po importavimo
Licencijos puslapyje, esančiame skiltyje „This installation“, išvardijama kiekviena licencijoje esanti funkcijų grupė su jos darbo vietų skaičiumi ir galiojimo terminu. Jame taip pat nurodoma, kaip kiekviena dalis pateikiama, pavyzdžiui, sukompiliuota ir licencijuota „Enterprise“ grupei arba atvirojo kodo „Community“ baziniam lygiui. Į licenciją neįtrauktos grupės lieka sąraše pilkos. Administratoriai gali susiaurinti grupės pasiekiamumą organizacijos viduje; niekas, išskyrus Adverant, negali išplėsti to, ką suteikia licencija.
Licencijos būsena kiekvieno nuskaitymo metu iš naujo apskaičiuojama pagal dokumentą ir datą, todėl galiojimas baigiasi be jokios suplanuotos užduoties. Artėjant galiojimo pabaigai, visi diegimo naudotojai pulte mato tą patį pranešimą: LICENCE_ENDS_SOON likus 30 dienų iki pabaigos, o vėliau – LICENCE_IN_GRACE lengvatinio laikotarpio metu. Nariai mato pranešimą ir datas; pačią licenciją mato tik diegimo administratoriai. 2.13 skyriuje „Licencijos“ aptariamas atnaujinimas ir galiojimo pabaigos etapai.
Jei tai nepavyksta
| Ką matote | Priežastis | Ką daryti |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Buvo pakeistas tik vienas iš dviejų raktų | Pakeiskite abu |
files/images.lock.json is the community lock; this install is edition enterprise |
Buvo panaudota „Community“ diagrama | Naudokite „Enterprise“ diagramą iš „Downloads“ |
image ... is a enterprise image; a community install takes only community images |
„Enterprise“ atvaizdo pavadinimas pateko į „Community“ generavimą | Patikrinkite edition ir diagramos aplanką |
ImagePullBackOff „Enterprise“ atvaizde po atnaujinimo |
Mazgas neturi atsiuntimo prieigos rakto arba jo prieigos raktas nebegalioja | Patikrinkite registries.yaml tame mazge arba sukurkite naują prieigos raktą |
| Licencijos atmetimo kodas | Žr. aukščiau esančią atmetimų lentelę | Vadovaukitės atitinkama eilute; niekas nebuvo pakeista |
Kai licencijos puslapyje rodoma „Enterprise“ ir jūsų tikėtos grupės, diegimas yra licencijuotas. Kita stotelė – pirmasis paleidimas, aprašytas 2.12 skyriuje „Pirmasis paleidimas“, jei dar nepriskyrėte diegimo. Jei tai jau padarėte, asistentui vis tiek reikia pačios organizacijos dirbtinio intelekto (DI) modelių raktų, kad jis galėtų kam nors atsakyti. 2.14 skyriuje „DI teikėjai ir modeliai“ parodyta, kaip juos prijungti.




