HyniRezervoni një prezantim

Kapitulli 2.8

Instalimet në një makinë të vetme

Instaloni Nexus në një server të vetëm Linux me nexusctl, ose vlerësojeni në një laptop me k3d, dhe hapni konsolën përmes HTTPS në mënyrë që identifikimi dhe çelësat e kalimit të funksionojnë.

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

18 minuta lexim

Përpara se Harrow Port Authority të vendoste Nexus në klasterin e saj të prodhimit, Tomás Reilly dëshironte dy instalime më të vogla. Njëri ishte një instalim pilot në një server rezervë Linux në ndërtesën e operacioneve, për dymbëdhjetë personat që do ta provonin të parët. Tjetri punonte në laptopin e tij, kështu që ai mund të prishte gjëra pa e vënë re askush. Ky kapitull mbulon të dyja. Ato përdorin të njëjtën paketë (chart), të njëjtat imazhe dhe të njëjtin ekzekutim të parë si një instalim i plotë në Kubernetes, kështu që ajo që mësoni në një pajisje vlen edhe më tej.

Rruga e serverit përbëhet nga një komandë e vetme: nexusctl install --single-node ndërton një klaster k3s në pajisje, instalon cert-manager dhe më pas instalon Nexus. Rruga e laptopit kërkon më shumë ndërhyrje manuale. Ju ndërtoni vetë një klaster k3d, instaloni cert-manager dhe paketën (chart) me Helm, dhe më pas bëni një punë shtesë ku ngecin pothuajse të gjithë: e vendosni konsolën pas HTTPS në pajisjen tuaj, sepse një port-forward i thjeshtë nuk mund të identifikojë kurrë askënd.

Sa e madhe duhet të jetë makina

Nexus kërkon rreth 2.05 bërthama CPU (njësi qendrore e përpunimit) dhe 6.7 GiB memorie në kërkesat me vlerat e paracaktuara të paketës, dhe vëllimet e tij arrijnë gjithsej në 142 GiB. Ky total përbëhet nga PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, hapësira e ruajtjes së objekteve 50, dy hapësirat e ruajtjes OpenBao 1 dhe 5, dhe vëllimi i faturave (receipts) 1. Kërkesat janë ato që rezervon planifikuesi (scheduler), ndërsa përdorimi real shkon më lart sapo njerëzit fillojnë punën.

Pajisja CPU Memoria (RAM, memorie me akses të rastësishëm) Disku
Nyje e vetme e rekomanduar 8 vCPU 32 GiB 250 GB SSD (disk në gjendje të ngurtë)
Minimumi për vlerësim 4 vCPU 16 GiB 200 GB

Një laptop që plotëson minimumin e vlerësimit do ta ekzekutojë Nexus, por vlen kufiri i memories së vetë Docker-it, jo ai i laptopit. Jepini Docker-it të paktën 16 GiB përpara se të filloni.

Të dyja rrugët kërkojnë Kubernetes 1.33 ose më të ri. Rruga me një nyje të vetme sjell versionin e vet: k3s v1.33.6+k3s1, shpërndarja në të cilën testohet çdo version (release).

Pjesa e parë: një server Linux me nexusctl

Serveri pilot i Tomás-it është një pajisje me 8 bërthama me 32 GiB memorie dhe një 500 GB SSD, që ekzekuton një Linux aktual pa asgjë tjetër në të. Instalimi kërkon qasje root, sepse e instalon k3s si një shërbim sistemi.

Merrni nexusctl dhe kontrollojeni atë

  1. Shkarkoni nexusctl për arkitekturën tuaj nga https://downloads.adverant.ai/nexus/1.0.0-alpha.1/, së bashku me çelësin publik të versionit. Ruajeni çelësin si release.pub. Kapitulli 2.4, Marrja dhe verifikimi i një versioni, shpjegon se si të kontrolloni gjurmën (fingerprint) e çelësit kundrejt asaj që publikon Adverant.
  2. Kontrolloni skedarin binar dhe versionin me çelësin:
