HyniRezervoni një prezantim

Kapitulli 2.7

Instalimi i Enterprise dhe aplikimi i licencës

Çfarë ndryshon kur instaloni edicionin Enterprise, si të kërkoni një licencë nga llogaria juaj Adverant, tri mënyrat për ta importuar atë me çdo kod refuzimi dhe si Harrow Port Authority e kaloi pilotin e saj Community në Enterprise në vend, pa humbur asgjë.

Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

17 minuta lexim

Një instalim Enterprise ka dy gjysma dhe ato mbërrijnë nga rrugë të ndryshme. Imazhet Enterprise vijnë me paketën Helm (chart) Enterprise, të tërhequra me një token tërheqjeje (pull token). Licenca vjen si një skedar i nënshkruar nga llogaria juaj Adverant dhe ju e importoni atë në instalimin aktiv. Asnjëra gjysmë nuk funksionon pa tjetrën: imazhet pa licencë funksionojnë në nivelin bazë Community, ndërsa një licencë pa imazhe Enterprise nuk ka çfarë të aktivizojë.

Në Harrow Port Authority e bëmë pikërisht në atë renditje, gjashtë javë pas pilotit Community në kapitullin 2.6, Instalimi i Community në Kubernetes. Përmirësimi në paketën Enterprise kërkoi një dritare mirëmbajtjeje; importimi i licencës zgjati dy minuta. Ky kapitull mbulon të dyja gjysmat. Ai fillon me një instalim të ri nga e para dhe përfundon me një instalim ekzistues Community që zhvendoset në vend.

Dy korsi paralele që ushqejnë një kuti në të djathtë të etiketuar "Enterprise installation". Korsia e sipërme: "Adverant account: Downloads" të çon te "Enterprise chart and its images lock", pastaj te "helm install or helm upgrade, edition: enterprise", me një kuti anësore "pull token on every node" të bashkuar me të. Korsia e poshtme: "Adverant account: Deployments" të çon te "signed licence file", pastaj te "import into the running installation". Të dyja korsitë takohen te kutia në të djathtë. Poshtë saj, një rresht diçiture lexon "images without a licence run at the Community floor".
Dy gjysmat e një instalimi Enterprise dhe nga vjen secila.

Çfarë ndryshon nga Community

Dy vlera dhe paketa që i lexon ato.

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

Çdo gjë tjetër në skedarin e vlerave mbetet saktësisht siç ishte, mbi të gjitha emri i instalimit dhe kujdestarët (custodians). Të dy çelësat duhet të përputhen, dhe paketa refuzon edition: enterprise me enterprise.enabled: false, ose anasjelltas.

Edicioni duhet gjithashtu të përputhet me bllokimin e imazheve (images lock) të paketës. Çdo paketë mbart bllokimin për një edicion, dhe bllokimi Enterprise liston imazhet Community plus ndërtimet (builds) Enterprise. Drejtoni një skedar vlerash Enterprise te paketa Community dhe renderimi ndalon me files/images.lock.json is the community lock; this install is edition enterprise. Kështu që instalimi Enterprise ka nevojë për paketën Enterprise.

Paketa dhe grupi (bundle) Enterprise ndodhen në faqen Downloads të llogarisë suaj Adverant, e cila ndjek licencën tuaj. Skedari i paketës ka të njëjtin emër si ai Community, nexus-1.0.0-alpha.1.tgz, prandaj mbajini të dy në dosje të veçanta. Kontrollojeni atë saktësisht siç përshkruan kapitulli 2.4, Marrja dhe verifikimi i një versioni (release), kundrejt çelësit të versionit gjurmën e gishtit të të cilit e kontrolluat:

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

Më pas ekzekutoni ciklin e nënshkrimit nga kapitulli 2.4, Marrja dhe verifikimi i një versioni, mbi enterprise/nexus/files/images.lock.json. Ai mbulon si imazhet Enterprise ashtu edhe ato të përbashkëta.

