PrijavaRezervirajte predstavitev

Poglavje 2.8

Namestitve na en sam stroj

Namestite Nexus na en strežnik Linux z orodjem nexusctl ali ga preizkusite na prenosniku z orodjem k3d ter dostopajte do konzole prek protokola HTTPS, da bosta delovala prijava in potrditev s ključi (passkeys).

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

18 min branja

Preden je Harrow Port Authority postavil Nexus na svojo produkcijsko gručo, je Tomás Reilly želel dve manjši namestitvi. Ena je bila pilotna na rezervnem strežniku Linux v operativni stavbi, namenjena dvanajstim osebam, ki naj bi ga preizkusile prve. Druga je tekla na njegovem lastnem prenosniku, da je lahko kvaril stvari, ne da bi kdo opazil. To poglavje obravnava obe. Uporabljata isti chart, iste slike in isti prvi zagon kot polna namestitev v okolju Kubernetes, zato se znanje, pridobljeno na enem stroju, prenese naprej.

Strežniška pot obsega en sam ukaz: nexusctl install --single-node zgradi gručo k3s na stroju, namesti cert-manager in nato namesti Nexus. Pot na prenosniku zahteva več ročnega dela. Sami zgradite gručo k3d, z orodjem Helm namestite cert-manager in chart, nato pa opravite še eno dodatno nalogo, na kateri se spotakne skoraj vsak: konzolo na svojem stroju postavite za HTTPS, saj navadno posredovanje vrat (port-forward) nikogar ne more prijaviti.

Kako zmogljiv mora biti stroj

Nexus ob privzetih nastavitvah charta zahteva približno 2.05 jedra CPU (centralne procesne enote) in 6.7 GiB pomnilnika v zahtevkih (requests), njegovi nosilci podatkov (volumes) pa skupaj znašajo 142 GiB. Ta vsota obsega PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, objektno shrambo 50, dve shrambi OpenBao 1 in 5 ter nosilec za potrdila (receipts) 1. Zahtevki predstavljajo tisto, kar razporejevalnik rezervira, dejanska poraba pa je višja, ko ljudje začnejo delati.

Stroj CPU Pomnilnik (RAM, bralno-pisalni pomnilnik) Disk
Priporočeno posamezno vozlišče 8 vCPU 32 GiB 250 GB SSD (pogon v trdnem stanju)
Minimum za preizkus 4 vCPU 16 GiB 200 GB

Prenosnik, ki dosega minimum za preizkus, bo poganjal Nexus, vendar šteje lastna omejitev pomnilnika za Docker, ne omejitev prenosnika. Pred začetkom dodelite okolju Docker vsaj 16 GiB.

Obe poti potrebujeta Kubernetes 1.33 ali novejši. Pot za posamezno vozlišče prinese svojega: k3s v1.33.6+k3s1, distribucijo, na kateri je preizkušena vsaka izdaja.

Prvi del: en strežnik Linux z orodjem nexusctl

Tomásov pilotni strežnik je 8-jedrni stroj z 32 GiB pomnilnika in pogonom 500 GB SSD, na katerem teče sodoben Linux brez česar koli drugega. Namestitev potrebuje skrbniške pravice (root), ker namesti k3s kot sistemsko storitev.

Pridobite nexusctl in ga preverite

  1. Prenesite nexusctl za svojo arhitekturo s https://downloads.adverant.ai/nexus/1.0.0-alpha.1/, skupaj z javnim ključem izdaje. Ključ shranite kot release.pub. Poglavje 2.4, Pridobivanje in preverjanje izdaje, pojasnjuje, kako preveriti prstni odtis ključa glede na tistega, ki ga objavi Adverant.
  2. Preverite binarno datoteko in izdajo s ključem:
nexusctl version --json
nexusctl verify

nexusctl verify preveri prenos glede na ključ izdaje Adverant in zavrne vse, česar ne more potrditi. Če preverjanje ne uspe, se ustavite in datoteko prenesite znova. Nikoli ne zaženite namestitve iz datoteke, ki ni prestala preverjanja.

Ustvarite skrbniški ključ (custodian key)

Shramba ključev namestitve zapečati svoje obnovitvene ključe za enega ali več skrbnikov ključev (custodians). Skrbnik ključev je oseba, ki zunaj omrežja hrani datoteko z identiteto age, in chart zavrne namestitev, če ni določen vsaj eden. Na stroju samega skrbnika ključev:

age-keygen -o custodian.key

