PrijavaZakažite brifing

Poglavlje 2.7

Instaliranje izdanja Enterprise i primena licence

Šta se menja kada instalirate izdanje Enterprise, kako da zatražite licencu sa svog Adverant naloga, tri načina da je uvezete sa svim kodovima odbijanja i kako je Harrow Port Authority na licu mesta prebacio svoj Community pilot na Enterprise bez ikakvog gubitka.

Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

17 min čitanja

Enterprise instalacija se sastoji iz dve polovine, i one stižu različitim putevima. Enterprise slike dolaze sa Enterprise chartom i preuzimaju se pomoću tokena za povlačenje. Licenca stiže kao potpisana datoteka iz Vašeg Adverant naloga, a Vi je uvozite u pokrenutu instalaciju. Nijedna polovina ne funkcioniše bez druge: slike bez licence rade na osnovnom nivou Community izdanja, a licenca bez Enterprise slika nema šta da uključi.

U Harrow Port Authority smo to uradili upravo tim redosledom, šest nedelja nakon Community pilota iz poglavlja 2.6, Instaliranje Community izdanja na Kubernetes. Nadogradnja na Enterprise chart trajala je jedan period održavanja; uvoz licence trajao je dva minuta. Ovo poglavlje obuhvata obe polovine. Počinje novom instalacijom, a završava se postojećom Community instalacijom koja prelazi na Enterprise bez premeštanja.

Dve paralelne trake koje vode u jedan okvir desno, označen sa „Enterprise instalacija“. Gornja traka: „Adverant nalog: Preuzimanja“ vodi do „Enterprise chart i zaključavanje njegovih image-a“, zatim do „helm install ili helm upgrade, edition: enterprise“, uz bočni okvir „pull token na svakom čvoru“ povezan s njim. Donja traka: „Adverant nalog: Implementacije“ vodi do „potpisani fajl licence“, zatim do „uvoz u pokrenutu instalaciju“. Obe trake se spajaju u desnom okviru. Ispod njega, natpis glasi „image-i bez licence rade na Community osnovnom nivou“.
Dve polovine Enterprise instalacije i odakle svaka od njih dolazi.

Šta se razlikuje u odnosu na Community

Dve vrednosti i chart koji ih čita.

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

Sve ostalo u datoteci vrednosti ostaje tačno kakvo je bilo, a pre svega naziv instalacije i čuvari. Dva ključa moraju da se slažu, a chart odbija edition: enterprise sa enterprise.enabled: false, kao i obrnuto.

Izdanje takođe mora da se slaže sa zaključanim spiskom slika charta. Svaki chart paket nosi zaključani spisak za jedno izdanje, a Enterprise spisak navodi Community slike i Enterprise buildove. Ako Enterprise datoteku vrednosti usmerite na Community chart, renderovanje se zaustavlja sa files/images.lock.json is the community lock; this install is edition enterprise. Zato je za Enterprise instalaciju potreban Enterprise chart.

Enterprise chart i paket nalaze se na stranici Preuzimanja u Vašem Adverant nalogu, koja prati Vašu licencu. Datoteka charta ima isti naziv kao Community datoteka, nexus-1.0.0-alpha.1.tgz, pa ih čuvajte u odvojenim fasciklama. Proverite je tačno onako kako opisuje poglavlje 2.4, Preuzimanje i verifikacija izdanja, u odnosu na ključ izdanja čiji ste otisak proverili:

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

Zatim pokrenite petlju za proveru potpisa iz poglavlja 2.4, Preuzimanje i verifikacija izdanja, nad enterprise/nexus/files/images.lock.json. Ona obuhvata Enterprise slike kao i zajedničke slike.

Token za preuzimanje

Community slike su javne. Za Enterprise slike potreban je token za povlačenje sa stranice Tokeni za povlačenje i komande za instalaciju u Vašem nalogu, podešen za izvršno okruženje kontejnera na Vašim čvorovima, kao što prikazuje poglavlje 2.4, Preuzimanje i verifikacija izdanja, korak 3. Na k3s to je unos configs za registry.adverant.ai u /etc/rancher/k3s/registries.yaml na svakom čvoru.