Tokeni i tërheqjes

Imazhet Community janë publike. Imazhet Enterprise kanë nevojë për një token tërheqjeje nga faqja Pull tokens and install commands e llogarisë suaj, të konfiguruar për mjedisin e ekzekutimit të kontejnerëve të nyjeve tuaja siç tregon kapitulli 2.4, Marrja dhe verifikimi i një versioni, hapi 3. Në k3s kjo është një hyrje configs për registry.adverant.ai në /etc/rancher/k3s/registries.yaml në çdo nyje.

Krijoni një token për çdo klaster dhe jepini një datë përfundimi që do ta vini re. Kur një token skadon, pod-et aktive vazhdojnë punën, por një pod i riplanifikuar në një nyje që nuk e ka ende imazhin nuk mund ta tërheqë atë. Ne e vendosëm datën e përfundimit të tokenit në të njëjtin kalendar me atë të certifikatës.

Një instalim i ri Enterprise

Nëse po instaloni Enterprise që nga fillimi, ndiqni kapitullin 2.6, Instalimi i Community në Kubernetes, hap pas hapi, me tri ndryshime:

  1. Vendosni tokenin e tërheqjes në çdo nyje përpara hapit 6.

  2. Përdorni vlerat Enterprise (dy çelësat më sipër) në hapin 4.

  3. Në hapin 6, instaloni nga skedari i paketës Enterprise që shkarkuat:

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

Çdo gjë pas komandës së instalimit është e njëjtë si në kapitullin 2.6, Instalimi i Community në Kubernetes, dhe po ashtu është edhe rregulli rreth --wait: mos e përdorni. Nëse në vend të kësaj instaloni me nexusctl, shtoni --edition enterprise në komandë:

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

Kur çdo ngarkesë pune (workload) të jetë gati, kaloni nëpër ekzekutimin e parë në kapitullin 2.12, Ekzekutimi i parë. Licenca është një nga gjashtë gjërat që konsola liston përpara se dikush të identifikohet. Derisa të importohet, instalimi funksionon në nivelin bazë Community dhe çdo zonë Enterprise shfaqet në ngjyrë gri me një dry.

Kërkimi i licencës

Një licencë nga Adverant lëshohet për identitetin e një instalimi, atë që depoja e çelësave prodhoi nën keys.installationName gjatë instalimit. Kështu që llogaria duhet të dijë se cilin instalim keni parasysh përpara se të mund të lëshojë një të tillë.

  1. Identifikohuni në llogarinë tuaj Adverant në https://account.adverant.ai.
  2. Në instalim, hapni This installation, pastaj Licence. Ajo tregon një kod njëpërdorimësh dhe gjurmën e gishtit të instalimit.
  3. Në llogarinë tuaj, hapni Claim a deployment dhe vendosni kodin. Më pas krahasoni gjurmën e gishtit që mori llogaria me atë që tregon instalimi, grup pas grupi; çdo grup duhet të përputhet.
  4. Shtypni butonin e marrjes në pronësi (claim). Instalimi i bashkohet seksionit Deployments të llogarisë suaj, me versionin dhe gjendjen e licencës së tij.
  5. Adverant lëshon licencën për atë instalim. Shkarkoni skedarin nga llogaria juaj; ai emërtohet sipas id-së së licencës së tij, <licence-id>.json.

Një kod marrjeje në pronësi funksionon një herë dhe për një kohë të shkurtër. Nëse skadon, llogaria e refuzon atë me CLAIM_CODE_EXPIRED, dhe instalimi shfaq një të ri.

Merrni në pronësi një vendosje (Claim a deployment)
Merrni në pronësi një vendosje (Claim a deployment)
Marrja në pronësi e një vendosjeje në llogarinë Adverant. Kodi njëpërdorimësh vendoset i pari, pastaj gjurma e gishtit krahasohet në grupe prej katër, kështu që askush nuk mund të marrë në pronësi një instalim përballë të cilit nuk ndodhet fizikisht.