Datoteka se začne z vrstico # public key: age1.... Ta javna polovica je tisto, kar gre v datoteko z vrednostmi (values file). Sama datoteka z identiteto nikoli ne zapusti stroja skrbnika ključev. Na računalniku Mac z varnostnim čipom Secure Enclave ukaz age-plugin-se keygen --access-control=any-biometry -o custodian.key ustvari ključ, ki za uporabo zahteva Touch ID, njegova javna polovica pa se začne z age1se1.

Zapišite datoteko z vrednostmi

# 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> je vrstica age1... iz custodian.key. Dodajte en vnos na seznam za vsakega skrbnika ključev.

keys.installationName je trajen. Prvi zagon shrambe ključev ustvari identiteto namestitve pod tem imenom in nič je pozneje ne more preimenovati. Ujemati se mora z vzorcem ^[a-z][a-z0-9-]{0,62}$: male črke, začetek s črko, največ 63 znakov. Ne kopirajte nexus-example ali primeroma navedenega prejemnika iz vzorčnih datotek samega charta. Chart oba poimensko zavrne, predhodno preverjanje (preflight) pa najprej javi iste kode.

Trije gostitelji predstavljajo identiteto namestitve. Vsaka storitev brez njih zavrne zagon in vsaka prijava, piškotek ter pristopni ključ (passkey) so vezani na hosts.console. Izberite imena, ki jih boste želeli uporabljati tudi čez pet let.

Usmerite tri imena na strežnik

Uporabniki dostopajo do konzole, vmesnika API (aplikacijskega programskega vmesnika) in prijavne storitve prek vgrajenega vstopnega krmilnika (ingress controller) v k3s, imenovanega Traefik, na vratih 80 in 443 strežnika. Dodajte tri zapise DNS (sistem domenskih imen) za console.harrow.example, api.harrow.example in auth.harrow.example, pri čemer naj vsak kaže na naslov strežnika. Predhodno preverjanje (preflight) preveri vsako ime in vam pove, katero nima zapisa.

Omrežni pravilnik charta dovoljuje dostop do treh javnih storitev samo enemu imenskemu prostoru (namespace). Njegova privzeta vrednost, kube-system, je mesto, kjer k3s poganja Traefik, zato na posameznem vozlišču pustite networkPolicy.ingressNamespace pri miru.

Zaženite predhodno preverjanje, nato namestite

  1. Zaženite predhodno preverjanje z zastavico za posamezno vozlišče. Prebere stroj in vašo datoteko z vrednostmi ter ničesar ne spremeni.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Preberite vrstico s povzetkom na koncu. Opozorilo nikoli ne ustavi namestitve, napaka pa jo, in vsaka neuspešna vrstica vsebuje vrstico 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. Namestite. Zastavica --edition se mora ujemati z edition v datoteki z vrednostmi.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Opazujte izvajanje. Znova zažene predhodno preverjanje, namesti k3s v1.33.6+k3s1, namesti cert-manager v1.21.3, namesti Nexus in počaka, da vsaka storitev odgovori na preverjanje stanja (health check). Na Tomásovem strežniku je to trajalo nekaj manj kot deset minut.
 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

Ta prstni odtis obdržite na zaslonu. Primerjali ga boste v brskalniku, ko boste s kodo prevzeli namestitev. Če koda poteče, preden jo uporabite, nexusctl claim-code --administrator <email> ustvari novo. Od tu naprej nadaljuje poglavje 2.12, Prvi zagon.

Namestitev izdaje Community
Namestitev izdaje Community
Namestitev izdaje Community na enem strežniku obsega prenos, preverjanje, predhodno preverjanje in namestitev, čemur sledi prvi skrbnik. Koraka z licenco ni.

Namestite potrdilo na ustrezno mesto

Pri tls.mode: existing tri vstopne poti (ingress routes) strežejo potrdilo v objektu Secret, ki ga imenuje tls.existingSecret. Pokrivati mora vse tri gostitelje. Predhodno preverjanje prebere ta Secret, kadar obstaja, in opozori, če potrdilo poteče v 30 dneh. Kadar objekta Secret še ni tam, vam vrstica naroči, da ga ustvarite, kar je opozorilo in ne napaka.