nexusctl version --json
nexusctl verify

nexusctl verify kontrollon shkarkimin kundrejt çelësit të versionit të Adverant dhe refuzon çdo gjë që nuk mund ta verifikojë. Nëse dështon, ndaloni dhe shkarkojeni përsëri. Kurrë mos ekzekutoni një instalim nga një skedar që nuk është verifikuar.

Krijoni çelësin e kujdestarit

Depoja e çelësave e instalimit i vulos çelësat e saj të rikuperimit te një ose më shumë kujdestarë (custodians). Një kujdestar është një person që mban një skedar identiteti age jashtë linje (offline), dhe paketa refuzon të instalohet pa të paktën një të tillë. Në pajisjen e vetë kujdestarit:

age-keygen -o custodian.key

Skedari fillon me një rresht # public key: age1.... Ajo gjysmë publike është ajo që hyn në skedarin e vlerave (values file). Vetë skedari i identitetit nuk largohet kurrë nga pajisja e kujdestarit. Në një Mac me një Secure Enclave, age-plugin-se keygen --access-control=any-biometry -o custodian.key krijon një çelës që kërkon Touch ID për t'u përdorur, dhe gjysma e tij publike fillon me age1se1.

Shkruani skedarin e vlerave

# harrow-pilot-values.yaml (Helm values)
global:
  imageRegistry: registry.adverant.ai
  domain: harrow.example
hosts:
  console: console.harrow.example
  api: api.harrow.example
  auth: auth.harrow.example
edition: community
enterprise:
  enabled: false
tls:
  mode: existing
  existingSecret: harrow-public-tls
keys:
  installationName: harrow-pilot
  custody:
    recipients:
      - "<custodian-age-recipient>"

<custodian-age-recipient> është rreshti age1... nga custodian.key. Shtoni një hyrje në listë për çdo kujdestar.

keys.installationName është i përhershëm. Nisja e parë e depos së çelësave krijon identitetin e instalimit nën atë emër, dhe asgjë nuk e riemërton atë më pas. Ai duhet të përputhet me ^[a-z][a-z0-9-]{0,62}$: shkronja të vogla, duke filluar me një shkronjë, më së shumti 63 karaktere. Mos kopjoni nexus-example ose marrësin (recipient) shembull nga skedarët shembull të vetë paketës. Paketa i refuzon të dyja me emër, dhe kontrolli paraprak (preflight) raporton të njëjtat kode që në fillim.

Tre host-et janë identiteti i instalimit. Çdo shërbim refuzon të niset pa to, dhe çdo identifikim, cookie dhe çelës kalimi (passkey) është i lidhur me hosts.console. Zgjidhni emra që do t'i dëshironi ende pas pesë vjetësh.

Drejtoni tre emrat te serveri

Njerëzit arrijnë te konsola, API (ndërfaqja e programimit të aplikacioneve) dhe shërbimi i identifikimit përmes kontrolluesit të brendshëm ingress të k3s, Traefik, në portat 80 dhe 443 të serverit. Shtoni tre rekorde DNS (Sistemi i Emrave të Domenit) për console.harrow.example, api.harrow.example dhe auth.harrow.example, secili duke treguar adresën e serverit. Kontrolli paraprak (preflight) kontrollon çdo emër dhe ju tregon se cili prej tyre nuk ka rekord.

Politika e rrjetit e paketës lejon vetëm një namespace të arrijë te tre shërbimet publike. Vlera e saj e paracaktuar, kube-system, është vendi ku k3s ekzekuton Traefik, kështu që në një nyje të vetme ju nuk e prekni networkPolicy.ingressNamespace.