Ekzistojnë edhe dy rrugë të tjera, dhe kapitulli 2.13, Licencat, i mbulon të dyja plotësisht. Pajisjet (appliances) dhe kompletet skajore (edge kits) nuk kanë ekran për të shfaqur një kod, kështu që ato merren në pronësi me një çelës pronësie të printuar në kuti, të shtypur te Enter a claim key ose të lexuar nga skedari i porosisë së prodhuesit. Një instalim pa rrugë daljeje në rrjet përdor shkëmbimin jashtë linje (Offline exchange): ai krijon një skedar kërkese licence të nënshkruar, ju e çoni atë në llogarinë tuaj dhe sillni mbrapsht skedarin e licencës. Një herë në vit ai krijon një deklaratë përdorimi të nënshkruar në të njëjtën mënyrë. Çdo skedar në shkëmbim është i nënshkruar, kështu që një skedar i ndryshuar gjatë rrugës refuzohet, me LICENCE_REQUEST_SIGNATURE_INVALID për një kërkesë dhe USAGE_FILE_SIGNATURE_INVALID për një skedar përdorimi.

Shkëmbimi jashtë linje
Shkëmbimi jashtë linje
Shkëmbimi jashtë linje në llogarinë Adverant. Skedarët e nënshkruar udhëtojnë dorazi në të dyja drejtimet, dhe një skedar i ndryshuar gjatë rrugës refuzohet me emër.

Çfarë përmban skedari i licencës

Licenca është një dokument JSON në formatin nexus-licence/v1, i nënshkruar dy herë nga Adverant me dy çelësa të pavarur. Nuk keni nevojë ta lexoni, por ndihmon të dini se çfarë ka në të kur dikush pyet se çfarë keni blerë.

Fusha Çfarë thotë ai
licence_id Id-ja e vetë licencës, një UUID (identifikues universalisht unik) me shkronja të vogla
type alpha, evaluation ose commercial
licensee Emri i organizatës dhe id-ja e klientit Adverant
scope Instalimi për të cilin është, dhe çdo organizatë që emërton një grant
edition enterprise
grants Grupet e veçorive që zhbllokon, secili për të gjithë instalimin ose për organizata të emërtuara
add_ons dhe domain_packs Aftësitë e licencuara veçmas; paketa e Logjistikës dhe detarisë është njëra prej tyre
metric Si numërohet licenca, named-seat, per-core ose per-environment, dhe sasia
term starts_on, ends_on, dhe ditët e paralajmërimit dhe të afatit shtesë (grace)
matrix Versioni i matricës së edicionit kundrejt të cilit është shkruar
signatures Dy nënshkrimet e Adverant

Një licencë vlerësimi zgjat më së shumti 30 ditë, për më së shumti pesë persona të emërtuar, pa afat shtesë. Një licencë komerciale paralajmëron 30 ditë përpara se të përfundojë dhe më pas jep 30 ditë afat shtesë si parazgjedhje. Çfarë ndodh në çdo hap të asaj shkalle gjendet në kapitullin 2.13, Licencat.

Nënshkrimet mbulojnë dokumentin ashtu siç e ka bërë Adverant. Dërgojeni saktësisht siç e keni marrë; mos e hapni në një redaktues që mund ta rregullojë formatimin e tij.

Importimi i licencës

Vetëm një administrator instalimi mund të importojë një licencë: një pronar ose administrator i të gjithë organizatës që zotëron instalimin, ndërsa është i identifikuar në të. Një administrator i plotë platforme mund të importojë gjithashtu një të tillë. Licenca nuk është kurrë një vlerë pakete (chart value) ose një skedar i montuar në një pod. Ajo shkon në shërbimin e identifikimit, nexus-auth, i cili e kontrollon atë jashtë linje kundrejt rrënjëve të besimit të ndërtuara në imazhin e tij dhe e regjistron atë në një transaksion të vetëm. Ju mund ta importoni atë në tri mënyra, dhe të gjitha përfundojnë në të njëjtin vend.