Na posameznem vozlišču gruča ne obstaja, dokler je namestitev ne ustvari, zato ustvarite Secret takoj po namestitvi. Najprej izpišite kubeconfig gruče (to pojasnjuje zadnji razdelek tega poglavja), nato pa z njim ustvarite Secret:

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 hrani potrdilo, ki mu sledijo morebitna vmesna potrdila, harrow-public.key pa njegov zasebni ključ. Če vaša potrdila izhajajo iz zasebnega CA (overitelja potrdil), nexusctl preflight in nexusctl install sprejmeta --ca-bundle <file>, da lahko preverita verigo. Drugi načini za obravnavo protokola TLS (Transport Layer Security) so opisani v poglavju 2.11, Različice: zunanje shrambe, TLS in vstopni promet (ingress).

Če to ne uspe

Kaj vidite Kaj pomeni Kaj storiti
PREFLIGHT_FAILED (409) Predhodno preverjanje je odkrilo napako, zato se namestitev ni začela. Nič ni bilo nameščeno. Popravite vsako neuspešno vrstico s pomočjo njene vrstice fix in znova zaženite namestitev.
INSTALLATION_NAME_MISSING keys.installationName je prazen. Nastavite lastno trajno ime namestitve.
INSTALLATION_NAME_EXAMPLE Ime je tisto iz vzorčnih vrednosti charta. Izberite svoje ime.
KEYS_CUSTODIAN_MISSING keys.custody.recipients je prazen. Dodajte javnega prejemnika age1... za vsakega skrbnika ključev.
KEYS_CUSTODIAN_EXAMPLE Prejemnik je vzorčni skrbnik ključev iz charta, čigar identitete nima nihče. Zamenjajte ga s prejemniki svojih skrbnikov ključev.

nexusctl se zaključi s kodo 0, ko lahko nadaljuje, 1, ko ga je preverjanje ustavilo, in 2, ko se sploh ni mogel zagnati (neberljiva datoteka z vrednostmi, napačna zastavica). Skripta se lahko razveji glede na te tri vrednosti.

Drugi del: preizkus na prenosniku z orodjem k3d

k3d poganja k3s znotraj vsebnikov Docker, tako da celotna gruča živi na prenosniku in izgine z enim samim ukazom. Orodja za izdajo, ki preizkušajo vsako izdajo sistema Nexus, gradijo svoje gruče natanko na ta način, in s kopiranjem njihovih nastavitev se izognete ponovnemu odkrivanju težav, na katere so že naletela.

Potrebujete Docker, k3d 5.8.3, kubectl, Helm v4 in Chrome. Tomás je uporabil svoj Mac.

Ustvarite gručo

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

Vsaka zastavica ima svoj namen.

  • --agents 0 zagotovi eno strežniško vozlišče in nobenega delovnega vozlišča (worker). Nexus brez težav teče na enem vozlišču, drugo pa le porablja pomnilnik.
  • --image rancher/k3s:v1.33.6-k3s1 fiksira različico k3s, na kateri je preizkušena vsaka izdaja. Brez tega dobite tisto, kar k3d določi privzeto.
  • --disable=traefik@server:0 izpusti Traefik. Prenosnik nima javnega naslova, na katerem bi stregel, do konzole pa namesto tega dostopate prek lastnega pročelja HTTPS (spodaj).
  • --wait --timeout 300s se vrne šele, ko se gruča odzove, ali pa spodleti po petih minutah.

Če na prenosniku zrcalite register izdaj, dodajte --registry-config <registries.yaml>, da prenose slik usmerite na zrcalo, in --k3s-arg "--disable-default-registry-endpoint@server:0", da nič ne preklopi nazaj na izvorni register. Orodja za izdajo delujejo na ta način, pri čemer vsaka slika pride izključno prek zrcala.

Namestite cert-manager

Chart ustvari lastnega lokalnega overitelja potrdil (CA), nexus-local-ca, kot izdajatelja v okviru cert-manager, in vsaka storitev dobi svoje potrdilo od njega. Brez virov cert-manager v gruči helm install v nekaj sekundah zavrne chart. Najprej namestite cert-manager v1.21.3 iz charta, ki ga objavlja projekt 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 od komponente cert-manager ne potrebuje ničesar drugega, še posebej pa ne komponente trust-manager.