Ekzekutoni kontrollin paraprak, më pas instaloni

  1. Ekzekutoni kontrollin paraprak (preflight) me flamurin (flag) për një nyje të vetme. Ai lexon pajisjen dhe skedarin tuaj të vlerave dhe nuk ndryshon asgjë.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Lexoni rreshtin përmbledhës në fund. Një paralajmërim nuk e bllokon kurrë instalimin, por një dështim po, dhe çdo rresht që dështon mbart një rresht fix.
 ────────────────────────────────────────────────────────────
 9 passed · 1 warning · 0 failed   You can install. Warnings do not block; fix them when you can.
 Report saved to preflight-2026-11-12-0902.txt · nothing was changed
  1. Instaloni. Flamuri --edition duhet të përputhet me edition në skedarin e vlerave.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Ndiqeni teksa ekzekutohet. Ai ekzekuton sërish kontrollin paraprak, instalon k3s v1.33.6+k3s1, instalon cert-manager v1.21.3, instalon Nexus dhe pret që çdo shërbim t'i përgjigjet kontrollit të tij të gjendjes (health check). Në serverin e Tomás-it kjo zgjati pak më pak se dhjetë minuta.
 done   Preflight again        9 passed · 1 warning
 done   k3s v1.33.6+k3s1       node Ready
 done   cert-manager v1.21.3   ready
 done   Database and search    ready
 done   Engines                started
 done   Console                https://console.harrow.example
 Installed. Nobody can sign in yet.
 Open https://console.harrow.example/claim
 Code <code>  works once, for 30 minutes
 Fingerprint of this installation, to compare in the browser:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

Mbajeni atë gjurmë (fingerprint) në ekran. Do ta krahasoni atë në shfletues kur të merrni në pronësi (claim) instalimin me kodin. Nëse kodi skadon përpara se ta përdorni, nexusctl claim-code --administrator <email> krijon një të ri. Kapitulli 2.12, Ekzekutimi i parë, vazhdon që aty.

Instaloni edicionin Community
Instaloni edicionin Community
Instalimi i edicionit Community në një server përbëhet nga shkarkimi, kontrolli, kontrolli paraprak dhe instalimi, e më pas administratori i parë. Nuk ka asnjë hap licencimi.

Vendosni certifikatën në vend

Me tls.mode: existing, të tre rrugët ingress shërbejnë certifikatën në Secret-in e emërtuar nga tls.existingSecret. Ajo duhet të mbulojë të tre host-et. Kontrolli paraprak e lexon atë Secret kur ai ekziston dhe paralajmëron kur certifikata skadon brenda 30 ditëve. Kur Secret-i nuk është ende aty, rreshti ju thotë ta krijoni atë, dhe ky është një paralajmërim, jo një dështim.

Në një nyje të vetme klasteri nuk ekziston derisa instalimi ta ketë krijuar atë, prandaj krijojeni Secret-in menjëherë pas instalimit. Nxirrni fillimisht skedarin kubeconfig të klasterit (seksioni i fundit i këtij kapitulli e shpjegon këtë), më pas krijoni Secret-in me të:

sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.key

harrow-public.crt mban certifikatën të ndjekur nga çdo certifikatë e ndërmjetme, dhe harrow-public.key çelësin e saj privat. Nëse certifikatat tuaja vijnë nga një CA (autoritet certifikimi) privat, nexusctl preflight dhe nexusctl install marrin --ca-bundle <file> në mënyrë që të mund të kontrollojnë zinxhirin. Mënyrat e tjera për të trajtuar TLS (Siguria e Shtresës së Transportit) gjenden në kapitullin 2.11, Variacionet: depot e jashtme, TLS dhe ingress.

Nëse kjo dështon

Çfarë shihni Çfarë do të thotë Çfarë duhet të bëni
PREFLIGHT_FAILED (409) Kontrolli paraprak gjeti një dështim, prandaj instalimi nuk filloi. Asgjë nuk u instalua. Rregulloni çdo rresht që dështon, duke përdorur rreshtin e tij fix, dhe ekzekutoni instalimin përsëri.
INSTALLATION_NAME_MISSING keys.installationName është bosh. Vendosni emrin e përhershëm të vetë instalimit.
INSTALLATION_NAME_EXAMPLE Emri është ai nga vlerat shembull të paketës. Zgjidhni emrin tuaj.
KEYS_CUSTODIAN_MISSING keys.custody.recipients është bosh. Shtoni marrësin (recipient) publik age1... të çdo kujdestari.
KEYS_CUSTODIAN_EXAMPLE Një marrës është kujdestari shembull i paketës, identitetin e të cilit nuk e mban askush. Zëvendësojeni atë me marrësit e kujdestarëve tuaj.

