Logi sisseBroneerige tutvustus

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

17 minutit lugemist

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.

Kaks paralleelset rada suunduvad paremal asuvasse kasti sildiga „Enterprise installation”. Ülemine rada: „Adverant account: Downloads” viib kastini „Enterprise chart and its images lock”, seejärel kastini „helm install or helm upgrade, edition: enterprise”, millega on ühendatud kõrvalkast „pull token on every node”. Alumine rada: „Adverant account: Deployments” viib kastini „signed licence file”, seejärel kastini „import into the running installation”. Mõlemad rajad kohtuvad parempoolses kastis. Selle all on pildiallkiri „images without a licence run at the Community floor”.
Enterprise-paigalduse kaks poolt ja kust kumbki pärineb.

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: true

Kõ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.json
1.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:

  1. Lisage tõmbeluba igale sõlmele enne 6. sammu.

  2. Kasutage 4. sammus Enterprise-väärtusi (ülaltoodud kahte võtit).

  3. 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 enterprise

Kui 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.

  1. Logige sisse oma Adverant kontole aadressil https://account.adverant.ai.
  2. Avage paigalduses „This installation” ja seejärel „Licence”. Seal kuvatakse ühekordne kood ja paigalduse sõrmejälg.
  3. 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.
  4. Vajutage sidumisnuppu (claim). Paigaldus lisatakse teie konto jaotisse „Deployments” koos oma versiooni ja litsentsi olekuga.
  5. 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.

Claim a deployment
Paigalduse sidumine
Paigalduse sidumine Adverant kontol. Esmalt sisestatakse ühekordne kood, seejärel võrreldakse sõrmejälge neljaste rühmadena, et keegi ei saaks siduda paigaldust, mille ees ta ise ei viibi.

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.

Offline exchange
Võrguühenduseta andmevahetus
Võrguühenduseta andmevahetus Adverant kontol. Allkirjastatud failid liiguvad mõlemas suunas käsitsi ja teel muudetud fail lükatakse nimeliselt tagasi.

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.

Import the licence
Litsentsi importimine
Litsentsi importimine konsoolis. Faili kontrollitakse paigalduses endas; leht loetleb funktsioonirühmade kaupa, mida see avab, ning allkirjakontrolli mitteläbinud faili koheldakse puuduvana ja kuvatakse vastav veakood.

Tööriistaga nexusctl

nexusctl licence import <licence-id>.json

nexusctl 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.

  1. Lisage tõmbeluba igale sõlmele ja taaskäivitage seal konteinerite käituskeskkond.

  2. Tõmmake allalaadimiste lehelt (Downloads) Enterprise-chart ning kontrollige seda ja selle tõmmiseid, nagu eespool kirjeldatud.

  3. Muutke oma olemasolevas väärtuste failis kahte väärtust: edition: enterprise ja enterprise.enabled: true. Ärge muutke midagi muud.

  4. Käivitage uue failiga eelkontroll (preflight).

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Uuendage 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 45m

    Uuendamisel 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: 2
  6. Oodake 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=900s
  7. Importige litsents mis tahes eespool toodud kolmel viisil.

  8. 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.

Communitylt Enterprise'ile
Communitylt Enterprise'ile
Community paigalduse üleviimine Enterprise'ile. Leht kinnitab, et litsents on ehtne, ja loetleb enne millegi allatõmbamist, mida hakatakse tõmbama; organisatsiooni inimesed ja failid on märgitud säilitatuks.

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.

Litsents ja mida see avab
Litsents ja mida see avab
See on Enterprise-paigalduse litsentsileht. Ülaosas olevad arvud näitavad töökohti ja kehtivusaega; nende all on loetletud iga funktsioonirühm koos sellega, kuidas see on kaitstud, ning litsentsist välja jäävad rühmad on hallid.

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.