Namestite Nexus

  1. Zapišite datoteko z vrednostmi za prenosnik. TLS se zaključi na vašem lastnem pročelju, zato je tls.mode nastavljen na 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. Namestite chart iz registra in izpustite --wait (spodnje opozorilo pojasnjuje, zakaj).
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. Nato sami počakajte na delovne obremenitve (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

Zanka za StatefulSet je tam zato, ker se nekateri izmed njih posodabljajo po en pod naenkrat na zahtevo, kubectl rollout status pa takšne zavrne. Čakanje na readyReplicas deluje za vsako strategijo posodabljanja.

Ko se oba ukaza zaključita, ima vsak Deployment stanje Available in vsak StatefulSet ima svoje pode pripravljene. Nihče se še ne more prijaviti. To je pravilno: namestitev še ni prevzeta.

Zakaj se s posredovanjem vrat (port-forward) nikoli ne morete prijaviti

Očitna naslednja poteza je kubectl port-forward svc/nexus-alpha 3000:3000 in brskalnik na naslovu http://127.0.0.1:3000. Strani konzole se naložijo, zato je videti, kot da deluje. Pa ne deluje, in nobena nastavitev tega ne bo spremenila. Na poti stojijo tri stvari, vsaka z namenom.

Kaj to preprečuje Zakaj
Izvor (origin) Prijava v konzolo zavrne zahtevo, katere izvor ni https://<hosts.console>, v tem primeru https://console.harrow.example. Stran, postrežena z naslova http://127.0.0.1:3000, ima napačen izvor, zato se prijava sploh ne začne.
Piškotek Seja je piškotek __Host-, označen kot Secure. Brskalniki takšen piškotek shranijo samo prek protokola HTTPS, brez atributa domene, natanko za tistega gostitelja, ki ga je nastavil. Prek navadnega protokola HTTP ga brskalnik zavrže.
Pristopni ključ (passkey) Prvi skrbnik se prijavi s pristopnim ključem, pristopni ključ pa potrebuje varen kontekst z veljavnim potrdilom. Chrome zavrne ustvarjanje pristopnega ključa za opozorilom o potrdilu, četudi ste kliknili za nadaljevanje mimo njega.

Brskalnik mora torej komunicirati z https://console.harrow.example, s potrdilom, ki mu zaupa, to ime pa mora voditi do vašega prenosnika.

Dostop do konzole prek protokola HTTPS na prenosniku

Spodnja metoda uporablja lastnega overitelja (CA) iz charta za izdajo potrdila, posredovanje vrat za dosego konzole in ločen profil v brskalniku Chrome, ki zaupa temu enemu overitelju (CA) ter preslika ime konzole na vaš prenosnik. Vaša sistemska shramba zaupanja in /etc/hosts ostaneta nespremenjena.

Diagram prikazuje Chrome na levi z oznako »ločen profil: zaupa samo nexus-local-ca; console.harrow.example:443 preslikan na 127.0.0.1:28443«. Puščica z oznako »HTTPS« vodi do okvira »pročelje HTTPS na 127.0.0.1:28443 (potrdilo od nexus-local-ca)«. Puščica z oznako »HTTP, Host ohranjen, X-Forwarded-Proto https« vodi do »kubectl port-forward 127.0.0.1:3000«, zadnja puščica pa gre v okvir gruče k3d do »Service nexus-alpha, vrata http (3000)«. Črtkana črta od komponente cert-manager znotraj gruče do okvira pročelja nosi oznako »izda potrdilo«.
Kako brskalnik na prenosniku doseže konzolo v gruči k3d prek protokola HTTPS.

Izdajte potrdilo za ime konzole

  1. Zahtevajte od komponente cert-manager potrdilo za gostitelja konzole, podpisano s strani izdajatelja charta:
# 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 ga podpiše znotraj gruče. Zasebnega ključa overitelja (CA) nikoli ne preberete.

  1. Kopirajte potrdilo, njegov ključ in potrdilo CA iz objekta Secret:
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. Izračunajte priponko (pin) overitelja (CA). Chrome prepozna zaupanja vreden ključ po vrednosti base64 SHA-256 njegovega javnega ključa:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Pripnite ključ overitelja (CA), ne ključa potrdila. Potrdilo velja en dan in dobi nov ključ vsakič, ko ga cert-manager obnovi, medtem ko CA ostane enak.

Postavite pročelje HTTPS pred posredovanje vrat

  1. Posredujte Service konzole. Njegova vrata so tista z imenom http, kar je v tej izdaji 3000:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Zaženite poslušalnik HTTPS na 127.0.0.1:28443, ki posreduje promet na 127.0.0.1:3000. Zadoščal bo kateri koli obratni posredniški strežnik (reverse proxy), ki mu že zaupate, če le opravi štiri stvari:
    • streže tls.crt, ki mu sledi ca.crt kot veriga, s ključem tls.key;
    • ohrani glavo Host kot console.harrow.example;
    • nastavi X-Forwarded-Proto: https;
    • prepusti nadgradnje WebSocket skozi, ker jih konzola uporablja.

Posredovanje vrat na Service se veže na tisti en pod, ki ga je izbralo ob zagonu. Ko nadgradnja ali ponovni zagon zamenja pod konzole, posredovanje ostane aktivno in ne posreduje nikamor, brskalnik pa prikaže napako prehoda (bad gateway). Znova zaženite posredovanje vrat vsakič, ko se pod konzole spremeni.

Odprite Chrome s priponko in preslikavo imena

Na računalniku 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> je izpis vrstice openssl. V sistemu Linux zaženite Chrome z istimi tremi zastavicami.

Te tri zastavice delujejo skupaj. --host-resolver-rules pošlje console.harrow.example na vratih 443 na vaše pročelje, samo znotraj tega profila. --ignore-certificate-errors-spki-list zaupa potrdilom, ki jih je izdal ta en ključ CA, Chrome pa to upošteva le ob prisotnosti --user-data-dir. Ločen profil ohranja izjemo stran od vašega vsakodnevnega brskanja. To ni splošno stikalo za »prezri napake potrdil«: vse, česar ni podpisal CA gruče, še vedno spodleti.

Ko je ta profil odprt, https://console.harrow.example/install vodi na stran za prevzem in mogoče je ustvariti pristopni ključ. Od tu naprej nadaljuje poglavje 2.12, Prvi zagon.

Ko se prenosnik znova zažene

Shramba ključev ima dva dela: samo shrambo ključev in majhen odpečatenjevalnik (unsealer), ki hrani njen ključ za odklepanje. Po vsakem ponovnem zagonu vozlišča (ponovni zagon okolja Docker, ponovni zagon prenosnika, k3d cluster stop in start) se odpečatenjevalnik zažene v zapečatenem stanju. Shramba ključev se odpečati prek njega, zato nič, kar potrebuje ključ, ne deluje, dokler skrbnik ključev ne odpečati odpečatenjevalnika s svojo lastno identiteto age. To je lastnost zasnove in je enaka tudi na produkcijski gruči. Postopek odpečatenja prikazuje poglavje 2.15, Drugi dan: upravljanje sistema Nexus.

Ko zaključite s preizkusom:

k3d cluster delete harrow-eval

Izbris gruče izbriše namestitev in vse v njej.

nexusctl kubeconfig

Gruča, ki jo je zgradil nexusctl install --single-node, pripada nexusctl. Če jo želite doseči z orodjem kubectl, helm ali katerim koli drugim orodjem, zahtevajte njen kubeconfig:

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

Datoteka podeljuje poln skrbniški dostop do gruče. Hranite jo z dovoljenji v načinu 600, na strojih oseb, ki upravljajo namestitev, in nikjer drugje. Vsak poznejši ukaz v 2. delu, ki sprejme --context ali prebere KUBECONFIG, prek te datoteke deluje na posameznem vozlišču. Enako velja za nadgradnjo: nexusctl upgrade plan --bundle <file> in nexusctl upgrade apply --bundle <file> na posameznem vozlišču nadgradita tudi gručo k3s, ki je v lasti nexusctl.

Diagram predstavlja sklad štirih plasti na okviru z oznako »en strežnik Linux«. Od spodaj navzgor: »k3s v1.33.6+k3s1 (Traefik v kube-system, vrata 80 in 443)«, nato »cert-manager v1.21.3 in lokalni CA charta nexus-local-ca«, nato »podatkovna plast Nexus: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao«, nato »storitve Nexus: konzola, prijava, prehod (gateway) in preostalo«. Na desni strani tri puščice iz zgornje plasti zapuščajo okvir z oznakami console.harrow.example, api.harrow.example in auth.harrow.example. Na levi strani ikona terminala z oznako »nexusctl kubeconfig« kaže v plast k3s.
Kaj nexusctl install --single-node postavi na en strežnik Linux.

Kaj se prenese v gručo

Vse, kar ste naredili na enem stroju, ima svojo ustreznico na gruči. Datoteka z vrednostmi je ista datoteka z drugim registrom, načinom TLS ali razredom shranjevanja (storage class), kot prikazuje poglavje 2.11, Različice: zunanje shrambe, TLS in vstopni promet (ingress). Prvi zagon je enak. Kar se ne prenese, je sama namestitev: ime namestitve je dokončno določeno in namestitve ni mogoče prenesti s prenosnika na strežnik. Ko se je Tomás s svojega prenosnika preselil na pilotni strežnik, je začel znova z novim imenom, harrow-pilot, in obdržal harrow-eval za poskuse.