nexusctl del me kodin 0 kur mund të vazhdojë përpara, 1 kur një kontroll e bllokoi atë, dhe 2 kur nuk mund të ekzekutohej fare (një skedar vlerash i palexueshëm, një flamur i gabuar). Një skript mund të degëzohet sipas këtyre të treve.

Pjesa e dytë: një vlerësim në laptop me k3d

k3d ekzekuton k3s brenda kontejnerëve Docker, kështu që një klaster i tërë jeton në një laptop dhe zhduket me një komandë të vetme. Mjetet e lëshimit (release tools) që testojnë çdo version të Nexus i ndërtojnë klasterët e tyre pikërisht në këtë mënyrë, dhe kopjimi i cilësimeve të tyre ju shpëton nga rizbulimi i problemeve që ata tashmë i kanë hasur.

Ju nevojiten Docker, k3d 5.8.3, kubectl, Helm v4 dhe Chrome. Tomás përdori Mac-un e tij.

Krijoni klasterin

k3d cluster create harrow-eval --agents 0 --wait --timeout 300s \
  --image rancher/k3s:v1.33.6-k3s1 \
  --k3s-arg "--disable=traefik@server:0"
k3d kubeconfig get harrow-eval > harrow-eval.kubeconfig
chmod 600 harrow-eval.kubeconfig
export KUBECONFIG=$PWD/harrow-eval.kubeconfig

Çdo flamur (flag) ka një arsye.

  • --agents 0 jep një nyje serveri dhe asnjë nyje punëtore (workers). Nexus punon pa problem në një nyje, dhe një e dytë vetëm sa harxhon memorie.
  • --image rancher/k3s:v1.33.6-k3s1 fikson versionin e k3s në të cilin testohet çdo version. Pa të, ju merrni çfarëdo versioni që k3d ka si të paracaktuar.
  • --disable=traefik@server:0 lë jashtë Traefik. Një laptop nuk ka adresë publike për të shërbyer, dhe në vend të kësaj ju arrini te konsola përmes ballinës (front) suaj HTTPS (më poshtë).
  • --wait --timeout 300s kthehet vetëm kur klasteri përgjigjet, ose dështon pas pesë minutash.

Nëse e pasqyroni (mirror) regjistrin e versioneve në laptopin tuaj, shtoni --registry-config <registries.yaml> për të dërguar tërheqjet e imazheve te pasqyra (mirror), dhe --k3s-arg "--disable-default-registry-endpoint@server:0" në mënyrë që asgjë të mos kthehet te një regjistër kryesor (upstream). Mjetet e lëshimit funksionojnë në këtë mënyrë, ku çdo imazh vjen vetëm përmes pasqyrës.

Instaloni cert-manager

Paketa krijon CA-në e saj lokale, nexus-local-ca, si një lëshues (issuer) cert-manager, dhe çdo shërbim e merr certifikatën e tij prej saj. Pa burimet e cert-manager në klaster, helm install e refuzon paketën brenda pak sekondash. Instaloni fillimisht cert-manager v1.21.3, nga paketa që publikon projekti cert-manager:

helm install cert-manager cert-manager-v1.21.3.tgz -n cert-manager \
  --create-namespace --set crds.enabled=true --wait --timeout 10m

Nexus nuk ka nevojë për asgjë tjetër nga cert-manager, dhe në veçanti për asnjë trust-manager.

Instaloni Nexus

  1. Shkruani një skedar vlerash për laptopin. TLS përfundon në ballinën (front) tuaj, kështu që tls.mode është none.
# harrow-eval-values.yaml (Helm values)
global:
  imageRegistry: registry.adverant.ai
  domain: harrow.example