Në konsolë

Gjatë ekzekutimit të parë, hapni Six things before anyone signs in, pastaj Licence. Faqja Import the licence pranon skedarin: lëshojeni mbi faqe ose zgjidheni atë. Faqja e kontrollon atë jashtë linje në vetë instalimin, pastaj liston grupet e veçorive që hap, me mënyrën se si mbrohet secili dhe deri kur. Grupet që licenca nuk i përfshin mbeten të listuara, në ngjyrë gri.

Më vonë, i njëjti importim është butoni Import a new licence në faqen e licencës së instalimit. Kur një licencë ka skaduar, faqja e kufizuar e licencës ofron Import a renewed licence.

Importoni licencën
Importoni licencën
Importimi i licencës në konsolë. Skedari kontrollohet në vetë instalimin; faqja liston atë që zhbllokon sipas grupit të veçorive, dhe një skedar që dështon në kontrollin e nënshkrimit trajtohet si i munguar, me kodin e tij.

Me nexusctl

nexusctl licence import <licence-id>.json

nexusctl e dërgon skedarin, të pandryshuar, në rrugën e importimit të instalimit si administrator instalimi, dhe raporton gjendjen e licencës ose kodin e refuzimit nga tabela e mëposhtme.

Përmes API-t

Rruga e importimit është pjesë e ndërfaqes së programimit të aplikacioneve (API) të shërbimit të identifikimit, në adresën tuaj hosts.auth. Trupi (body) është dokumenti i licencës, bajt për 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> është tokeni i aksesit të një administratori instalimi të identifikuar. Përdorni --data-binary, kurrë -d, i cili heq ndërprerjet e rreshtave dhe kështu ndryshon bajtët që dërgoni. Rruga nuk pranon varg pyetësor (query string) dhe asgjë në trup përveç dokumentit; një trup që përpiqet të emërtojë një organizatë ose një person në nivelin e tij më të lartë refuzohet përpara se të lexohet diçka.

Një importim i suksesshëm përgjigjet me 201 Created. I shkurtuar, trupi duket kështu:

{
  "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 numëron organizatat në instalim që tani mbajnë licencën. tenants_without_organisation numëron organizatat që licenca emërton por që ky instalim nuk i mban.

Kur importimi refuzohet

Një importim i refuzuar nuk ndryshon asgjë: asnjë rresht nuk shkruhet, dhe licenca në fuqi, nëse ka një të tillë, mbetet siç ishte. Regjistri i auditimit të instalimit regjistron çdo përpjekje, përfshirë ato të refuzuara.

Kodi Statusi Çfarë do të thotë Çfarë duhet të bëni
LICENCE_SIGNATURE_INVALID 422 Një nga dy nënshkrimet e Adverant mungon ose nuk verifikohet; skedari është ndryshuar pas nënshkrimit Kërkojini Adverant skedarin përsëri; mos e modifikoni atë
LICENCE_FORMAT_INVALID 422 Skedari nuk është një licencë që ky version mund ta lexojë Dërgoni skedarin saktësisht siç e ka dhënë Adverant
LICENCE_ROOT_UNKNOWN 422 Është nënshkruar me një çelës që ky instalim nuk e beson Kërkoni një licencë të nënshkruar për rrënjët e besimit të këtij versioni, ose kryeni përmirësimin (upgrade)
LICENCE_MATRIX_MISMATCH 422 Është shkruar kundrejt një matrice edicioni që ky version nuk e lexon, ose jep një grup që ky version nuk e njeh Kryeni përmirësimin, ose kërkoni një licencë të shkruar kundrejt këtij versioni
LICENCE_OTHER_INSTALLATION 409 Është lëshuar për një instalim tjetër Kërkoni një licencë të lëshuar për identitetin e këtij instalimi
TRANSITION_NOT_PERMITTED 409 Një licencë me këtë id është importuar tashmë; secila importohet një herë Kërkojini Adverant një licencë të re nëse kushtet duhet të ndryshojnë
LICENCE_REVOKED 403 Adverant e ka tërhequr këtë licencë Kërkojini Adverant një të re
LICENCE_LOCKED 403 Afati i licencës nuk ka filluar; niveli bazë Community zbatohet deri atëherë Importojeni përsëri në ose pas ditës së saj të parë
RECORD_NOT_FOUND 404 Instalimi nuk është deklaruar ende, kështu që nuk ka identitet kundrejt të cilit të kontrollohet Përfundoni hapin e administratorit të parë (kapitulli 2.12, Ekzekutimi i parë), pastaj importoni
VALIDATION_FAILED 400 Trupi ishte i palexueshëm ose mbi 1 MiB, ose u dërgua një varg pyetësor Dërgoni skedarin si të gjithë trupin, pa varg pyetësor

Një kod tjetër mund të kthehet në një importim të suksesshëm, si njoftim dhe jo si refuzim: LICENCE_CLOCK_BEHIND_FLOOR do të thotë që ora e instalimit tregon më herët sesa koha më e fundit që ka parë tashmë, kështu që licenca lexohet në atë kohë të mëvonshme. Kthimi i orës pas nuk ringjall kurrë një licencë të skaduar. Vetëm një token për rivendosjen e kohës që Adverant e nënshkruan për instalimin e ul pragun kohor.

Kalimi i Community në Enterprise në vend

Kjo është ajo që bëmë në Harrow. Asgjë nuk riinstalohet dhe asgjë nuk migrohet: është i njëjti instalim, me të njëjtin identitet dhe të njëjtat të dhëna, dhe me më shumë pjesë të tij të aktivizuara. Emri i instalimit dhe kujdestarët mbeten saktësisht siç ishin; gjatë një përmirësimi, kapësi i kujdestarisë (custody hook) kontrollon që depoja e çelësave është inicializuar tashmë dhe nuk bën asgjë tjetër.

  1. Vendosni tokenin e tërheqjes në çdo nyje dhe rinisni mjedisin e ekzekutimit të kontejnerëve atje.

  2. Merrni paketën Enterprise nga Downloads dhe verifikojeni atë dhe imazhet e saj si më sipër.

  3. Ndryshoni dy vlerat në skedarin tuaj ekzistues të vlerave: edition: enterprise dhe enterprise.enabled: true. Mos ndryshoni asgjë tjetër.

  4. Ekzekutoni kontrollin paraprak (preflight) me skedarin e ri.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Përmirësoni versionin në paketën Enterprise, përsëri pa --wait.

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

    Gjatë një përmirësimi, kapësit (hooks) ekzekutohen përpara se të lëshohen pod-et e reja, dhe çdo migrim zbaton vetëm skedarët që nuk i ka zbatuar më parë. Sekretet e gjeneruara lexohen përsëri nga instalimi dhe ruhen. Helm përfundon me:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Prisni për ngarkesat e punës, saktësisht si në kapitullin 2.6, Instalimi i Community në Kubernetes, hapi 7.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Importoni licencën, me cilëndo nga tri mënyrat e mësipërme.

  8. Në konsolë, hapni This installation, pastaj Licence, pastaj Move to Enterprise. Faqja lexon licencën dhe tregon se çfarë do të merret dhe çfarë do të ndryshojë përpara se të ndodhë diçka. Ajo gjithashtu numëron njerëzit dhe përmbajtjen e organizatës dhe i shënon secilën si të ruajtur. Shtypni Fetch and switch on. Çdo pjesë kontrollohet kundrejt çelësit të versionit të Adverant përpara se të përdoret, dhe grupet e veçorive aktivizohen një nga një.

Dritarja jonë ishte një orë; puna brenda saj zgjati rreth njëzet minuta, pjesa më e madhe e saj pritja e skemës ndërsa kapësit ekzekutoheshin. Njerëzit e pilotit u identifikuan mëngjesin tjetër në të njëjtën hapësirë pune, me zonat Enterprise të menysë që nuk ishin më në ngjyrë gri.

Nga Community në Enterprise
Nga Community në Enterprise
Zhvendosja e një instalimi Community në Enterprise. Faqja konfirmon që licenca është autentike dhe liston atë që do të merret përpara se të merret diçka; njerëzit dhe skedarët e organizatës shënohen si të ruajtur.

Pas importimit

Faqja e licencës nën This installation liston çdo grup veçorish në licencë me vendet (seats) dhe afatin e tij. Ajo gjithashtu tregon se si dorëzohet çdo pjesë, për shembull e kompiluar dhe e licencuar për një grup Enterprise, ose me burim të hapur (open source) për nivelin bazë Community. Grupet jashtë licencës mbeten të listuara, në ngjyrë gri. Administratorët mund të ngushtojnë atë që arrin një grup brenda organizatës; askush përveç Adverant nuk mund të zgjerojë atë që jep një licencë.

Gjendja e licencës llogaritet përsëri nga dokumenti dhe data në çdo lexim, kështu që skadimi ndodh pa një punë të planifikuar (scheduled job). Të gjithë në instalim shohin të njëjtin njoftim në konsolë ndërsa fundi afron: LICENCE_ENDS_SOON nga 30 ditë para përfundimit, pastaj LICENCE_IN_GRACE gjatë periudhës së afatit shtesë. Anëtarët shohin njoftimin dhe datat; vetëm administratorët e instalimit shohin vetë licencën. Kapitulli 2.13, Licencat, mbulon rinovimin dhe shkallën e skadimit.

Licenca dhe çfarë zhbllokon ajo
Licenca dhe çfarë zhbllokon ajo
Kjo është faqja e licencës së një instalimi Enterprise. Shifrat në pjesën e sipërme japin vendet dhe afatin; poshtë tyre, çdo grup veçorish është listuar me mënyrën se si mbrohet, dhe grupet jashtë licencës mbeten në ngjyrë gri.

Nëse kjo dështon

Çfarë shihni Shkaku Çfarë duhet të bëni
edition=enterprise but enterprise.enabled=false: they must agree Vetëm njëri nga dy çelësat u ndryshua Ndryshoni të dy
files/images.lock.json is the community lock; this install is edition enterprise U përdor paketa Community Përdorni paketën Enterprise nga Downloads
image ... is a enterprise image; a community install takes only community images Një emër imazhi Enterprise arriti në një renderim Community Kontrolloni edition dhe dosjen e paketës
ImagePullBackOff në një imazh Enterprise pas përmirësimit Një nyje nuk ka token tërheqjeje, ose tokeni i saj nuk është më i vlefshëm Kontrolloni registries.yaml në atë nyje, ose krijoni një token të ri
Një kod refuzimi licence Shihni tabelën e refuzimeve më sipër Ndiqni rreshtin e tij; asgjë nuk u ndryshua

Kur faqja e licencës tregon Enterprise dhe grupet që prisnit, instalimi është i licencuar. Ndalesa tjetër është ekzekutimi i parë në kapitullin 2.12, Ekzekutimi i parë, nëse nuk e keni marrë ende në pronësi instalimin. Nëse e keni bërë, asistenti ka ende nevojë për çelësat e modeleve të inteligjencës artificiale (AI) të vetë organizatës përpara se të mund t'i përgjigjet dikujt. Kapitulli 2.14, Ofruesit dhe modelet e AI, tregon se si t'i lidhni ato.