Napravite jedan token po klasteru i dodelite mu datum isteka koji ćete primetiti. Kada token istekne, pokrenuti podovi nastavljaju da rade, ali pod koji se ponovo rasporedi na čvor koji još nema sliku ne može da je povuče. Datum isteka tokena uneli smo u isti kalendar kao i datum isteka sertifikata.

Nova Enterprise instalacija

Ako Enterprise instalirate od početka, pratite poglavlje 2.6, Instaliranje Community izdanja na Kubernetes, korak po korak, uz tri razlike:

  1. Postavite token za povlačenje na svaki čvor pre koraka 6.

  2. U koraku 4 koristite Enterprise vrednosti (dva gore navedena ključa).

  3. U koraku 6 instalirajte iz preuzete datoteke Enterprise charta:

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

Sve posle komande za instalaciju isto je kao u poglavlju 2.6, Instaliranje Community izdanja na Kubernetes, kao i pravilo o --wait: ne koristite ga. Ako umesto toga instalirate pomoću nexusctl, dodajte --edition enterprise komandi:

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

Kada su sva radna opterećenja spremna, prođite kroz prvo pokretanje opisano u poglavlju 2.12, Prvo pokretanje. Licenca je jedna od šest stavki koje konzola navodi pre nego što se bilo ko prijavi. Dok se ne uveze, instalacija radi na osnovnom nivou Community izdanja, a svaka Enterprise oblast prikazana je zasivljeno, sa katancem.

Podnošenje zahteva za licencu

Licenca kompanije Adverant izdaje se za identitet jedne instalacije, onaj koji je skladište ključeva generisalo pod keys.installationName prilikom instalacije. Zato nalog mora da zna na koju instalaciju mislite pre nego što može da je izda.

  1. Prijavite se na svoj Adverant nalog na https://account.adverant.ai.
  2. Na instalaciji otvorite Ova instalacija, zatim Licenca. Prikazuju se jednokratni kod i otisak instalacije.
  3. U svom nalogu otvorite Preuzmi implementaciju i unesite kod. Zatim uporedite otisak koji je nalog primio sa onim koji prikazuje instalacija, grupu po grupu; svaka grupa mora da se poklapa.
  4. Pritisnite dugme za preuzimanje. Instalacija se pridružuje Implementacijama Vašeg naloga, sa svojom verzijom i stanjem licence.
  5. Adverant izdaje licencu za tu instalaciju. Preuzmite datoteku iz svog naloga; nazvana je po identifikatoru licence, <licence-id>.json.

Kod za preuzimanje važi jednom i kratko vreme. Ako istekne, nalog ga odbija sa CLAIM_CODE_EXPIRED, a instalacija prikazuje novi.

Preuzmi implementaciju
Preuzimanje vlasništva nad implementacijom
Preuzimanje implementacije u Adverant nalogu. Prvo se unosi jednokratni kod, a zatim se otisak upoređuje u grupama od po četiri, tako da niko ne može da preuzme instalaciju ispred koje ne stoji.

Postoje još dva puta, a poglavlje 2.13, Licence, detaljno opisuje oba. Uređaji i edge kompleti nemaju ekran na kome bi prikazali kod, pa se preuzimaju pomoću ključa za preuzimanje odštampanog na kutiji, koji se unosi na stranici Unesite ključ za preuzimanje ili se čita iz datoteke porudžbine proizvođača. Instalacija bez izlaza na mrežu koristi Razmenu van mreže: ona pravi potpisanu datoteku zahteva za licencu, Vi je prenosite do svog naloga, a datoteku licence prenosite nazad. Jednom godišnje na isti način pravi potpisani izveštaj o korišćenju. Svaka datoteka u razmeni je potpisana, pa se datoteka izmenjena usput odbija, sa LICENCE_REQUEST_SIGNATURE_INVALID za zahtev i USAGE_FILE_SIGNATURE_INVALID za datoteku o korišćenju.

Razmena van mreže
Oflajn razmena
Razmena van mreže u Adverant nalogu. Potpisane datoteke se ručno prenose u oba smera, a datoteka izmenjena usput odbija se uz navođenje razloga.