hosts:
  console: console.harrow.example
  api: api.harrow.example
  auth: auth.harrow.example
edition: community
tls:
  mode: none
keys:
  installationName: harrow-eval
  custody:
    recipients:
      - "<custodian-age-recipient>"
  1. Instaloni paketën nga regjistri dhe lini jashtë --wait (paralajmërimi më poshtë tregon pse).
helm install nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
  -n nexus --create-namespace -f harrow-eval-values.yaml --timeout 45m
  1. Më pas prisni vetë për ngarkesat e punës (workloads):
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
for s in $(kubectl -n nexus get sts -o name); do
  want=$(kubectl -n nexus get "$s" -o jsonpath='{.spec.replicas}')
  kubectl -n nexus wait "$s" --for=jsonpath='{.status.readyReplicas}'="$want" --timeout=900s
done

Cikli StatefulSet është aty sepse disa prej tyre përditësojnë një pod në të njëjtën kohë sipas kërkesës, dhe kubectl rollout status i refuzon ato. Pritja në readyReplicas funksionon për çdo strategji përditësimi.

Kur të dyja komandat përfundojnë, çdo Deployment është Available (I disponueshëm) dhe çdo StatefulSet i ka pod-et e tij gati. Askush nuk mund të identifikohet ende. Kjo është e saktë: instalimi është ende i pamarrë në pronësi (unclaimed).

Pse një përcjellje porte (port-forward) nuk mund t'ju identifikojë kurrë

Lëvizja tjetër e dukshme është kubectl port-forward svc/nexus-alpha 3000:3000 dhe një shfletues në http://127.0.0.1:3000. Faqet e konsolës ngarkohen, kështu që duket sikur funksionon. Nuk funksionon, dhe asnjë cilësim nuk do ta bëjë të funksionojë. Tre gjëra pengojnë, secila qëllimisht.

Çfarë e ndalon atë Pse
Origjina Identifikimi i konsolës refuzon një kërkesë origjina e së cilës nuk është https://<hosts.console>, këtu https://console.harrow.example. Një faqe e shërbyer nga http://127.0.0.1:3000 ka origjinën e gabuar, kështu që identifikimi nuk fillon kurrë.
Cookie Sesioni është një cookie __Host- e shënuar Secure. Shfletuesit e ruajnë një cookie të tillë vetëm përmes HTTPS, pa atribut domeni, saktësisht për host-in që e ka vendosur atë. Përmes HTTP të thjeshtë shfletuesi e hedh poshtë atë.
Çelësi i kalimit (passkey) Administratori i parë identifikohet me një çelës kalimi (passkey), dhe një çelës kalimi ka nevojë për një kontekst të sigurt me një certifikatë të vlefshme. Chrome refuzon të krijojë një çelës kalimi pas një paralajmërimi certifikate, madje edhe kur keni klikuar për ta anashkaluar.

Pra, shfletuesi duhet të komunikojë me https://console.harrow.example, me një certifikatë që ai i beson, dhe ai emër duhet të të çojë te laptopi juaj.

Qasja në konsolë përmes HTTPS në laptopin tuaj

Metoda më poshtë përdor CA-në e vetë paketës për të lëshuar certifikatën, një port-forward për të arritur te konsola, dhe një profil të veçantë Chrome që i beson asaj CA-je të vetme dhe e lidh emrin e konsolës me laptopin tuaj. Depoja e besimit të sistemit tuaj dhe /etc/hosts mbeten siç janë.

Diagrami tregon Chrome në të majtë, të etiketuar "profil i veçantë: i beson vetëm nexus-local-ca; console.harrow.example:443 i lidhur me 127.0.0.1:28443". Një shigjetë e etiketuar "HTTPS" shkon te një kuti "ballinë HTTPS në 127.0.0.1:28443 (certifikatë nga nexus-local-ca)". Një shigjetë e etiketuar "HTTP, Host i ruajtur, X-Forwarded-Proto https" shkon te "kubectl port-forward 127.0.0.1:3000", dhe një shigjetë e fundit hyn në kutinë e klasterit k3d te "Service nexus-alpha, porta http (3000)". Një vijë me pika nga cert-manager brenda klasterit te kutia e ballinës është e etiketuar "lëshon certifikatën".
Si arrin një shfletues në laptop te konsola në klasterin k3d përmes HTTPS.

