Verżjoni 1.0.0-alpha.1l-aħħar
Kapitlu 2.7
Installazzjoni ta' Enterprise u applikazzjoni ta' liċenzja
X'jinbidel meta tinstalla l-edizzjoni Enterprise, kif titlob liċenzja mill-kont tiegħek ta' Adverant, it-tliet modi kif timportaha ma' kull kodiċi ta' rifjut, u kif Harrow Port Authority mexxiet il-pilota Community tagħha għal Enterprise fil-post mingħajr ma tilfet xejn.
Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

Installazzjoni ta' Enterprise għandha żewġ nofsijiet, u jaslu minn toroq differenti. L-immaġnijiet ta' Enterprise jiġu maċ-chart ta' Enterprise, miġbuda b'pull token. Il-liċenzja tiġi bħala fajl iffirmat mill-kont Adverant tiegħek, u timportaha fl-installazzjoni li tkun qed taħdem. L-ebda nofs ma jaħdem mingħajr l-ieħor: immaġnijiet mingħajr liċenzja jaħdmu fil-livell bażiku ta' Community, u liċenzja mingħajr immaġnijiet ta' Enterprise m'għandha xejn x'tixgħel.
F'Harrow Port Authority għamilnieha f'dak l-ordni, sitt ġimgħat wara l-proġett pilota ta' Community f'kapitlu 2.6, L-installazzjoni ta' Community fuq Kubernetes. L-aġġornament għaċ-chart ta' Enterprise ħa tieqa waħda ta' manutenzjoni; l-importazzjoni tal-liċenzja ħadet żewġ minuti. Dan il-kapitlu jkopri ż-żewġ nofsijiet. Jibda b'installazzjoni ġdida u jispiċċa b'installazzjoni eżistenti ta' Community li tinbidel fil-post.
X'inhu differenti minn Community
Żewġ valuri, u ċ-chart li taqrahom.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueKull ħaġa oħra fil-fajl tal-valuri tibqa' eżatt kif kienet, l-isem tal-installazzjoni u l-kustodji fuq kollox. Iż-żewġ kjavi jridu jaqblu, u ċ-chart tirrifjuta edition: enterprise ma' enterprise.enabled: false, jew bil-kontra.
L-edizzjoni trid taqbel ukoll mal-lock tal-immaġnijiet taċ-chart. Kull pakkett ta' chart iġorr il-lock għal edizzjoni waħda, u l-lock ta' Enterprise telenka l-immaġnijiet ta' Community flimkien mal-builds ta' Enterprise. Ipponta fajl tal-valuri ta' Enterprise lejn iċ-chart ta' Community u r-render jieqaf b'files/images.lock.json is the community lock; this install is edition enterprise. Għalhekk l-installazzjoni ta' Enterprise teħtieġ iċ-chart ta' Enterprise.
Iċ-chart u l-bundle ta' Enterprise jinsabu fuq il-paġna tat-Tniżżil (Downloads) tal-kont Adverant tiegħek, li ssegwi l-liċenzja tiegħek. Il-fajl taċ-chart għandu l-istess isem bħal dak ta' Community, nexus-1.0.0-alpha.1.tgz, għalhekk żomm it-tnejn f'folders separati. Iċċekkjah eżatt kif jiddeskrivi kapitlu 2.4, Il-ksib u l-verifika ta' rilaxx, mal-kjavi tar-rilaxx li l-marka tas-swaba' (fingerprint) tagħha ċċekkjajt:
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
Imbagħad ħaddem il-loop tal-firma minn kapitlu 2.4, Il-ksib u l-verifika ta' rilaxx, fuq enterprise/nexus/files/images.lock.json. Dan ikopri l-immaġnijiet ta' Enterprise kif ukoll dawk kondiviżi.
Il-pull token
L-immaġnijiet ta' Community huma pubbliċi. L-immaġnijiet ta' Enterprise jeħtieġu pull token mill-paġna Pull tokens u kmandi tal-installazzjoni tal-kont tiegħek, ikkonfigurat għar-runtime tal-kontenitur tan-nodi tiegħek kif juri kapitlu 2.4, Il-ksib u l-verifika ta' rilaxx, pass 3. Fuq k3s dik hija entrata configs għal registry.adverant.ai f'/etc/rancher/k3s/registries.yaml fuq kull nodu.
Agħmel token wieħed għal kull cluster u agħtih data tat-tmiem li tinnota. Meta token jiskadi, il-pods li jkunu qed jaħdmu jkomplu għaddejjin, iżda pod skedat mill-ġdid fuq nodu li għad m'għandux l-immaġni ma jistax jiġbidha. Aħna npoġġu d-data tat-tmiem tat-token fl-istess kalendarju bħal taċ-ċertifikat.
Installazzjoni ġdida ta' Enterprise
Jekk qed tinstalla Enterprise mill-bidu, segwi kapitlu 2.6, L-installazzjoni ta' Community fuq Kubernetes, pass pass, bi tliet differenzi:
Poġġi l-pull token fuq kull nodu qabel il-pass 6.
Uża l-valuri ta' Enterprise (iż-żewġ kjavi t'hawn fuq) fil-pass 4.
Fil-pass 6, installa mill-fajl taċ-chart ta' Enterprise li niżżilt:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Kull ħaġa wara l-kmand tal-installazzjoni hija l-istess bħal f'kapitlu 2.6, L-installazzjoni ta' Community fuq Kubernetes, u hekk ukoll hija r-regola dwar --wait: tużahiex. Jekk minflok tinstalla b'nexusctl, żid --edition enterprise mal-kmand:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseMeta kull workload ikun lest, għaddi mill-ewwel tħaddim f'kapitlu 2.12, L-ewwel tħaddim. Il-liċenzja hija waħda mis-sitt affarijiet li l-console telenka qabel ma xi ħadd jidħol fis-sistema. Sakemm tiġi importata, l-installazzjoni taħdem fil-livell bażiku ta' Community u kull żona ta' Enterprise tintwera bil-griż b'katnazz.
Talba għal-liċenzja
Liċenzja mingħand Adverant tinħareġ għall-identità ta' installazzjoni waħda, dik li l-maħżen tal-kjavi (key store) ħoloq taħt keys.installationName waqt l-installazzjoni. Għalhekk il-kont irid ikun jaf għal liema installazzjoni qed tirreferi qabel ma jkun jista' joħroġ waħda.
- Idħol fil-kont Adverant tiegħek fuq
https://account.adverant.ai. - Fuq l-installazzjoni, iftaħ Din l-installazzjoni (This installation), imbagħad Liċenzja (Licence). Turi kodiċi ta' darba u l-marka tas-swaba' (fingerprint) tal-installazzjoni.
- Fil-kont tiegħek, iftaħ Itlob skjerament (Claim a deployment) u daħħal il-kodiċi. Imbagħad qabbel l-impronta diġitali li rċieva l-kont ma' dik li turi l-installazzjoni, grupp b'grupp; kull grupp irid jaqbel.
- Agħfas il-buttuna tal-klejm. L-installazzjoni tingħaqad mat-Tjers (Deployments) tal-kont tiegħek, bil-verżjoni u l-istat tal-liċenzja tagħha.
- Adverant joħroġ il-liċenzja għal dik l-installazzjoni. Niżżel il-fajl mill-kont tiegħek; huwa msemmi għall-id tal-liċenzja tiegħu,
<licence-id>.json.
Kodiċi tal-klejm jaħdem darba u għal żmien qasir. Jekk jiskadi, il-kont jirrifjutah b'CLAIM_CODE_EXPIRED, u l-installazzjoni turi wieħed ġdid.
Jeżistu żewġ rotot oħra, u kapitlu 2.13, Liċenzji, ikopri t-tnejn kollha kemm huma. L-appliances u l-edge kits m'għandhomx skrin biex juru kodiċi, għalhekk jiġu kklejmjati bi kjavi tal-klejm (claim key) stampata fuq il-kaxxa, ittajpjata f'Daħħal kjavi tal-klejm (Enter a claim key) jew moqrija mill-fajl tal-ordni tal-manifattur. Installazzjoni mingħajr rotta 'l barra tuża l-Iskambju offline (Offline exchange): tagħmel fajl ta' talba għal liċenzja ffirmat, inti tieħdu fil-kont tiegħek, u tieħu l-fajl tal-liċenzja lura. Darba fis-sena tagħmel dikjarazzjoni tal-użu ffirmata bl-istess mod. Kull fajl fl-iskambju huwa ffirmat, għalhekk fajl mibdul fit-triq jiġi rrifjutat, b'LICENCE_REQUEST_SIGNATURE_INVALID għal talba u USAGE_FILE_SIGNATURE_INVALID għal fajl tal-użu.
X'fih il-fajl tal-liċenzja
Il-liċenzja hija dokument JSON fil-format nexus-licence/v1, iffirmat darbtejn minn Adverant b'żewġ kjavi indipendenti. M'għandekx bżonn taqrah, iżda jgħin li tkun taf x'hemm fih meta xi ħadd jistaqsi x'ixtrajt.
| Qasam | X'jgħid |
|---|---|
licence_id |
L-id tal-liċenzja stess, UUID (identifikatur uniku universali) b'ittri żgħar |
type |
alpha, evaluation jew commercial |
licensee |
L-isem tal-organizzazzjoni u l-id tal-klijent ta' Adverant |
scope |
L-installazzjoni li hija għaliha, u kwalunkwe organizzazzjoni li jsemmi konċessjoni (grant) |
edition |
enterprise |
grants |
Il-gruppi ta' karatteristiċi li tiftaħ, kull wieħed għall-installazzjoni kollha jew għal organizzazzjonijiet imsemmija |
add_ons u domain_packs |
Kapaċitajiet liċenzjati separatament; il-pakkett tal-Loġistika u marittimu huwa wieħed |
metric |
Kif tingħadd il-liċenzja, named-seat, per-core jew per-environment, u l-kwantità |
term |
starts_on, ends_on, u l-jiem ta' twissija u ta' grazzja |
matrix |
Il-verżjoni tal-matriċi tal-edizzjoni li nkitbet kontriha |
signatures |
Iż-żewġ firem ta' Adverant |
Liċenzja ta' evalwazzjoni ddum l-aktar 30 jum, għal l-aktar ħames persuni msemmija, mingħajr perjodu ta' grazzja. Liċenzja kummerċjali twissi 30 jum qabel ma tintemm u mbagħad tagħti 30 jum ta' grazzja b'mod awtomatiku. X'jiġri f'kull pass ta' dak is-sellum jinsab f'kapitlu 2.13, Liċenzji.
Il-firem ikopru d-dokument kif għamlu Adverant. Ibgħatu eżatt kif irċevejtu; tiftaħux f'editur li jista' jirranġah.
Importazzjoni tal-liċenzja
Amministratur tal-installazzjoni biss jista' jimporta liċenzja: sid jew amministratur tal-organizzazzjoni kollha li tippossjedi l-installazzjoni, waqt li jkun daħal fiha. Amministratur sħiħ tal-pjattaforma jista' jimporta waħda wkoll. Il-liċenzja qatt mhi valur ta' chart jew fajl immuntat f'pod. Tidħol fis-servizz tad-dħul (sign-in service), nexus-auth, li jiċċekkjaha offline mal-għeruq ta' fiduċja (trust roots) mibnija fl-immaġni tiegħu stess u jirreġistraha fi tranżazzjoni waħda. Tista' timportaha bi tliet modi, u kollha jispiċċaw fl-istess post.
Fil-console
Waqt l-ewwel tħaddim, iftaħ Sitt affarijiet qabel ma xi ħadd jidħol (Six things before anyone signs in), imbagħad Liċenzja (Licence). Il-paġna Importa l-liċenzja (Import the licence) tieħu l-fajl: itfgħu fuq il-paġna, jew agħżlu. Il-paġna tiċċekkjah offline fuq l-installazzjoni stess, imbagħad telenka l-gruppi ta' karatteristiċi li jiftaħ, b'kif kull wieħed huwa protett u sa meta. Gruppi li l-liċenzja ma tinkludix jibqgħu elenkati, bil-griż.
Aktar tard, l-istess importazzjoni hija l-buttuna Importa liċenzja ġdida fuq il-paġna tal-liċenzja tal-installazzjoni. Meta liċenzja tkun skadiet, il-paġna ristretta tal-liċenzja toffri Importa liċenzja mġedda.
B'nexusctl
nexusctl licence import <licence-id>.jsonnexusctl jibgħat il-fajl, mhux mibdul, lejn ir-rotta tal-importazzjoni tal-installazzjoni bħala amministratur tal-installazzjoni, u jirrapporta l-istat tal-liċenzja jew il-kodiċi ta' rifjut mit-tabella t'hawn taħt.
Permezz tal-API
Ir-rotta tal-importazzjoni hija parti mill-interfaċċja tal-ipprogrammar tal-applikazzjonijiet (API) tas-servizz tad-dħul, fuq l-indirizz hosts.auth tiegħek. Il-body huwa d-dokument tal-liċenzja, byte b'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> huwa t-token tal-aċċess ta' amministratur tal-installazzjoni li jkun daħal fis-sistema. Uża --data-binary, qatt -d, li jneħħi l-line breaks u b'hekk ibiddel il-bytes li tibgħat. Ir-rotta ma tieħu l-ebda query string u xejn fil-body ħlief id-dokument; body li jipprova jsemmi organizzazzjoni jew persuna fl-ogħla livell tiegħu jiġi rrifjutat qabel ma jinqara xi ħaġa.
Importazzjoni tajba twieġeb 201 Created. Imqassar, il-body jidher hekk:
{
"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 jgħodd l-organizzazzjonijiet fuq l-installazzjoni li issa għandhom il-liċenzja. tenants_without_organisation jgħodd l-organizzazzjonijiet li ssemmi l-liċenzja li din l-installazzjoni m'għandhiex.
Meta l-importazzjoni tiġi rrifjutata
Importazzjoni rrifjutata ma tbiddel xejn: l-ebda ringiela ma tinkiteb, u l-liċenzja fis-seħħ, jekk hemm waħda, tibqa' kif kienet. Ir-reġistru tal-awditjar (audit log) tal-installazzjoni jirreġistra kull tentattiv, inklużi dawk irrifjutati.
| Kodiċi | Stat | Xi tfisser | X'għandek tagħmel |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Waħda miż-żewġ firem ta' Adverant hija nieqsa jew ma tiġix ivverifikata; il-fajl inbidel wara l-iffirmar | Itlob lil Adverant għall-fajl mill-ġdid; teditjahx |
LICENCE_FORMAT_INVALID |
422 | Il-fajl mhuwiex liċenzja li dan ir-rilaxx jista' jaqra | Ibgħat il-fajl eżatt kif tahulek Adverant |
LICENCE_ROOT_UNKNOWN |
422 | Huwa ffirmat bi kjavi li din l-installazzjoni ma tafdax | Itlob għal liċenzja ffirmata għall-għeruq ta' fiduċja (trust roots) ta' dan ir-rilaxx, jew aġġorna |
LICENCE_MATRIX_MISMATCH |
422 | Huwa miktub kontra matriċi tal-edizzjoni li dan ir-rilaxx ma jaqrax, jew jagħti grupp li dan ir-rilaxx ma jafx bih | Aġġorna, jew itlob għal liċenzja miktuba kontra dan ir-rilaxx |
LICENCE_OTHER_INSTALLATION |
409 | Inħareġ għal installazzjoni oħra | Itlob għal liċenzja maħruġa għall-identità ta' din l-installazzjoni |
TRANSITION_NOT_PERMITTED |
409 | Liċenzja b'din l-id diġà ġiet importata; kull waħda tiġi importata darba | Itlob lil Adverant għal liċenzja ġdida jekk it-termini jridu jinbidlu |
LICENCE_REVOKED |
403 | Adverant irtira din il-liċenzja | Itlob lil Adverant għal waħda ġdida |
LICENCE_LOCKED |
403 | It-terminu tal-liċenzja għadu ma bediex; il-livell bażiku ta' Community japplika sa dakinhar | Importaha mill-ġdid fl-ewwel jum tagħha jew wara |
RECORD_NOT_FOUND |
404 | L-installazzjoni għadha ma ġietx iddikjarata, għalhekk m'għandha l-ebda identità ma' xiex tiċċekkja | Lesti l-pass tal-ewwel amministratur (kapitlu 2.12, L-ewwel tħaddim), imbagħad importa |
VALIDATION_FAILED |
400 | Il-body ma kienx jinqara jew kien aktar minn 1 MiB, jew intbagħtet query string | Ibgħat il-fajl bħala l-body kollu, mingħajr query |
Kodiċi ieħor jista' jiġi lura fuq importazzjoni b'suċċess, bħala avviż aktar milli rifjut: LICENCE_CLOCK_BEHIND_FLOOR ifisser li l-arloġġ tal-installazzjoni jaqra qabel l-aħħar ħin li diġà ra, għalhekk il-liċenzja tinqara f'dak il-ħin aktar tard. Li treġġa' arloġġ lura qatt ma jerġa' jqajjem liċenzja skaduta. Token ta' reset tal-ħin biss li Adverant jiffirma għall-installazzjoni jbaxxi l-livell bażiku.
Nimxu minn Community għal Enterprise fil-post
Dan huwa dak li għamilna f'Harrow. Xejn ma jiġi installat mill-ġdid u xejn ma jiġi migrat: hija l-istess installazzjoni, bl-istess identità u l-istess data, u aktar minnha mixgħula. L-isem tal-installazzjoni u l-kustodji jibqgħu eżatt kif kienu; waqt aġġornament, il-hook tal-kustodja jiċċekkja li l-maħżen tal-kjavi huwa diġà inizjalizzat u ma jagħmel xejn ieħor.
Poġġi l-pull token fuq kull nodu, u erġa' ibda r-runtime tal-kontenitur hemmhekk.
Ġib iċ-chart ta' Enterprise mit-Tniżżil (Downloads) u vverifika lilha u l-immaġnijiet tagħha kif jidher hawn fuq.
Biddel iż-żewġ valuri fil-fajl tal-valuri eżistenti tiegħek:
edition: enterpriseuenterprise.enabled: true. Tbiddel xejn ieħor.Ħaddem il-preflight bil-fajl il-ġdid.
nexusctl preflight --context harrow-prod --values harrow-values.yamlAġġorna r-rilaxx għaċ-chart ta' Enterprise, għal darb'oħra mingħajr
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mWaqt aġġornament, il-hooks jaħdmu qabel ma jidħlu l-pods il-ġodda, u kull migrazzjoni tapplika biss il-fajls li ma applikatx qabel. Is-sigrieti ġġenerati jinqraw lura mill-installazzjoni u jinżammu. Helm jispiċċa b':
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Stenna l-workloads, eżatt bħal f'kapitlu 2.6, L-installazzjoni ta' Community fuq Kubernetes, pass 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImporta l-liċenzja, bi kwalunkwe wieħed mit-tliet modi t'hawn fuq.
Fil-console, iftaħ Din l-installazzjoni (This installation), imbagħad Liċenzja (Licence), imbagħad Imxi għal Enterprise (Move to Enterprise). Il-paġna taqra l-liċenzja u turi x'se jinġieb u x'se jinbidel qabel ma jiġri xi ħaġa. Tgħodd ukoll in-nies u l-kontenut tal-organizzazzjoni u timmarka kull wieħed bħala miżmum. Agħfas Ġib u ixgħel. Kull parti tiġi ċċekkjata mal-kjavi tar-rilaxx ta' Adverant qabel ma tintuża, u l-gruppi ta' karatteristiċi jinxtegħlu wieħed wieħed.
It-tieqa tagħna kienet ta' siegħa; ix-xogħol ġo fiha ħa madwar għoxrin minuta, il-biċċa l-kbira minnu l-istennija tal-iskema waqt li ħadmu l-hooks. In-nies tal-proġett pilota daħlu fis-sistema l-għada filgħodu fl-istess spazju tax-xogħol, biż-żoni ta' Enterprise tal-menu mhux aktar bil-griż.
Wara l-importazzjoni
Il-paġna tal-liċenzja taħt Din l-installazzjoni (This installation) telenka kull grupp ta' karatteristiċi fil-liċenzja bis-seats u t-terminu tiegħu. Tgħid ukoll kif titwassal kull parti, pereżempju kkompilata u liċenzjata għal grupp ta' Enterprise, jew open source għal-livell bażiku ta' Community. Gruppi barra mil-liċenzja jibqgħu elenkati, bil-griż. L-amministraturi jistgħu jdejqu dak li jilħaq grupp ġewwa l-organizzazzjoni; ħadd ħlief Adverant ma jista' jwessa' dak li tagħti liċenzja.
L-istat tal-liċenzja jerġa' jinħadem mid-dokument u mid-data fuq kull qari, għalhekk l-iskadenza sseħħ mingħajr xogħol skedat. Kulħadd fuq l-installazzjoni jara l-istess avviż fil-console hekk kif joqrob it-tmiem: LICENCE_ENDS_SOON minn 30 jum qabel it-tmiem, imbagħad LICENCE_IN_GRACE matul il-perjodu ta' grazzja. Il-membri jaraw l-avviż u d-dati; l-amministraturi tal-installazzjoni biss jaraw il-liċenzja stess. Kapitlu 2.13, Liċenzji, ikopri t-tiġdid u s-sellum tal-iskadenza.
Jekk dan ifalli
| X'taraw | Kawża | X'għandek tagħmel |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Waħda biss miż-żewġ kjavi nbidlet | Biddel it-tnejn |
files/images.lock.json is the community lock; this install is edition enterprise |
Intużat iċ-chart ta' Community | Uża ċ-chart ta' Enterprise mit-Tniżżil (Downloads) |
image ... is a enterprise image; a community install takes only community images |
Isem ta' immaġni ta' Enterprise laħaq render ta' Community | Iċċekkja edition u l-folder taċ-chart |
ImagePullBackOff fuq immaġni ta' Enterprise wara l-aġġornament |
Nodu m'għandux pull token, jew it-token tiegħu m'għadux validu | Iċċekkja registries.yaml fuq dak in-nodu, jew agħmel token ġdid |
| Kodiċi ta' rifjut tal-liċenzja | Ara t-tabella tar-rifjut hawn fuq | Segwi r-ringiela tiegħu; ma nbidel xejn |
Meta l-paġna tal-liċenzja turi Enterprise u l-gruppi li stennejt, l-installazzjoni tkun liċenzjata. Il-waqfa li jmiss hija l-ewwel tħaddim f'kapitlu 2.12, L-ewwel tħaddim, jekk għadek ma kklejmjajtx l-installazzjoni. Jekk ikklejmjajtha, l-assistent xorta jeħtieġ il-kjavi tal-mudelli tal-intelliġenza artifiċjali (IA) tal-organizzazzjoni stess qabel ma jkun jista' jwieġeb lil xi ħadd. Kapitlu 2.14, Fornituri u mudelli tal-IA, juri kif tqabbadhom.




