Versija 1.0.0-alpha.1jaunākā
2.7. nodaļa
Enterprise izdevuma instalēšana un licences piemērošana
Kas mainās, instalējot Enterprise izdevumu, kā pieprasīt licenci savā Adverant kontā, trīs tās importēšanas veidi ar visiem atteikuma kodiem un kā Harrow Port Authority uz vietas pārcēla savu Community izmēģinājuma versiju uz Enterprise, neko nezaudējot.
Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

Enterprise instalācijai ir divas daļas, un tās tiek saņemtas pa dažādiem ceļiem. Enterprise attēli tiek piegādāti kopā ar Enterprise pakotni (chart) un lejupielādēti, izmantojot lejupielādes marķieri (pull token). Licence tiek nodrošināta kā parakstīts fails no jūsu Adverant konta, un jūs to importējat darbojošajā instalācijā. Neviena daļa nedarbojas bez otras: attēli bez licences darbojas Community bāzes līmenī, savukārt licencei bez Enterprise attēliem nav ko ieslēgt.
Harrow Port Authority mēs to paveicām tieši šādā secībā, sešas nedēļas pēc Community izmēģinājuma projekta, kas aprakstīts 2.6. nodaļā, Community instalēšana vidē Kubernetes. Jaunināšana uz Enterprise pakotni aizņēma vienu uzturēšanas logu; licences importēšana prasīja divas minūtes. Šī nodaļa aptver abas daļas. Tā sākas ar jaunu instalāciju un beidzas ar esošas Community instalācijas pāreju uz vietas.
Atšķirības no Community izdevuma
Divas vērtības un pakotne, kas tās nolasa.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueViss pārējais vērtību failā paliek tieši tāds, kāds tas bija, jo īpaši instalācijas nosaukums un glabātāji. Abām atslēgām ir jāsakrīt, un pakotne noraida edition: enterprise ar enterprise.enabled: false vai otrādi.
Izdevumam ir jāsakrīt arī ar pakotnes attēlu fiksācijas failu (images lock). Katra pakotne ietver fiksāciju vienam izdevumam, un Enterprise fiksācijā ir uzskaitīti Community attēli, kā arī Enterprise būvējumi. Ja norādīsiet Enterprise vērtību failu uz Community pakotni, renderēšana apstāsies ar files/images.lock.json is the community lock; this install is edition enterprise. Tādēļ Enterprise instalācijai ir nepieciešama Enterprise pakotne.
Enterprise pakotne un komplekts atrodas jūsu Adverant konta lapā Lejupielādes (Downloads), kas atbilst jūsu licencei. Pakotnes failam ir tāds pats nosaukums kā Community failam — nexus-1.0.0-alpha.1.tgz, tāpēc glabājiet tos atsevišķās mapēs. Pārbaudiet to tieši tā, kā aprakstīts 2.4. nodaļā, Laidiena iegūšana un verificēšana, izmantojot laidiena atslēgu, kuras kontrolvirkni pārbaudījāt:
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
Pēc tam palaidiet parakstu pārbaudes ciklu no 2.4. nodaļas, Laidiena iegūšana un verificēšana, failam enterprise/nexus/files/images.lock.json. Tas aptver gan Enterprise attēlus, gan koplietotos attēlus.
Lejupielādes marķieris
Community attēli ir publiski. Enterprise attēliem ir nepieciešams lejupielādes marķieris no jūsu konta lapas Lejupielādes marķieri un instalēšanas komandas (Pull tokens and install commands), kas konfigurēts jūsu mezglu konteineru izpildlaikam, kā parādīts 2.4. nodaļas, Laidiena iegūšana un verificēšana, 3. darbībā. Vidē k3s tas ir configs ieraksts priekš registry.adverant.ai failā /etc/rancher/k3s/registries.yaml katrā mezglā.
Izveidojiet vienu marķieri katram klasterim un iestatiet tam beigu datumu, kuru pamanīsiet. Kad marķiera derīguma termiņš beidzas, darbojošies podi turpina darbu, bet pods, kas tiek pārplānots uz mezglu, kurā vēl nav šī attēla, nevar to lejupielādēt. Mēs marķiera beigu datumu ierakstām tajā pašā kalendārā, kur sertifikāta beigu datumu.
Jauna Enterprise instalācija
Ja instalējat Enterprise no nulles, sekojiet 2.6. nodaļai, Community instalēšana vidē Kubernetes, soli pa solim, ievērojot trīs atšķirības:
Pirms 6. darbības ievietojiet lejupielādes marķieri katrā mezglā.
4. darbībā izmantojiet Enterprise vērtības (divas iepriekš minētās atslēgas).
6. darbībā veiciet instalēšanu no lejupielādētā Enterprise pakotnes faila:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Viss pēc instalēšanas komandas ir tāds pats kā 2.6. nodaļā, Community instalēšana vidē Kubernetes, un tāds pats ir arī noteikums par --wait: neizmantojiet to. Ja tā vietā instalējat ar nexusctl, pievienojiet komandai --edition enterprise:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseKad katra darba slodze ir gatava, izpildiet pirmo palaišanu saskaņā ar 2.12. nodaļu, Pirmā palaišana. Licence ir viena no sešām lietām, ko konsole uzskaita, pirms kāds pierakstās. Līdz tās importēšanai instalācija darbojas Community bāzes līmenī, un katra Enterprise sadaļa tiek rādīta pelēkota ar slēdzenes ikonu.
Licences pieprasīšana
Adverant licence tiek izsniegta vienas instalācijas identitātei — tai, kuru atslēgu krātuve izveidoja zem keys.installationName instalēšanas laikā. Tādēļ kontam ir jāzina, kuru instalāciju jūs domājat, pirms tas var izsniegt licenci.
- Pierakstieties savā Adverant kontā vietnē
https://account.adverant.ai. - Instalācijā atveriet Šī instalācija (This installation), pēc tam Licence. Tur tiek parādīts vienreizējs kods un instalācijas kontrolvirkne.
- Savā kontā atveriet Pieprasīt izvietojumu (Claim a deployment) un ievadiet kodu. Pēc tam salīdziniet konta saņemto kontrolvirkni ar to, ko rāda instalācija, grupu pa grupai; katrai grupai ir jāsakrīt.
- Nospiediet pieprasīšanas pogu. Instalācija tiek pievienota jūsu konta sadaļai Izvietojumi (Deployments) ar savu versiju un licences statusu.
- Adverant izsniedz licenci šai instalācijai. Lejupielādējiet failu no sava konta; tas ir nosaukts pēc tā licences id —
<licence-id>.json.
Pieprasīšanas kods darbojas vienu reizi un īsu laiku. Ja tā termiņš beidzas, konts to noraida ar CLAIM_CODE_EXPIRED, un instalācija parāda jaunu kodu.
Pastāv vēl divi citi ceļi, un 2.13. nodaļā, Licences, tie abi ir aprakstīti pilnībā. Iekārtām un perifērijas komplektiem (edge kits) nav ekrāna, kurā parādīt kodu, tāpēc tos pieprasa ar uz kastes uzdrukātu pieprasīšanas atslēgu, ko ievada sadaļā Ievadīt pieprasīšanas atslēgu (Enter a claim key) vai nolasa no ražotāja pasūtījuma faila. Instalācija bez izejošā savienojuma izmanto Bezsaistes apmaiņu (Offline exchange): tā izveido parakstītu licences pieprasījuma failu, jūs to nogādājat savā kontā un pēc tam nogādājat licences failu atpakaļ. Reizi gadā tā tādā pašā veidā izveido parakstītu lietojuma pārskatu. Katrs apmaiņas fails ir parakstīts, tāpēc ceļā izmainīts fails tiek noraidīts ar LICENCE_REQUEST_SIGNATURE_INVALID pieprasījumam un USAGE_FILE_SIGNATURE_INVALID lietojuma failam.
Ko satur licences fails
Licence ir JSON dokuments formātā nexus-licence/v1, ko Adverant ir divreiz parakstījis ar divām neatkarīgām atslēgām. Jums tas nav jālasa, taču ir noderīgi zināt, kas tajā atrodas, kad kāds jautā, ko esat iegādājies.
| Lauks | Ko tas norāda |
|---|---|
licence_id |
Pašas licences id, mazo burtu UUID (universāli unikāls identifikators) |
type |
alpha, evaluation vai commercial |
licensee |
Organizācijas nosaukumu un Adverant klienta id |
scope |
Instalāciju, kurai tā paredzēta, un jebkuras organizācijas, kas nosauktas piešķīrumā |
edition |
enterprise |
grants |
Funkciju grupas, ko tā atbloķē, katru visai instalācijai vai nosauktajām organizācijām |
add_ons un domain_packs |
Atsevišķi licencētās iespējas; Loģistikas un jūrniecības pakotne (Logistics and maritime pack) ir viena no tām |
metric |
Kā licence tiek uzskaitīta — named-seat, per-core vai per-environment — un daudzumu |
term |
starts_on, ends_on, kā arī brīdinājuma un labvēlības perioda dienas |
matrix |
Izdevumu matricas versiju, kurai tā tika izstrādāta |
signatures |
Divus Adverant parakstus |
Izmēģinājuma (evaluation) licence darbojas ne ilgāk kā 30 dienas, ne vairāk kā pieciem nosauktiem lietotājiem, bez labvēlības perioda. Komerciālā licence brīdina 30 dienas pirms termiņa beigām un pēc tam pēc noklusējuma piešķir 30 dienu labvēlības periodu. Tas, kas notiek katrā šīs secības posmā, ir aprakstīts 2.13. nodaļā, Licences.
Paraksti aizsargā dokumentu tieši tādā formā, kādā Adverant to izveidoja. Nosūtiet to tieši tādu, kādu saņēmāt; neatveriet to redaktorā, kas varētu mainīt tā formatējumu.
Licences importēšana
Licenci var importēt tikai instalācijas administrators: visas organizācijas, kurai pieder instalācija, īpašnieks vai administrators, esot tajā pierakstījies. Arī pilntiesīgs platformas administrators var to importēt. Licence nekad nav pakotnes vērtība vai podā piemontēts fails. Tā tiek nosūtīta pierakstīšanās pakalpojumam nexus-auth, kas to bezsaistē pārbauda pret tā paša attēlā iebūvētajām uzticamības saknēm un ieraksta to vienas transakcijas ietvaros. Jūs varat to importēt trīs veidos, un tie visi nonāk vienā un tajā pašā vietā.
Konsolē
Pirmās palaišanas laikā atveriet Sešas lietas, pirms kāds pierakstās (Six things before anyone signs in), pēc tam Licence. Lapa Importēt licenci (Import the licence) pieņem failu: ievelciet to lapā vai izvēlieties to. Lapa to bezsaistē pārbauda pašā instalācijā, pēc tam uzskaita funkciju grupas, ko tā atver, norādot, kā katra tiek aizsargāta un līdz kuram laikam. Grupas, kuras licence neietver, paliek sarakstā pelēkotas.
Vēlāk šī pati importēšana ir pieejama ar pogu Importēt jaunu licenci (Import a new licence) instalācijas licences lapā. Kad licences derīguma termiņš ir beidzies, ierobežotā licences lapa piedāvā pogu Importēt atjaunotu licenci (Import a renewed licence).
Ar nexusctl
nexusctl licence import <licence-id>.jsonnexusctl nosūta failu nemainītā veidā uz instalācijas importēšanas maršrutu instalācijas administratora vārdā un ziņo par licences statusu vai noraidījuma kodu no tālāk esošās tabulas.
Caur API
Importēšanas maršruts ir daļa no pierakstīšanās pakalpojuma lietojumprogrammu saskarnes (API) jūsu hosts.auth adresē. Pieprasījuma pamatteksts (body) ir licences dokuments, baitu pa baitam:
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> ir pierakstījušās instalācijas administratora piekļuves marķieris. Izmantojiet --data-binary, nekad neizmantojiet -d, kas noņem rindu pārnesumus un tādējādi izmaina nosūtītos baitus. Maršruts nepieņem vaicājuma virkni un pamattekstā nepieņem neko citu kā tikai dokumentu; pamatteksts, kas savā augšējā līmenī mēģina norādīt organizāciju vai personu, tiek noraidīts, pirms jebkas tiek nolasīts.
Veiksmīga importēšana atbild ar 201 Created. Saīsinātā veidā pamatteksts izskatās šādi:
{
"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 saskaita instalācijā esošās organizācijas, kurām tagad ir šī licence. tenants_without_organisation saskaita licencē nosauktās organizācijas, kuru šajā instalācijā nav.
Kad importēšana tiek noraidīta
Noraidīta importēšana neko nemaina: netiek ierakstīta neviena rinda, un spēkā esošā licence, ja tāda ir, paliek tāda, kāda tā bija. Instalācijas audita žurnāls reģistrē katru mēģinājumu, tostarp noraidītos.
| Kods | Statuss | Ko tas nozīmē | Kā rīkoties |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Trūkst viena no diviem Adverant parakstiem vai tas nav verificējams; fails pēc parakstīšanas ir izmainīts | Pieprasiet failu no Adverant vēlreiz; nerediģējiet to |
LICENCE_FORMAT_INVALID |
422 | Fails nav licence, ko šis laidiens spēj nolasīt | Nosūtiet failu tieši tādu, kādu Adverant to izsniedza |
LICENCE_ROOT_UNKNOWN |
422 | Tas ir parakstīts ar atslēgu, kurai šī instalācija neuzticas | Pieprasiet licenci, kas parakstīta šī laidiena uzticamības saknēm, vai veiciet jaunināšanu |
LICENCE_MATRIX_MISMATCH |
422 | Tā ir izstrādāta izdevumu matricai, ko šis laidiens nelasa, vai piešķir grupu, ko šis laidiens nepazīst | Veiciet jaunināšanu vai pieprasiet šim laidienam izstrādātu licenci |
LICENCE_OTHER_INSTALLATION |
409 | Tā tika izsniegta citai instalācijai | Pieprasiet licenci, kas izsniegta šīs instalācijas identitātei |
TRANSITION_NOT_PERMITTED |
409 | Licence ar šo id jau ir importēta; katru var importēt vienu reizi | Ja ir jāmaina nosacījumi, pieprasiet no Adverant jaunu licenci |
LICENCE_REVOKED |
403 | Adverant ir atsaucis šo licenci | Pieprasiet no Adverant jaunu licenci |
LICENCE_LOCKED |
403 | Licences darbības termiņš vēl nav sācies; līdz tam laikam tiek piemērots Community bāzes līmenis | Importējiet to vēlreiz tās pirmajā darbības dienā vai pēc tās |
RECORD_NOT_FOUND |
404 | Instalācija vēl nav deklarēta, tāpēc tai nav identitātes, pret kuru veikt pārbaudi | Pabeidziet pirmā administratora soli (2.12. nodaļa, Pirmā palaišana), pēc tam importējiet |
VALIDATION_FAILED |
400 | Pamatteksts nebija nolasāms vai pārsniedza 1 MiB, vai arī tika nosūtīta vaicājuma virkne | Nosūtiet failu kā visu pamattekstu, bez vaicājuma |
Veiksmīgas importēšanas gadījumā var tikt atgriezts vēl viens kods kā paziņojums, nevis noraidījums: LICENCE_CLOCK_BEHIND_FLOOR nozīmē, ka instalācijas pulkstenis rāda agrāku laiku nekā vēlākais laiks, ko tā jau ir fiksējusi, tāpēc licence tiek nolasīta šajā vēlākajā laikā. Pulksteņa pagriešana atpakaļ nekad neatjauno licenci, kurai beidzies derīguma termiņš. Tikai laika atiestatīšanas marķieris, ko Adverant paraksta šai instalācijai, pazemina laika slieksni.
Community pārcelšana uz Enterprise uz vietas
Tieši to mēs paveicām Harrow. Nekas netiek pārinstalēts un nekas netiek migrēts: tā ir tā pati instalācija ar to pašu identitāti un tiem pašiem datiem, tikai ar vairāk ieslēgtām iespējām. Instalācijas nosaukums un glabātāji paliek tieši tādi, kādi tie bija; jaunināšanas laikā glabāšanas piesaiste (custody hook) pārbauda, vai atslēgu krātuve jau ir inicializēta, un nedara neko citu.
Ievietojiet lejupielādes marķieri katrā mezglā un restartējiet tajā konteineru izpildlaiku.
Iegūstiet Enterprise pakotni no sadaļas Lejupielādes (Downloads) un verificējiet to un tās attēlus, kā aprakstīts iepriekš.
Nomainiet divas vērtības savā esošajā vērtību failā:
edition: enterpriseunenterprise.enabled: true. Nemainiet neko citu.Palaidiet pirmspārbaudi (preflight) ar jauno failu.
nexusctl preflight --context harrow-prod --values harrow-values.yamlJauniniet laidienu uz Enterprise pakotni, atkal bez
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mJaunināšanas laikā piesaistes (hooks) tiek izpildītas pirms jauno podu palaišanas, un katra migrācija piemēro tikai tos failus, kurus tā vēl nav piemērojusi iepriekš. Ģenerētie noslēpumi (secrets) tiek nolasīti no instalācijas un saglabāti. Helm pabeidz darbu ar:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Sagaidiet darba slodžu gatavību tieši tā, kā aprakstīts 2.6. nodaļas, Community instalēšana vidē Kubernetes, 7. darbībā.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImportējiet licenci jebkurā no trim iepriekš minētajiem veidiem.
Konsolē atveriet Šī instalācija (This installation), pēc tam Licence, pēc tam Pāriet uz Enterprise (Move to Enterprise). Lapa nolasa licenci un parāda, kas tiks iegūts un kas mainīsies, pirms jebkas notiek. Tā arī saskaita organizācijas lietotājus un saturu un atzīmē katru kā saglabātu. Nospiediet Iegūt un ieslēgt (Fetch and switch on). Katra daļa pirms izmantošanas tiek pārbaudīta ar Adverant laidiena atslēgu, un funkciju grupas tiek ieslēgtas pa vienai.
Mūsu uzturēšanas logs bija viena stunda; darbs tajā aizņēma aptuveni divdesmit minūtes, no kurām lielāko daļu aizņēma shēmas gaidīšana, kamēr darbojās piesaistes. Izmēģinājuma projekta dalībnieki nākamajā rītā pierakstījās tajā pašā darbvietā, kur izvēlnes Enterprise sadaļas vairs nebija pelēkotas.
Pēc importēšanas
Licences lapā zem sadaļas Šī instalācija (This installation) ir uzskaitīta katra licencē iekļautā funkciju grupa ar tās vietām un termiņu. Tajā ir arī norādīts, kā katra daļa tiek piegādāta, piemēram, kompilēta un licencēta Enterprise grupai vai atvērtā pirmkoda Community bāzes līmenim. Grupas ārpus licences paliek sarakstā pelēkotas. Administratori var sašaurināt to, kam grupa var piekļūt organizācijas ietvaros; neviens cits kā vien Adverant nevar paplašināt to, ko piešķir licence.
Licences statuss katrā nolasīšanas reizē tiek no jauna aprēķināts no dokumenta un datuma, tāpēc termiņa beigas iestājas bez ieplānota uzdevuma. Tuvojoties termiņa beigām, ikviens instalācijas lietotājs konsolē redz vienu un to pašu paziņojumu: LICENCE_ENDS_SOON sākot no 30 dienām pirms beigām, pēc tam LICENCE_IN_GRACE labvēlības perioda laikā. Dalībnieki redz paziņojumu un datumus; pašu licenci redz tikai instalācijas administratori. 2.13. nodaļā, Licences, ir aprakstīta atjaunošana un termiņa beigu posmu secība.
Ja tas neizdodas
| Ko jūs redzat | Cēlonis | Kā rīkoties |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Tika nomainīta tikai viena no divām atslēgām | Nomainiet abas |
files/images.lock.json is the community lock; this install is edition enterprise |
Tika izmantota Community pakotne | Izmantojiet Enterprise pakotni no sadaļas Lejupielādes (Downloads) |
image ... is a enterprise image; a community install takes only community images |
Enterprise attēla nosaukums nonāca Community renderēšanā | Pārbaudiet edition un pakotnes mapi |
ImagePullBackOff Enterprise attēlam pēc jaunināšanas |
Mezglam nav lejupielādes marķiera, vai tā marķieris vairs nav derīgs | Pārbaudiet registries.yaml šajā mezglā vai izveidojiet jaunu marķieri |
| Licences noraidījuma kods | Skatiet iepriekš esošo noraidījumu tabulu | Sekojiet atbilstošajai rindai; nekas netika mainīts |
Kad licences lapā ir redzams Enterprise un gaidītās grupas, instalācija ir licencēta. Nākamā pietura ir pirmā palaišana 2.12. nodaļā, Pirmā palaišana, ja vēl neesat pieprasījis instalāciju. Ja esat to izdarījis, asistentam joprojām ir nepieciešamas organizācijas pašas mākslīgā intelekta (MI) modeļu atslēgas, pirms tas var kādam atbildēt. 2.14. nodaļā, MI nodrošinātāji un modeļi, ir parādīts, kā tās savienot.