Lëshoni një certifikatë për emrin e konsolës

  1. Kërkojini cert-manager një certifikatë për host-in e konsolës, të nënshkruar nga lëshuesi (issuer) i paketës:
# console-front-certificate.yaml (a cert-manager Certificate)
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: nexus-console-front
  namespace: nexus
spec:
  secretName: nexus-console-front-tls
  dnsNames: [console.harrow.example]
  duration: 24h
  usages: [server auth, digital signature, key encipherment]
  privateKey: { algorithm: ECDSA, size: 256, rotationPolicy: Always }
  issuerRef: { name: nexus-local-ca, kind: Issuer, group: cert-manager.io }
kubectl apply -f console-front-certificate.yaml
kubectl -n nexus wait --for=condition=Ready certificate/nexus-console-front --timeout=120s

cert-manager e nënshkruan atë brenda klasterit. Ju nuk e lexoni kurrë çelësin privat të CA-së.

  1. Kopjoni certifikatën, çelësin e saj dhe certifikatën e CA-së jashtë nga Secret-i:
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.tls\.crt}' | base64 -d > tls.crt
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.tls\.key}' | base64 -d > tls.key
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.ca\.crt}' | base64 -d > ca.crt
chmod 600 tls.key
  1. Gjeni pin-in e CA-së. Chrome identifikon një çelës të besuar nga vlera base64 SHA-256 e çelësit të tij publik:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Fiksoni (pin) çelësin e CA-së, jo të certifikatës. Certifikata zgjat një ditë dhe merr një çelës të ri sa herë që cert-manager e rinovon atë, ndërsa CA-ja mbetet e njëjtë.

Vendosni një ballinë HTTPS përpara një port-forward

  1. Përcillni (forward) Service-in e konsolës. Porta e tij është ajo e emërtuar http, e cila është 3000 në këtë version:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Ekzekutoni një dëgjues (listener) HTTPS në 127.0.0.1:28443 që përcjell te 127.0.0.1:3000. Çdo reverse proxy që ju tashmë i besoni do të bëjë punë, për sa kohë që bën katër gjëra:
    • shërben tls.crt të ndjekur nga ca.crt si zinxhir, me tls.key;
    • mban kokën (header) Host si console.harrow.example;
    • vendos X-Forwarded-Proto: https;
    • kalon përmirësimet (upgrades) e WebSocket përmes tij, sepse konsola i përdor ato.

Një port-forward te një Service lidhet me atë pod të vetëm që zgjodhi kur u nis. Pasi një përmirësim (upgrade) ose një rinisje zëvendëson pod-in e konsolës, përcjellja (forward) mbetet aktive dhe nuk përcjell askund, dhe shfletuesi shfaq një gabim "bad gateway". Rinisni port-forward sa herë që ndryshon pod-i i konsolës.

Hapni Chrome me pin-in dhe lidhjen e emrit

Në një Mac:

open -na "Google Chrome" --args --user-data-dir="$HOME/.nexus-eval-chrome" \
  "--host-resolver-rules=MAP console.harrow.example:443 127.0.0.1:28443" \
  "--ignore-certificate-errors-spki-list=<ca-pin>" \
  https://console.harrow.example/install

<ca-pin> është rezultati i rreshtit openssl. Në Linux, nisni Chrome me të njëjtët tre flamuj (flags).

