Logg innBestill en gjennomgang

Kapittel 2.7

Installere Enterprise og legge inn en lisens

Hva som endres når du installerer Enterprise-utgaven, hvordan du ber om en lisens fra Adverant-kontoen din, de tre måtene å importere den på med hver avvisningskode, og hvordan Harrow Port Authority oppgraderte sin Community-pilot til Enterprise på stedet uten å miste noe.

Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

17 minutter å lese

En Enterprise-installasjon består av to halvdeler, og de kommer ad ulike veier. Enterprise-avbildningene følger med Enterprise-chartet og hentes med et hentetoken (pull token). Lisensen kommer som en signert fil fra Adverant-kontoen din, og du importerer den inn i den kjørende installasjonen. Ingen av halvdelene fungerer uten den andre: avbildninger uten lisens kjører på Community-grunnivået, og en lisens uten Enterprise-avbildninger har ingenting å slå på.

Hos Harrow Port Authority gjorde vi det i den rekkefølgen, seks uker etter Community-piloten i kapittel 2.6, Installere Community på Kubernetes. Oppgraderingen til Enterprise-chartet tok ett vedlikeholdsvindu; lisensimporten tok to minutter. Dette kapittelet dekker begge halvdelene. Det starter med en ny installasjon og avsluttes med at en eksisterende Community-installasjon oppgraderes på stedet.

To parallelle løp som leder inn i én boks til høyre merket «Enterprise-installasjon». Øvre løp: «Adverant-konto: Nedlastinger» leder til «Enterprise-chart og tilhørende avbildningslås», deretter til «helm install eller helm upgrade, edition: enterprise», med en sideboks «hentetoken på hver node» knyttet til seg. Nedre løp: «Adverant-konto: Utrullinger» leder til «signert lisensfil», deretter til «importer inn i den kjørende installasjonen». Begge løpene møtes ved boksen til høyre. Under den står det en bildetekst: «avbildninger uten lisens kjører på Community-grunnivået».
De to halvdelene av en Enterprise-installasjon og hvor hver av dem kommer fra.

Hva som skiller seg fra Community

To verdier, og chartet som leser dem.

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

Alt annet i verdifilen forblir nøyaktig som det var, fremfor alt installasjonsnavnet og forvalterne. De to nøklene må samsvare, og chartet avviser edition: enterprise med enterprise.enabled: false, eller omvendt.

Utgaven må også samsvare med chartets avbildningslås (images lock). Hver chart-pakke inneholder låsen for én utgave, og Enterprise-låsen lister opp Community-avbildningene pluss Enterprise-byggene. Peker du en Enterprise-verdifil mot Community-chartet, stopper gjengivelsen med files/images.lock.json is the community lock; this install is edition enterprise. Enterprise-installasjonen trenger altså Enterprise-chartet.

Enterprise-chartet og -pakken ligger på siden Nedlastinger (Downloads) i Adverant-kontoen din, som følger lisensen din. Chart-filen har samme navn som Community-filen, nexus-1.0.0-alpha.1.tgz, så hold de to i adskilte mapper. Kontroller den nøyaktig slik kapittel 2.4, Hente og verifisere en utgivelse, beskriver, mot utgivelsesnøkkelen hvis fingeravtrykk du kontrollerte:

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

Kjør deretter signaturløkken fra kapittel 2.4, Hente og verifisere en utgivelse, over enterprise/nexus/files/images.lock.json. Den dekker Enterprise-avbildningene så vel som de delte.

Pull-tokenet

Community-avbildninger er offentlige. Enterprise-avbildninger trenger et hentetoken fra siden Hentetokener og installasjonskommandoer (Pull tokens and install commands) i kontoen din, konfigurert for nodenes kjøremiljø for containere slik kapittel 2.4, Hente og verifisere en utgivelse, trinn 3, viser. På k3s er det en configs-oppføring for registry.adverant.ai i /etc/rancher/k3s/registries.yaml på hver node.

