Versioon 1.0.0-alpha.1uusim
Peatükk 2.7
Enterprise-väljaande paigaldamine ja litsentsi rakendamine
Mis muutub Enterprise-väljaande paigaldamisel, kuidas taotleda litsentsi oma Adverant-kontolt, kolm viisi selle importimiseks koos kõigi keeldumiskoodidega ning kuidas Harrow Port Authority viis oma Community-pilootprojekti kohapeal üle Enterprise-väljaandele ilma midagi kaotamata.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

Enterprise-paigaldusel on kaks poolt ja need saabuvad eri teid pidi. Enterprise-tõmmised tulevad kaasa Enterprise-chart'iga ning need tõmmatakse alla tõmbeloaga (pull token). Litsents saabub allkirjastatud failina teie Adverant kontolt ja te impordite selle töötavasse paigaldusse. Kumbki pool ei tööta ilma teiseta: litsentsita tõmmised töötavad Community baastasemel ning ilma Enterprise-tõmmisteta litsentsil pole midagi sisse lülitada.
Harrow Port Authoritys tegime seda just sellises järjekorras, kuus nädalat pärast Community pilootprojekti peatükis 2.6, „Community paigaldamine Kubernetesele”. Uuendamine Enterprise-chart'ile võttis ühe hooldusakna; litsentsi importimine võttis kaks minutit. See peatükk käsitleb mõlemat poolt. See algab puhta paigaldusega ja lõpeb olemasoleva Community paigalduse kohapealse üleviimisega.
Mis erineb Community-väljaandest
Kaks väärtust ja chart, mis neid loeb.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueKõik muu väärtuste failis jääb täpselt samaks, eelkõige paigalduse nimi ja võtmehoidjad (custodians). Need kaks võtit peavad ühtima ning chart keeldub väärtusest edition: enterprise koos väärtusega enterprise.enabled: false ja vastupidi.
Väljaanne peab ühtima ka chart'i tõmmiste lukustusfailiga (images lock). Iga chart'i pakett sisaldab ühe väljaande lukustusfaili ning Enterprise-lukustusfail loetleb Community tõmmised pluss Enterprise-järgud. Kui suunate Enterprise-väärtuste faili Community chart'ile, peatub renderdamine veaga files/images.lock.json is the community lock; this install is edition enterprise. Seega vajab Enterprise-paigaldus Enterprise-chart'i.
Enterprise-chart ja pakett asuvad teie Adverant konto allalaadimiste lehel (Downloads), mis lähtub teie litsentsist. Chart'i failil on sama nimi mis Community omal, nexus-1.0.0-alpha.1.tgz, seega hoidke neid kahte eraldi kaustades. Kontrollige seda täpselt nii, nagu kirjeldab peatükk 2.4, „Väljalaske hankimine ja kontrollimine”, võrreldes seda väljalaskevõtmega, mille sõrmejälge te kontrollisite:
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
Seejärel käivitage allkirjatsükkel peatükist 2.4, „Väljalaske hankimine ja kontrollimine”, faili enterprise/nexus/files/images.lock.json peal. See hõlmab nii Enterprise-tõmmiseid kui ka jagatud tõmmiseid.
Tõmbamisluba (pull token)
Community tõmmised on avalikud. Enterprise-tõmmised vajavad tõmbeluba teie konto lehelt „Pull tokens and install commands”, mis on seadistatud teie sõlmede konteinerite käituskeskkonna jaoks, nagu näitab peatüki 2.4, „Väljalaske hankimine ja kontrollimine”, 3. samm. k3s-i puhul on see configs kirje aadressile registry.adverant.ai failis /etc/rancher/k3s/registries.yaml igal sõlmel.
Looge üks luba klastri kohta ja määrake sellele lõppkuupäev, mida te tähele panete. Kui luba aegub, töötavad käimasolevad pod'id edasi, kuid pod, mis suunatakse ümber sõlmele, millel seda tõmmist veel pole, ei saa seda alla tõmmata. Meie panime loa lõppkuupäeva samasse kalendrisse kus on sertifikaadi oma.
Enterprise-väljaande puhas paigaldus
Kui paigaldate Enterprise'i algusest peale, järgige samm-sammult peatükki 2.6, „Community paigaldamine Kubernetesele”, kolme erinevusega:
Lisage tõmbeluba igale sõlmele enne 6. sammu.
Kasutage 4. sammus Enterprise-väärtusi (ülaltoodud kahte võtit).
6. sammus paigaldage süsteem allalaaditud Enterprise-chart'i failist:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Kõik pärast paigalduskäsku on sama nagu peatükis 2.6, „Community paigaldamine Kubernetesele”, ja sama kehtib ka reegli kohta lipu --wait osas: ärge kasutage seda. Kui paigaldate selle asemel käsuga nexusctl, lisage käsule --edition enterprise:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseKui kõik töökoormused on valmis, läbige esmakäivitus peatükis 2.12, „Esmakäivitus”. Litsents on üks kuuest asjast, mille konsool loetleb, enne kui keegi sisse logib. Kuni see pole imporditud, töötab paigaldus Community baastasemel ning iga Enterprise-ala on kuvatud hallina ja lukuikooniga.
Litsentsi taotlemine
Adverant väljastab litsentsi ühe paigalduse identiteedile – sellele, mille võtmehoidla lõi paigaldamisel asukohas keys.installationName. Seega peab konto enne litsentsi väljastamist teadma, millist paigaldust te silmas peate.
- Logige sisse oma Adverant kontole aadressil
https://account.adverant.ai. - Avage paigalduses „This installation” ja seejärel „Licence”. Seal kuvatakse ühekordne kood ja paigalduse sõrmejälg.
- Avage oma kontol „Claim a deployment” ja sisestage kood. Seejärel võrrelge kontole jõudnud sõrmejälge sellega, mida näitab paigaldus, rühm-rühmalt; iga rühm peab klappima.
- Vajutage sidumisnuppu (claim). Paigaldus lisatakse teie konto jaotisse „Deployments” koos oma versiooni ja litsentsi olekuga.
- Adverant väljastab litsentsi sellele paigaldusele. Laadige fail oma kontolt alla; see on nimetatud oma litsentsi ID järgi:
<licence-id>.json.
Sidumiskood töötab ühe korra ja lühikest aega. Kui see aegub, keeldub konto sellest veaga CLAIM_CODE_EXPIRED ja paigaldus kuvab uue koodi.
On veel kaks teed ja peatükk 2.13, „Litsentsid”, käsitleb mõlemat põhjalikult. Seadmetel (appliances) ja servakomplektidel (edge kits) pole koodi kuvamiseks ekraani, seega seotakse need karbile trükitud sidumisvõtmega, mis sisestatakse lehel „Enter a claim key” või loetakse tootja tellimusfailist. Ilma välisühenduseta paigaldus kasutab võrguühenduseta andmevahetust (Offline exchange): see loob allkirjastatud litsentsitaotluse faili, teie viite selle oma kontole ja toote litsentsifaili tagasi. Kord aastas loob see samal viisil allkirjastatud kasutusaruande. Iga vahetatav fail on allkirjastatud, seega lükatakse teel muudetud fail tagasi: taotluse puhul veaga LICENCE_REQUEST_SIGNATURE_INVALID ja kasutusfaili puhul veaga USAGE_FILE_SIGNATURE_INVALID.
Mida litsentsifail sisaldab
Litsents on JSON-dokument vormingus nexus-licence/v1, mille Adverant on allkirjastanud kaks korda kahe sõltumatu võtmega. Te ei pea seda lugema, kuid on kasulik teada, mis seal sees on, kui keegi küsib, mida te olete ostnud.
| Väli | Mida see ütleb |
|---|---|
licence_id |
Litsentsi enda ID, väiketähtedega UUID (universaalselt unikaalne identifikaator) |
type |
alpha, evaluation või commercial |
licensee |
Organisatsiooni nimi ja Adverant kliendi ID |
scope |
Paigaldus, millele see on mõeldud, ja kõik organisatsioonid, mida kasutusõigus nimetab |
edition |
enterprise |
grants |
Funktsioonirühmad, mille see avab, igaüks kas kogu paigaldusele või nimetatud organisatsioonidele |
add_ons ja domain_packs |
Eraldi litsentsitud võimekused; logistika- ja merenduspakett (Logistics and maritime pack) on üks neist |
metric |
Kuidas litsentsi arvestatakse – named-seat, per-core või per-environment – ja kogus |
term |
starts_on, ends_on ning hoiatus- ja ajapikenduspäevad |
matrix |
Väljaandemaatriksi versioon, mille alusel see kirjutati |
signatures |
Adverant'i kaks allkirja |
Proovilitsents kehtib kuni 30 päeva, kuni viiele nimelisele kasutajale ja ilma ajapikenduseta. Ärilitsents hoiatab 30 päeva enne lõppemist ja annab seejärel vaikimisi 30 päeva ajapikendust. Mis juhtub selle redeli igal astmel, on kirjas peatükis 2.13, „Litsentsid”.
Allkirjad katavad dokumenti täpselt sellisena, nagu Adverant selle lõi. Saatke see täpselt nii, nagu te selle saite; ärge avage seda redaktoris, mis võib seda vormindada.
Litsentsi importimine
Litsentsi saab importida ainult paigalduse administraator: paigaldust omava kogu organisatsiooni omanik või administraator, olles sinna sisse logitud. Ka platvormi täisadministraator saab seda importida. Litsents ei ole kunagi chart'i väärtus ega pod'i haagitud fail. See läheb sisselogimisteenusesse nexus-auth, mis kontrollib seda võrguühenduseta omaenda tõmmisesse sisseehitatud usaldusjuurte vastu ja salvestab selle ühe tehinguna. Seda saab importida kolmel viisil ja need kõik jõuavad samasse kohta.
Konsoolis
Avage esmakäivituse ajal „Six things before anyone signs in” ja seejärel „Licence”. Leht „Import the licence” võtab faili vastu: lohistage see lehele või valige see. Leht kontrollib faili võrguühenduseta paigalduses endas, seejärel loetleb funktsioonirühmad, mille see avab, koos sellega, kuidas igaüks neist on kaitstud ja mis ajani. Rühmad, mida litsents ei sisalda, jäävad loendisse hallina.
Hiljem asub sama importimise funktsioon paigalduse litsentsilehel nupu Import a new licence all. Kui litsents on aegunud, pakub piiratud litsentsileht nuppu Import a renewed licence.
Tööriistaga nexusctl
nexusctl licence import <licence-id>.jsonnexusctl saadab faili muutmata kujul paigalduse administraatorina paigalduse impordimarsruudile ning teatab litsentsi oleku või keeldumiskoodi allolevast tabelist.
API kaudu
Impordimarsruut on osa sisselogimisteenuse rakendusliidesest (API) teie hosts.auth aadressil. Päringu kehaks on litsentsidokument, bait-baidilt:
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> on sisselogitud paigalduse administraatori juurdepääsuluba (access token). Kasutage lippu --data-binary, mitte kunagi -d, mis eemaldab reavahetused ja muudab seega saadetavaid baite. Marsruut ei võta vastu päringustringi ega päringu kehas midagi muud peale dokumendi; keha, mis üritab oma ülemisel tasemel nimetada organisatsiooni või isikut, lükatakse tagasi enne, kui midagi loetakse.
Edukas import vastab koodiga 201 Created. Lühendatult näeb päringu keha välja selline:
{
"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 loendab paigalduses olevaid organisatsioone, kellel on nüüd litsents. tenants_without_organisation loendab litsentsis nimetatud organisatsioone, mida selles paigalduses ei ole.
Kui impordist keeldutakse
Tagasilükatud import ei muuda midagi: ühtegi rida ei kirjutata ja kehtiv litsents, kui see on olemas, jääb samaks. Paigalduse auditilogi salvestab iga katse, sealhulgas tagasilükatud katsed.
| Kood | Olek | Mida see tähendab | Mida teha |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Üks Adverant'i kahest allkirjast puudub või ei läbi kontrolli; faili on pärast allkirjastamist muudetud | Küsige Adverant'ilt faili uuesti; ärge muutke seda |
LICENCE_FORMAT_INVALID |
422 | Fail ei ole litsents, mida see väljalase oskaks lugeda | Saatke fail täpselt nii, nagu Adverant selle andis |
LICENCE_ROOT_UNKNOWN |
422 | See on allkirjastatud võtmega, mida see paigaldus ei usalda | Küsige selle väljalaske usaldusjuurte jaoks allkirjastatud litsentsi või uuendage süsteemi |
LICENCE_MATRIX_MISMATCH |
422 | See on kirjutatud väljaandemaatriksi alusel, mida see väljalase ei loe, või annab õiguse rühmale, mida see väljalase ei tunne | Uuendage süsteemi või küsige selle väljalaske alusel kirjutatud litsentsi |
LICENCE_OTHER_INSTALLATION |
409 | See väljastati teisele paigaldusele | Küsige selle paigalduse identiteedile väljastatud litsentsi |
TRANSITION_NOT_PERMITTED |
409 | Selle ID-ga litsents on juba imporditud; iga litsentsi imporditakse üks kord | Küsige Adverant'ilt uut litsentsi, kui tingimused peavad muutuma |
LICENCE_REVOKED |
403 | Adverant on selle litsentsi tühistanud | Küsige Adverant'ilt uut |
LICENCE_LOCKED |
403 | Litsentsi kehtivusaeg pole alanud; seni kehtib Community baastase | Importige see uuesti selle esimesel kehtivuspäeval või pärast seda |
RECORD_NOT_FOUND |
404 | Paigaldust pole veel deklareeritud, seega pole sel identiteeti, mille vastu kontrollida | Lõpetage esimese administraatori samm (peatükk 2.12, „Esmakäivitus”), seejärel importige |
VALIDATION_FAILED |
400 | Päringu keha oli loetamatu või üle 1 MiB või saadeti päringustring | Saatke fail kogu päringu kehana, ilma päringustringita |
Eduka impordi korral võib tagasi tulla veel üks kood, pigem teavituse kui keeldumisena: LICENCE_CLOCK_BEHIND_FLOOR tähendab, et paigalduse kell näitab varasemat aega kui hiliseim aeg, mida see on juba näinud, seega loetakse litsentsi tolle hilisema aja seisuga. Kella tagasikeeramine ei ärata kunagi aegunud litsentsi ellu. Ainult aja lähtestamise luba (time-reset token), mille Adverant paigalduse jaoks allkirjastab, langetab seda ajapiiri.
Community kohapealne üleviimine Enterprise-väljaandele
Nii tegime meie Harrows. Midagi ei paigaldata uuesti ja midagi ei migreerita: see on sama paigaldus, sama identiteedi ja samade andmetega, lihtsalt suurem osa sellest on sisse lülitatud. Paigalduse nimi ja võtmehoidjad jäävad täpselt samaks; uuendamisel kontrollib võtmehalduse haak (custody hook), kas võtmehoidla on juba initsialiseeritud, ega tee midagi muud.
Lisage tõmbeluba igale sõlmele ja taaskäivitage seal konteinerite käituskeskkond.
Tõmmake allalaadimiste lehelt (Downloads) Enterprise-chart ning kontrollige seda ja selle tõmmiseid, nagu eespool kirjeldatud.
Muutke oma olemasolevas väärtuste failis kahte väärtust:
edition: enterprisejaenterprise.enabled: true. Ärge muutke midagi muud.Käivitage uue failiga eelkontroll (preflight).
nexusctl preflight --context harrow-prod --values harrow-values.yamlUuendage väljalase Enterprise-chart'ile, jällegi ilma liputa
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mUuendamisel käivituvad haagid (hooks) enne uute pod'ide käivitamist ja iga migratsioon rakendab ainult neid faile, mida see pole varem rakendanud. Genereeritud saladused loetakse paigaldusest tagasi ja säilitatakse. Helm lõpetab teatega:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Oodake töökoormuste valmimist täpselt nagu peatüki 2.6, „Community paigaldamine Kubernetesele”, 7. sammus.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImportige litsents mis tahes eespool toodud kolmel viisil.
Avage konsoolis „This installation”, seejärel „Licence” ja seejärel „Move to Enterprise”. Leht loeb litsentsi ning näitab enne millegi toimumist, mida hakatakse alla tõmbama ja mis muutub. Samuti loendab see organisatsiooni inimesed ja sisu ning märgib need säilitatuks. Vajutage Fetch and switch on. Iga osa kontrollitakse enne kasutamist Adverant'i väljalaskevõtme vastu ja funktsioonirühmad lülituvad sisse ükshaaval.
Meie hooldusaken oli tund aega; töö selle sees võttis umbes kakskümmend minutit, millest suurema osa moodustas skeemi ootamine haakide töötamise ajal. Pilootprojekti inimesed logisid järgmisel hommikul sisse samasse tööruumi, kus menüü Enterprise-alad ei olnud enam hallid.
Pärast importimist
Litsentsileht jaotises „This installation” loetleb iga litsentsis oleva funktsioonirühma koos selle töökohtade arvu ja kehtivusajaga. Samuti ütleb see, kuidas iga osa tarnitakse, näiteks kompileeritult ja litsentsitult Enterprise-rühma jaoks või avatud lähtekoodiga Community baastaseme jaoks. Litsentsist välja jäävad rühmad jäävad loendisse hallina. Administraatorid saavad kitsendada seda, milleni rühm organisatsiooni sees ulatub; mitte keegi peale Adverant'i ei saa laiendada seda, mida litsents võimaldab.
Litsentsi olek arvutatakse dokumendi ja kuupäeva põhjal uuesti välja igal lugemisel, seega toimub aegumine ilma ajastatud tööta. Kõik paigalduse kasutajad näevad lõpu lähenedes konsoolis sama teadet: LICENCE_ENDS_SOON alates 30 päevast enne lõppu, seejärel LICENCE_IN_GRACE ajapikenduse ajal. Liikmed näevad teadet ja kuupäevi; ainult paigalduse administraatorid näevad litsentsi ennast. Peatükk 2.13, „Litsentsid”, käsitleb pikendamist ja aegumisredelit.
Kui see ebaõnnestub
| Mida te näete | Põhjus | Mida teha |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Muudeti ainult ühte kahest võtmest | Muutke mõlemat |
files/images.lock.json is the community lock; this install is edition enterprise |
Kasutati Community chart'i | Kasutage allalaadimiste lehelt (Downloads) saadud Enterprise-chart'i |
image ... is a enterprise image; a community install takes only community images |
Enterprise-tõmmise nimi jõudis Community renderdusse | Kontrollige väärtust edition ja chart'i kausta |
ImagePullBackOff Enterprise-tõmmisel pärast uuendamist |
Sõlmel puudub tõmbeluba või selle luba ei kehti enam | Kontrollige faili registries.yaml sellel sõlmel või looge uus luba |
| Litsentsist keeldumise kood | Vaadake ülaltoodud keeldumiste tabelit | Järgige vastavat rida; midagi ei muudetud |
Kui litsentsileht näitab väljaannet Enterprise ja oodatud rühmi, on paigaldus litsentsitud. Järgmine peatus on esmakäivitus peatükis 2.12, „Esmakäivitus”, kui te pole paigaldust veel sidunud. Kui olete seda teinud, vajab assistent siiski organisatsiooni enda tehisintellekti (AI) mudelite võtmeid, enne kui ta saab kellelegi vastata. Peatükk 2.14, „AI pakkujad ja mudelid”, näitab, kuidas neid ühendada.