Të tre flamujt punojnë së bashku. --host-resolver-rules dërgon console.harrow.example në portën 443 te ballina juaj, vetëm brenda këtij profili. --ignore-certificate-errors-spki-list u beson certifikatave të lëshuara nga ai çelës i vetëm CA, dhe Chrome e respekton atë vetëm me --user-data-dir. Profili i veçantë e mban përjashtimin larg nga shfletimi juaj i përditshëm. Ai nuk është një çelës i përgjithshëm "injoro gabimet e certifikatave": çdo gjë që nuk është nënshkruar nga CA-ja e klasterit përsëri dështon.

Me atë profil të hapur, https://console.harrow.example/install të çon te faqja e marrjes në pronësi (claim), dhe mund të krijohet një çelës kalimi (passkey). Kapitulli 2.12, Ekzekutimi i parë, vazhdon që këtu.

Kur laptopi riniset

Depoja e çelësave ka dy pjesë: vetë depon e çelësave dhe një hapës (unsealer) të vogël që mban çelësin e saj të zhbllokimit. Pas çdo rinisjeje të nyjës (një rinisje e Docker, një rinisje e laptopit, k3d cluster stop dhe start) hapësi niset i vulosur (sealed). Depoja e çelësave hapet vetë përmes tij, kështu që derisa një kujdestar ta hapë hapësin me identitetin e tij age, asgjë që ka nevojë për një çelës nuk funksionon. Kjo është një veti e dizajnit, dhe është e njëjtë në një klaster prodhimi. Kapitulli 2.15, Dita e dytë: operimi i Nexus, tregon procesin e hapjes (unseal).

Kur të keni mbaruar me vlerësimin:

k3d cluster delete harrow-eval

Fshirja e klasterit fshin instalimin dhe gjithçka në të.

nexusctl kubeconfig

Një klaster që ka ndërtuar nexusctl install --single-node i përket nexusctl. Për të arritur tek ai me kubectl, helm ose çdo mjet tjetër, kërkoni skedarin e tij kubeconfig:

sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus get deploy,statefulset

Skedari jep qasje të plotë administrative në klaster. Mbajeni atë në mënyrën (mode) 600, në pajisjet e personave që drejtojnë instalimin, dhe askund tjetër. Çdo komandë e mëvonshme në Pjesën 2 që merr --context ose lexon KUBECONFIG funksionon kundrejt një nyjeje të vetme përmes këtij skedari. E njëjta gjë vlen edhe për një përmirësim (upgrade): nexusctl upgrade plan --bundle <file> dhe nexusctl upgrade apply --bundle <file> në një nyje të vetme përmirësojnë gjithashtu klasterin k3s që zotëron nexusctl.

Diagrami është një stivë me katër shtresa mbi një kuti të etiketuar "një server Linux". Nga fundi: "k3s v1.33.6+k3s1 (Traefik në kube-system, portat 80 dhe 443)", më pas "cert-manager v1.21.3 dhe CA-ja lokale e paketës nexus-local-ca", më pas "Shtresa e të dhënave Nexus: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao", më pas "Shërbimet Nexus: konsola, identifikimi, gateway dhe pjesa tjetër". Në të djathtë, tre shigjeta nga shtresa e sipërme dalin nga kutia të etiketuara console.harrow.example, api.harrow.example dhe auth.harrow.example. Në të majtë, një ikonë terminali e etiketuar "nexusctl kubeconfig" tregon drejt shtresës k3s.
Çfarë vendos nexusctl install --single-node në një server Linux.

Çfarë bartet në një klaster

Gjithçka që bëtë në një pajisje ka një ekuivalent në një klaster. Skedari i vlerave është i njëjti skedar me një regjistër tjetër, mënyrë tjetër TLS ose klasë tjetër ruajtjeje (storage class), siç tregon kapitulli 2.11, Variacionet: depot e jashtme, TLS dhe ingress. Ekzekutimi i parë është identik. Ajo që nuk bartet është vetë instalimi: emri i instalimit është i fiksuar përgjithmonë, dhe një instalim nuk mund të zhvendoset nga një laptop në një server. Kur Tomás kaloi nga laptopi i tij në serverin pilot, ai filloi nga e para me një emër të ri, harrow-pilot, dhe mbajti harrow-eval për eksperimente.