Lag ett token per klynge og gi det en sluttdato du legger merke til. Når et token utløper, fortsetter kjørende podder, men en pod som flyttes til en node som ikke har avbildningen ennå, kan ikke hente den. Vi legger tokenets sluttdato i samme kalender som sertifikatets.

En ny Enterprise-installasjon

Hvis du installerer Enterprise fra bunnen av, følger du kapittel 2.6, Installere Community på Kubernetes, trinn for trinn, med tre forskjeller:

  1. Legg inn hentetokenet på hver node før trinn 6.

  2. Bruk Enterprise-verdiene (de to nøklene ovenfor) i trinn 4.

  3. I trinn 6 installerer du fra Enterprise-chart-filen du lastet ned:

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

Alt etter installasjonskommandoen er det samme som i kapittel 2.6, Installere Community på Kubernetes, og det gjelder også regelen om --wait: ikke bruk den. Hvis du installerer med nexusctl i stedet, legger du til --edition enterprise i kommandoen:

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

Når hver arbeidsbelastning er klar, går du gjennom førstegangskjøringen i kapittel 2.12, Førstegangskjøringen. Lisensen er én av de seks tingene konsollen lister opp før noen logger inn. Inntil den er importert, kjører installasjonen på Community-grunnivået, og hvert Enterprise-område vises nedtonet med en lås.

Be om lisensen

En lisens fra Adverant utstedes for identiteten til én installasjon – den som nøkkellageret opprettet under keys.installationName ved installasjon. Kontoen må derfor vite hvilken installasjon du mener før den kan utstede en.

  1. Logg inn på Adverant-kontoen din på https://account.adverant.ai.
  2. På installasjonen åpner du Denne installasjonen (This installation), og deretter Lisens (Licence). Den viser en engangskode og installasjonens fingeravtrykk.
  3. I kontoen din åpner du Gjør krav på en utrulling (Claim a deployment) og skriver inn koden. Sammenlign deretter fingeravtrykket kontoen mottok med det installasjonen viser, gruppe for gruppe; hver gruppe må samsvare.
  4. Trykk på knappen for å gjøre krav. Installasjonen legges til under Utrullinger (Deployments) i kontoen din, med versjon og lisensstatus.
  5. Adverant utsteder lisensen for den installasjonen. Last ned filen fra kontoen din; den er oppkalt etter lisens-ID-en sin, <licence-id>.json.

En kravkode fungerer én gang og i kort tid. Hvis den utløper, avviser kontoen den med CLAIM_CODE_EXPIRED, og installasjonen viser en ny.

Gjør krav på en utrulling
Gjør krav på en utrulling
Å gjøre krav på en utrulling i Adverant-kontoen. Engangskoden legges inn først, deretter sammenlignes fingeravtrykket i grupper på fire, slik at ingen kan gjøre krav på en installasjon de ikke står foran.

Det finnes to andre veier, og kapittel 2.13, Lisenser, dekker begge i sin helhet. Appliancer og kantsett (edge kits) har ingen skjerm som kan vise en kode, så de kreves med en kravnøkkel som er trykt på esken, skrevet inn under Skriv inn en kravnøkkel (Enter a claim key) eller lest fra produsentens ordrefil. En installasjon uten forbindelse ut bruker Frakoblet utveksling (Offline exchange): den lager en signert lisensforespørselsfil, du tar den med til kontoen din, og du tar lisensfilen med tilbake. Én gang i året lager den en signert bruksoppgave på samme måte. Hver fil i utvekslingen er signert, så en fil som er endret underveis, blir avvist, med LICENCE_REQUEST_SIGNATURE_INVALID for en forespørsel og USAGE_FILE_SIGNATURE_INVALID for en bruksfil.

Frakoblet utveksling
Frakoblet utveksling
Den frakoblede utvekslingen i Adverant-kontoen. Signerte filer fraktes manuelt i begge retninger, og en fil som er endret underveis, blir avvist ved navn.

Hva lisensfilen inneholder