Šta sadrži datoteka licence

Licenca je JSON dokument u formatu nexus-licence/v1, koji je Adverant potpisao dva puta, pomoću dva nezavisna ključa. Ne morate ga čitati, ali je korisno znati šta sadrži kada Vas neko pita šta ste kupili.

Polje Šta navodi
licence_id Sopstveni identifikator licence, UUID (univerzalno jedinstveni identifikator) malim slovima
type alpha, evaluation ili commercial
licensee Naziv organizacije i Adverant identifikator korisnika
scope Instalacija za koju je namenjena i sve organizacije koje dodela navodi
edition enterprise
grants Grupe funkcija koje otključava, svaku za celu instalaciju ili za navedene organizacije
add_ons i domain_packs Mogućnosti koje se licenciraju zasebno; paket za logistiku i pomorstvo je jedna od njih
metric Način obračuna licence, named-seat, per-core ili per-environment, i količina
term starts_on, ends_on i broj dana upozorenja i dodatnog roka
matrix Verzija matrice izdanja prema kojoj je napisana
signatures Dva potpisa kompanije Adverant

Licenca za evaluaciju traje najviše 30 dana, za najviše pet imenovanih osoba, bez dodatnog roka. Komercijalna licenca upozorava 30 dana pre isteka, a zatim podrazumevano daje 30 dana dodatnog roka. Šta se dešava na svakom koraku te lestvice opisano je u poglavlju 2.13, Licence.

Potpisi pokrivaju dokument onakav kakvim ga je Adverant napravio. Pošaljite ga tačno onakvog kakvog ste ga primili; ne otvarajte ga u uređivaču koji bi mogao da ga preuredi.

Uvoz licence

Licencu može da uveze samo administrator instalacije: vlasnik ili administrator cele organizacije koja poseduje instalaciju, dok je prijavljen na nju. Može je uvesti i administrator sa punim pravima na platformi. Licenca nikada nije vrednost charta niti datoteka montirana u pod. Ona se unosi u servis za prijavljivanje, nexus-auth, koji je proverava van mreže u odnosu na korene poverenja ugrađene u njegovu sopstvenu sliku i beleži je u jednoj transakciji. Možete je uvesti na tri načina, i svi vode do istog rezultata.

U konzoli

Tokom prvog pokretanja otvorite Šest stavki pre nego što se bilo ko prijavi, zatim Licenca. Stranica Uvoz licence prihvata datoteku: prevucite je na stranicu ili je izaberite. Stranica je proverava van mreže na samoj instalaciji, a zatim navodi grupe funkcija koje otvara, kao i način i rok zaštite svake od njih. Grupe koje licenca ne obuhvata ostaju navedene, zasivljeno.

Kasnije je isti uvoz dostupan preko dugmeta Uvezi novu licencu na stranici licence instalacije. Kada licenca istekne, ograničena stranica licence nudi Uvezi obnovljenu licencu.

Uvoz licence
Uvoz licence
Uvoz licence u konzoli. Datoteka se proverava na samoj instalaciji; stranica navodi šta licenca otključava po grupama funkcija, a datoteka koja ne prođe proveru potpisa smatra se nepostojećom, uz prikaz njenog koda.

Pomoću nexusctl

nexusctl licence import <licence-id>.json

nexusctl šalje datoteku, neizmenjenu, na rutu za uvoz instalacije kao administrator instalacije i prijavljuje stanje licence ili kod odbijanja iz tabele ispod.

Preko API-ja

Ruta za uvoz deo je aplikativnog programskog interfejsa (API) servisa za prijavljivanje, na Vašoj adresi hosts.auth. Telo zahteva je dokument licence, bajt po bajt:

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> je pristupni token prijavljenog administratora instalacije. Koristite --data-binary, nikada -d, koji uklanja prelome redova i tako menja bajtove koje šaljete. Ruta ne prihvata upitni niz niti išta u telu osim dokumenta; telo koje na najvišem nivou pokušava da navede organizaciju ili osobu odbija se pre nego što se bilo šta pročita.

Uspešan uvoz odgovara sa 201 Created. U skraćenom obliku, telo izgleda ovako:

{
  "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 broji organizacije na instalaciji koje sada imaju licencu. tenants_without_organisation broji organizacije koje licenca navodi, a koje ova instalacija nema.

Kada je uvoz odbijen

Odbijeni uvoz ništa ne menja: nijedan red se ne upisuje, a važeća licenca, ako postoji, ostaje nepromenjena. Revizorski dnevnik instalacije beleži svaki pokušaj, uključujući i odbijene.

Kod Status Šta znači Šta učiniti
LICENCE_SIGNATURE_INVALID 422 Jedan od dva potpisa kompanije Adverant nedostaje ili se ne može verifikovati; datoteka je izmenjena nakon potpisivanja Zatražite datoteku ponovo od kompanije Adverant; ne menjajte je
LICENCE_FORMAT_INVALID 422 Datoteka nije licenca koju ovo izdanje može da pročita Pošaljite datoteku tačno onakvu kakvu Vam je Adverant dao
LICENCE_ROOT_UNKNOWN 422 Potpisana je ključem kome ova instalacija ne veruje Zatražite licencu potpisanu za korene poverenja ovog izdanja ili izvršite nadogradnju
LICENCE_MATRIX_MISMATCH 422 Napisana je prema matrici izdanja koju ovo izdanje ne čita ili dodeljuje grupu koju ovo izdanje ne poznaje Izvršite nadogradnju ili zatražite licencu napisanu prema ovom izdanju
LICENCE_OTHER_INSTALLATION 409 Izdata je za drugu instalaciju Zatražite licencu izdatu za identitet ove instalacije
TRANSITION_NOT_PERMITTED 409 Licenca sa ovim identifikatorom je već uvezena; svaka se uvozi jednom Zatražite novu licencu od kompanije Adverant ako uslovi moraju da se promene
LICENCE_REVOKED 403 Adverant je povukao ovu licencu Zatražite novu od kompanije Adverant
LICENCE_LOCKED 403 Rok licence još nije počeo; do tada važi osnovni nivo Community izdanja Uvezite je ponovo na njen prvi dan ili kasnije
RECORD_NOT_FOUND 404 Instalacija još nije deklarisana, pa nema identitet prema kome bi se vršila provera Završite korak prvog administratora (poglavlje 2.12, Prvo pokretanje), a zatim izvršite uvoz
VALIDATION_FAILED 400 Telo je bilo nečitljivo ili veće od 1 MiB, ili je poslat upitni niz Pošaljite datoteku kao celo telo, bez upita

Uz uspešan uvoz može da se vrati još jedan kod, kao obaveštenje, a ne kao odbijanje: LICENCE_CLOCK_BEHIND_FLOOR znači da sat instalacije pokazuje vreme ranije od najkasnijeg vremena koje je već zabeležila, pa se licenca čita prema tom kasnijem vremenu. Vraćanje sata unazad nikada ne oživljava isteklu licencu. Samo token za resetovanje vremena koji Adverant potpiše za instalaciju spušta tu donju granicu.

Prelazak sa izdanja Community na Enterprise na licu mesta

Ovo smo uradili u Harrow. Ništa se ne instalira ponovo i ništa se ne migrira: to je ista instalacija, sa istim identitetom i istim podacima, samo sa više uključenih funkcija. Naziv instalacije i čuvari ostaju tačno kakvi su bili; pri nadogradnji, kuka za čuvanje proverava da li je skladište ključeva već inicijalizovano i ne radi ništa drugo.

  1. Postavite token za povlačenje na svaki čvor i tamo ponovo pokrenite izvršno okruženje kontejnera.

  2. Preuzmite Enterprise chart sa stranice Preuzimanja i verifikujte njega i njegove slike kao što je gore opisano.

  3. Promenite dve vrednosti u postojećoj datoteci vrednosti: edition: enterprise i enterprise.enabled: true. Ništa drugo ne menjajte.

  4. Pokrenite preflight proveru sa novom datotekom.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Nadogradite izdanje na Enterprise chart, ponovo bez --wait.

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

    Pri nadogradnji, kuke se izvršavaju pre uvođenja novih podova, a svaka migracija primenjuje samo datoteke koje ranije nije primenila. Generisane tajne se čitaju iz instalacije i zadržavaju. Helm se završava sa:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Sačekajte radna opterećenja, tačno kao u poglavlju 2.6, Instaliranje Community izdanja na Kubernetes, korak 7.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Uvezite licencu na bilo koji od tri gore opisana načina.

  8. U konzoli otvorite Ova instalacija, zatim Licenca, a zatim Prelazak na Enterprise. Stranica čita licencu i, pre nego što se bilo šta dogodi, prikazuje šta će biti preuzeto i šta će se promeniti. Takođe prebrojava ljude i sadržaj organizacije i svaku stavku označava kao zadržanu. Pritisnite Preuzmi i uključi. Svaki deo se proverava u odnosu na Adverant ključ izdanja pre nego što se upotrebi, a grupe funkcija se uključuju jedna po jedna.

Naš vremenski prozor bio je jedan sat; posao u okviru njega trajao je dvadesetak minuta, uglavnom čekanje na šemu dok su se izvršavali hookovi. Učesnici pilot-projekta prijavili su se sledećeg jutra u isti radni prostor, a Enterprise oblasti menija više nisu bile zasivljene.

Sa Community na Enterprise
Od Community do Enterprise
Prelazak Community instalacije na Enterprise. Stranica potvrđuje da je licenca autentična i navodi šta će biti preuzeto pre nego što se bilo šta preuzme; ljudi i fajlovi organizacije označeni su kao zadržani.

Nakon uvoza

Stranica licence u okviru Ova instalacija navodi svaku grupu funkcija u licenci, sa brojem mesta i trajanjem. Takođe navodi kako se svaki deo isporučuje, na primer kompajliran i licenciran za Enterprise grupu ili otvorenog koda za Community osnovni nivo. Grupe izvan licence ostaju navedene, zasivljene. Administratori mogu da suze ono do čega grupa dopire unutar organizacije; niko osim kompanije Adverant ne može da proširi ono što licenca dodeljuje.

Stanje licence se ponovo utvrđuje iz dokumenta i datuma pri svakom čitanju, pa do isteka dolazi bez zakazanog zadatka. Svi na instalaciji vide isto obaveštenje u konzoli kako se kraj približava: LICENCE_ENDS_SOON od 30 dana pre kraja, a zatim LICENCE_IN_GRACE tokom perioda odloženog isteka. Članovi vide obaveštenje i datume; samo administratori instalacije vide samu licencu. Poglavlje 2.13, Licence, obrađuje obnovu i stepene isteka.

Licenca i šta otključava
Licenca i ono što omogućava
Ovo je stranica licence Enterprise instalacije. Brojke na vrhu prikazuju broj mesta i trajanje; ispod njih je navedena svaka grupa funkcija sa načinom na koji je zaštićena, a grupe izvan licence ostaju zasivljene.

Ako ovo ne uspe

Šta vidite Uzrok Šta učiniti
edition=enterprise but enterprise.enabled=false: they must agree Promenjen je samo jedan od dva ključa Promenite oba
files/images.lock.json is the community lock; this install is edition enterprise Korišćen je Community chart Koristite Enterprise chart iz odeljka Preuzimanja
image ... is a enterprise image; a community install takes only community images Naziv Enterprise image-a dospeo je u Community render Proverite edition i fasciklu charta
ImagePullBackOff na Enterprise image-u nakon nadogradnje Čvor nema pull token ili njegov token više nije važeći Proverite registries.yaml na tom čvoru ili napravite novi token
Kod odbijanja licence Pogledajte tabelu odbijanja iznad Pratite odgovarajući red; ništa nije promenjeno

Kada stranica licence prikazuje Enterprise i grupe koje ste očekivali, instalacija je licencirana. Sledeći korak je prvo pokretanje u poglavlju 2.12, Prvo pokretanje, ako još niste preuzeli vlasništvo nad instalacijom. Ako jeste, asistentu su i dalje potrebni sopstveni ključevi modela veštačke inteligencije (AI) organizacije pre nego što može bilo kome da odgovori. Poglavlje 2.14, AI provajderi i modeli, pokazuje kako da ih povežete.