Lisensen er et JSON-dokument i formatet nexus-licence/v1, signert to ganger av Adverant med to uavhengige nøkler. Du trenger ikke å lese det, men det er nyttig å vite hva som står i det når noen spør hva dere har kjøpt.

Felt Hva det sier
licence_id Lisensens egen ID, en UUID (universelt unik identifikator) med små bokstaver
type alpha, evaluation eller commercial
licensee Organisasjonens navn og Adverant-kunde-ID
scope Installasjonen den gjelder for, og eventuelle organisasjoner en tildeling navngir
edition enterprise
grants Funksjonsgruppene den låser opp, hver for hele installasjonen eller for navngitte organisasjoner
add_ons og domain_packs Kapasiteter som lisensieres separat; Logistikk- og maritim-pakken (Logistics and maritime pack) er én slik
metric Hvordan lisensen telles, named-seat, per-core eller per-environment, og antallet
term starts_on, ends_on, samt antall dager med varsling og henstand
matrix Versjonen av utgavematrisen den ble skrevet mot
signatures Adverants to signaturer

En evalueringslisens varer i høyst 30 dager, for høyst fem navngitte personer, uten henstand. En kommersiell lisens varsler 30 dager før den utløper og gir deretter 30 dagers henstand som standard. Hva som skjer på hvert trinn på den stigen, står i kapittel 2.13, Lisenser.

Signaturene dekker dokumentet slik Adverant laget det. Send det nøyaktig slik du mottok det; ikke åpne det i et redigeringsprogram som kan rydde i det.

Importere lisensen

Kun en installasjonsadministrator kan importere en lisens: en eier eller administrator for hele organisasjonen som eier installasjonen, mens vedkommende er logget inn på den. En full plattformadministrator kan også importere en. Lisensen er aldri en chart-verdi eller en fil som er montert inn i en pod. Den går inn i innloggingstjenesten, nexus-auth, som kontrollerer den frakoblet mot tillitsrøttene som er innebygd i dens egen avbildning, og registrerer den i én transaksjon. Du kan importere den på tre måter, og alle ender på samme sted.

I konsollen

Under førstegangskjøringen åpner du Seks ting før noen logger inn (Six things before anyone signs in), og deretter Lisens (Licence). Siden Importer lisensen (Import the licence) tar imot filen: slipp den på siden, eller velg den. Siden kontrollerer den frakoblet på selve installasjonen, og lister deretter opp funksjonsgruppene den åpner, med hvordan hver av dem er beskyttet og frem til når. Grupper som lisensen ikke omfatter, blir stående på listen, nedtonet.

Senere gjøres den samme importen med knappen Importer en ny lisens (Import a new licence) på installasjonens lisensside. Når en lisens har utløpt, tilbyr den begrensede lisenssiden Importer en fornyet lisens (Import a renewed licence).

Importer lisensen
Importer lisensen
Import av lisensen i konsollen. Filen kontrolleres på selve installasjonen; siden lister opp hva den låser opp etter funksjonsgruppe, og en fil som ikke består signaturkontrollen, behandles som fraværende, med tilhørende kode.

Med nexusctl

nexusctl licence import <licence-id>.json

nexusctl sender filen, uendret, til installasjonens importrute som en installasjonsadministrator, og rapporterer lisensens status eller avvisningskoden fra tabellen nedenfor.

Gjennom API-et

Importruten er en del av innloggingstjenestens programmeringsgrensesnitt (API), på hosts.auth-adressen din. Meldingsteksten (body) er lisensdokumentet, byte for byte:

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> er tilgangstokenet til en innlogget installasjonsadministrator. Bruk --data-binary, aldri -d, som fjerner linjeskift og dermed endrer bytene du sender. Ruten tar ingen spørrestreng og ingenting annet i meldingsteksten enn dokumentet; en meldingstekst som forsøker å navngi en organisasjon eller en person på øverste nivå, blir avvist før noe som helst leses.

En vellykket import svarer 201 Created. Forkortet ser meldingsteksten slik ut:

{
  "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 teller organisasjonene på installasjonen som nå har lisensen. tenants_without_organisation teller organisasjoner som lisensen navngir, men som denne installasjonen ikke har.

Når importen blir avvist

En avvist import endrer ingenting: ingen rad skrives, og den gjeldende lisensen, hvis det finnes en, forblir som den var. Installasjonens revisjonslogg registrerer hvert forsøk, inkludert de avviste.

Kode Status Hva det betyr Hva du skal gjøre
LICENCE_SIGNATURE_INVALID 422 Én av Adverants to signaturer mangler eller kan ikke verifiseres; filen ble endret etter signering Be Adverant om filen på nytt; ikke rediger den
LICENCE_FORMAT_INVALID 422 Filen er ikke en lisens denne utgivelsen kan lese Send filen nøyaktig slik Adverant ga den
LICENCE_ROOT_UNKNOWN 422 Den er signert med en nøkkel denne installasjonen ikke stoler på Be om en lisens signert for denne utgivelsens tillitsrøtter, eller oppgrader
LICENCE_MATRIX_MISMATCH 422 Den er skrevet mot en utgavematrise denne utgivelsen ikke leser, eller tildeler en gruppe denne utgivelsen ikke kjenner Oppgrader, eller be om en lisens skrevet mot denne utgivelsen
LICENCE_OTHER_INSTALLATION 409 Den ble utstedt for en annen installasjon Be om en lisens utstedt for denne installasjonens identitet
TRANSITION_NOT_PERMITTED 409 En lisens med denne ID-en er allerede importert; hver lisens importeres én gang Be Adverant om en ny lisens hvis vilkårene må endres
LICENCE_REVOKED 403 Adverant har trukket tilbake denne lisensen Be Adverant om en ny
LICENCE_LOCKED 403 Lisensperioden har ikke startet; Community-grunnivået gjelder frem til da Importer den på nytt på eller etter dens første dag
RECORD_NOT_FOUND 404 Installasjonen er ikke deklarert ennå, så den har ingen identitet å kontrollere mot Fullfør den første administratorens trinn (kapittel 2.12, Førstegangskjøringen), og importer deretter
VALIDATION_FAILED 400 Meldingsteksten var uleselig eller over 1 MiB, eller en spørrestreng ble sendt Send filen som hele meldingsteksten, uten spørring

Én kode til kan returneres ved en vellykket import, som en merknad snarere enn en avvisning: LICENCE_CLOCK_BEHIND_FLOOR betyr at installasjonens klokke viser et tidligere tidspunkt enn det siste tidspunktet den allerede har sett, så lisensen leses ved dette senere tidspunktet. Å stille klokken tilbake gjenoppliver aldri en utløpt lisens. Kun et token for tilbakestilling av tid som Adverant signerer for installasjonen, senker gulvet.

Oppgradere Community til Enterprise på stedet

Dette er hva vi gjorde hos Harrow. Ingenting installeres på nytt og ingenting migreres: det er den samme installasjonen, med den samme identiteten og de samme dataene, og mer av den er slått på. Installasjonsnavnet og forvalterne forblir nøyaktig som de var; ved en oppgradering kontrollerer forvaltnings-hooken at nøkkellageret allerede er initialisert, og gjør ingenting annet.

  1. Legg inn hentetokenet på hver node, og start kjøremiljøet for containere på nytt der.

  2. Hent Enterprise-chartet fra Nedlastinger (Downloads) og verifiser det og tilhørende avbildninger som ovenfor.

  3. Endre de to verdiene i den eksisterende verdifilen din: edition: enterprise og enterprise.enabled: true. Ikke endre noe annet.

  4. Kjør forhåndskontroll (preflight) med den nye filen.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Oppgrader utgivelsen til Enterprise-chartet, igjen uten --wait.

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

    Ved en oppgradering kjører hookene før de nye poddene rulles ut, og hver migrering bruker kun filene den ikke har brukt før. De genererte hemmelighetene leses tilbake fra installasjonen og beholdes. Helm avslutter med:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Vent på arbeidsbelastningene, nøyaktig som i kapittel 2.6, Installere Community på Kubernetes, trinn 7.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Importer lisensen på en av de tre måtene ovenfor.

  8. I konsollen åpner du Denne installasjonen (This installation), deretter Lisens (Licence), og deretter Gå over til Enterprise (Move to Enterprise). Siden leser lisensen og viser hva som vil bli hentet og hva som vil endre seg før noe skjer. Den teller også organisasjonens personer og innhold og markerer hver av dem som beholdt. Trykk på Hent og slå på (Fetch and switch on). Hver del kontrolleres mot Adverants utgivelsesnøkkel før den tas i bruk, og funksjonsgruppene slås på én om gangen.

Vinduet vårt var på en time; arbeidet innenfor det tok rundt tjue minutter, det meste av tiden gikk med til å vente på skjemaet mens hookene kjørte. Pilotens deltakere logget inn neste morgen til det samme arbeidsområdet, der Enterprise-områdene i menyen ikke lenger var nedtonet.

Fra Community til Enterprise
Fra Community til Enterprise
Overgang fra en Community-installasjon til Enterprise. Siden bekrefter at lisensen er ekte og lister opp hva som vil bli hentet før noe hentes; organisasjonens personer og filer er markert som beholdt.

Etter importen

Lisenssiden under Denne installasjonen (This installation) lister opp hver funksjonsgruppe i lisensen med antall plasser og periode. Den sier også hvordan hver del leveres, for eksempel kompilert og lisensiert for en Enterprise-gruppe, eller åpen kildekode for Community-grunnivået. Grupper utenfor lisensen blir stående på listen, nedtonet. Administratorer kan snevre inn hva en gruppe når innad i organisasjonen; ingen andre enn Adverant kan utvide hva en lisens gir tilgang til.

Lisensens status beregnes på nytt ut fra dokumentet og datoen ved hver avlesning, så utløp skjer uten en planlagt jobb. Alle på installasjonen ser det samme varselet i konsollen når slutten nærmer seg: LICENCE_ENDS_SOON fra 30 dager før slutten, deretter LICENCE_IN_GRACE under henstandsperioden. Medlemmer ser varselet og datoene; kun installasjonsadministratorer ser selve lisensen. Kapittel 2.13, Lisenser, dekker fornyelse og utløpsstigen.

Lisens og hva den låser opp
Lisens og hva den låser opp
Dette er lisenssiden til en Enterprise-installasjon. Tallene øverst viser plasser og periode; under dem er hver funksjonsgruppe listet opp med hvordan den er beskyttet, og gruppene utenfor lisensen forblir nedtonet.

Hvis dette feiler

Hva dere ser Årsak Hva du skal gjøre
edition=enterprise but enterprise.enabled=false: they must agree Kun én av de to nøklene ble endret Endre begge
files/images.lock.json is the community lock; this install is edition enterprise Community-chartet ble brukt Bruk Enterprise-chartet fra Nedlastinger (Downloads)
image ... is a enterprise image; a community install takes only community images Et Enterprise-avbildningsnavn nådde en Community-gjengivelse Kontroller edition og chart-mappen
ImagePullBackOff på en Enterprise-avbildning etter oppgraderingen En node har ikke noe hentetoken, eller tokenet er ikke lenger gyldig Kontroller registries.yaml på den noden, eller lag et nytt token
En avvisningskode for lisens Se avvisningstabellen ovenfor Følg tilhørende rad; ingenting ble endret

Når lisenssiden viser Enterprise og gruppene du forventet, er installasjonen lisensiert. Neste stopp er førstegangskjøringen i kapittel 2.12, Førstegangskjøringen, hvis du ikke har gjort krav på installasjonen ennå. Hvis du har gjort det, trenger assistenten fortsatt organisasjonens egne modellnøkler for kunstig intelligens (KI) før den kan svare noen. Kapittel 2.14, KI-leverandører og -modeller, viser hvordan du kobler dem til.