Prihlásiť saRezervovať brífing

Kapitola 2.8

Inštalácie na jeden stroj

Nainštalujte Nexus na jeden server so systémom Linux pomocou nástroja nexusctl alebo ho vyskúšajte na prenosnom počítači s k3d a pripojte sa ku konzole cez protokol HTTPS, aby fungovalo prihlasovanie a prístupové kľúče (passkeys).

Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

18 min čítania

Predtým, ako spoločnosť Harrow Port Authority nasadila Nexus na svoj produkčný klaster, chcel Tomás Reilly dve menšie inštalácie. Jednou bola pilotná prevádzka na záložnom serveri so systémom Linux v prevádzkovej budove pre dvanástich ľudí, ktorí si ho mali vyskúšať ako prví. Druhá bežala na jeho vlastnom notebooku, aby mohol veci rozbíjať bez toho, že by si to niekto všimol. Táto kapitola sa venuje obom. Používajú rovnaký chart, rovnaké obrazy a rovnaké prvé spustenie ako plná inštalácia v prostredí Kubernetes, takže to, čo sa naučíte na jednom stroji, využijete aj ďalej.

Cesta na serveri predstavuje jeden príkaz: nexusctl install --single-node zostaví na stroji klaster k3s, nainštaluje cert-manager a potom nainštaluje Nexus. Cesta na notebooku si vyžaduje viac manuálnej práce. Sami si zostavíte klaster k3d, pomocou nástroja Helm nainštalujete cert-manager a chart a potom urobíte jeden krok navyše, na ktorom sa nachytá takmer každý: na svojom stroji umiestnite konzolu za protokol HTTPS, pretože cez obyčajné presmerovanie portov (port-forward) sa nikto nikdy neprihlási.

Aký veľký musí byť stroj

Nexus s predvolenými hodnotami chartu vyžaduje v požiadavkách (requests) približne 2.05 jadra CPU (centrálna procesorová jednotka) a 6.7 GiB pamäte a jeho zväzky (volumes) zaberajú spolu 142 GiB. Tento súčet tvorí PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, objektové úložisko 50, dve úložiská OpenBao 1 a 5 a zväzok pre potvrdenia (receipts) 1. Požiadavky predstavujú to, čo rezervuje plánovač (scheduler), a pri reálnej práci ľudí je skutočná spotreba vyššia.

Stroj CPU Pamäť (RAM, pamäť s priamym prístupom) Disk
Odporúčané pre jeden uzol 8 vCPU 32 GiB 250 GB SSD (jednotka SSD)
Minimum na vyskúšanie 4 vCPU 16 GiB 200 GB

Notebook, ktorý spĺňa minimum na vyskúšanie, síce Nexus spustí, ale rozhoduje vlastný limit pamäte pre Docker, nie pamäť notebooku. Pred začatím prideľte pre Docker aspoň 16 GiB.

Obe cesty vyžadujú Kubernetes 1.33 alebo novší. Cesta pre jeden uzol si prináša vlastný: k3s v1.33.6+k3s1, distribúciu, na ktorej sa testuje každé vydanie.

Prvá časť: jeden server Linux s nástrojom nexusctl

Tomásov pilotný server je 8-jadrový stroj s 32 GiB pamäte a 500 GB SSD, na ktorom beží aktuálny Linux a nič iné. Inštalácia vyžaduje oprávnenia používateľa root, pretože inštaluje k3s ako systémovú službu.

Získanie a kontrola nástroja nexusctl

  1. Stiahnite si nexusctl pre svoju architektúru z https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ spolu s verejným kľúčom vydania. Uložte kľúč ako release.pub. Kapitola 2.4, Získanie a overenie vydania, vysvetľuje, ako skontrolovať odtlačok (fingerprint) kľúča oproti tomu, ktorý zverejňuje Adverant.
  2. Skontrolujte binárny súbor a vydanie pomocou kľúča:
nexusctl version --json
nexusctl verify

nexusctl verify skontroluje stiahnuté súbory oproti kľúču vydania Adverant a odmietne čokoľvek, čo nedokáže overiť. Ak kontrola zlyhá, zastavte sa a stiahnite súbory znova. Nikdy nespúšťajte inštaláciu zo súboru, ktorý neprešiel overením.

Vytvorenie kľúča správcu (custodian)

Úložisko kľúčov inštalácie zapečatí svoje kľúče na obnovenie pre jedného alebo viacerých správcov (custodians). Správca je osoba, ktorá offline uchováva súbor identity nástroja age, a bez aspoň jedného správcu sa chart odmietne nainštalovať. Na vlastnom stroji správcu:

age-keygen -o custodian.key

Súbor sa začína riadkom # public key: age1.... Táto verejná polovica sa vkladá do súboru hodnôt (values). Samotný súbor identity nikdy neopúšťa stroj správcu. Na počítači Mac s čipom Secure Enclave vytvorí age-plugin-se keygen --access-control=any-biometry -o custodian.key kľúč, ktorého použitie vyžaduje Touch ID, a jeho verejná polovica sa začína na age1se1.

Vytvorenie súboru hodnôt

# 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 riadok age1... zo súboru custodian.key. Pre každého správcu pridajte jednu položku zoznamu.

Hodnota keys.installationName je trvalá. Pri prvom spustení úložiska kľúčov sa pod týmto názvom vytvorí identita inštalácie a neskôr ju už nič nepremenuje. Musí zodpovedať výrazu ^[a-z][a-z0-9-]{0,62}$: malé písmená, na začiatku písmeno, najviac 63 znakov. Nekopírujte nexus-example ani vzorového príjemcu zo vzorových súborov samotného chartu. Chart oboje podľa názvu odmietne a predbežná kontrola (preflight) nahlási rovnaké kódy ako prvá.

Tieto tri hostiteľské názvy tvoria identitu inštalácie. Bez nich sa každá služba odmietne spustiť a každé prihlásenie, súbor cookie aj prístupový kľúč (passkey) sú viazané na hosts.console. Zvoľte si názvy, ktoré budete chcieť používať aj o päť rokov.

Nasmerovanie troch názvov na server

Používatelia pristupujú ku konzole, rozhraniu API (aplikačné programovacie rozhranie) a prihlasovacej službe cez vstavaný ingress kontrolér systému k3s, Traefik, na portoch 80 a 443 servera. Pridajte tri záznamy DNS (systém doménových mien) pre console.harrow.example, api.harrow.example a auth.harrow.example, pričom každý z nich bude smerovať na adresu servera. Predbežná kontrola preverí každý názov a oznámi vám, pre ktorý chýba záznam.

Sieťová politika chartu povoľuje prístup k trom verejným službám iba jednému mennému priestoru (namespace). Jeho predvolená hodnota, kube-system, je miesto, kde k3s spúšťa Traefik, takže na jednom uzle ponecháte networkPolicy.ingressNamespace bez zmeny.

Spustenie predbežnej kontroly a následná inštalácia

  1. Spustite predbežnú kontrolu s príznakom pre jeden uzol. Prečíta údaje o stroji a váš súbor hodnôt a nič nezmení.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Na konci si prečítajte súhrnný riadok. Upozornenie (warning) inštaláciu nikdy nezablokuje, ale zlyhanie (failure) áno, a každý neúspešný riadok obsahuje riadok 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. Spustite inštaláciu. Príznak --edition sa musí zhodovať s hodnotou edition v súbore hodnôt.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Sledujte priebeh. Znova spustí predbežnú kontrolu, nainštaluje k3s v1.33.6+k3s1, nainštaluje cert-manager v1.21.3, nainštaluje Nexus a počká, kým každá služba neodpovie na kontrolu stavu (health check). Na Tomásovom serveri to trvalo necelých desať minút.
 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

Tento odtlačok si nechajte na obrazovke. Porovnáte ho v prehliadači pri prevzatí inštalácie pomocou kódu. Ak platnosť kódu vyprší skôr, ako ho použijete, príkaz nexusctl claim-code --administrator <email> vytvorí nový. Odtiaľto pokračuje kapitola 2.12, Prvé spustenie.

Inštalácia edície Community
Inštalácia edície Community
Inštalácia edície Community na jednom serveri pozostáva zo stiahnutia, kontroly, predbežnej kontroly a inštalácie, po ktorých nasleduje prvý správca. Krok s licenciou tu nie je.

Vloženie certifikátu

Pri nastavení tls.mode: existing poskytujú tri smerovania ingressu certifikát uložený v objekte Secret s názvom podľa tls.existingSecret. Musí pokrývať všetky tri hostiteľské názvy. Predbežná kontrola tento Secret prečíta, ak existuje, a upozorní vás, ak platnosť certifikátu končí do 30 dní. Keď tam Secret ešte nie je, riadok vás vyzve na jeho vytvorenie, pričom ide o upozornenie, nie o zlyhanie.

Na jednom uzle klaster neexistuje, kým ho nevytvorí inštalácia, preto Secret vytvorte hneď po inštalácii. Najprv zapíšte kubeconfig klastra (vysvetľuje to posledná časť tejto kapitoly) a potom pomocou neho vytvorte 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 obsahuje certifikát, za ktorým nasledujú prípadné sprostredkujúce (intermediate) certifikáty, a harrow-public.key obsahuje jeho súkromný kľúč. Ak vaše certifikáty pochádzajú zo súkromnej CA (certifikačnej autority), príkazy nexusctl preflight a nexusctl install prijímajú parameter --ca-bundle <file>, aby mohli skontrolovať reťazec. Ďalšie spôsoby spracovania protokolu TLS (Transport Layer Security) nájdete v kapitole 2.11, Variácie: externé úložiská, TLS a ingress.

Ak tento postup zlyhá

Čo vidíte Čo to znamená Čo robiť
PREFLIGHT_FAILED (409) Predbežná kontrola zistila zlyhanie, takže inštalácia sa nespustila. Nič sa nenainštalovalo. Opravte každý neúspešný riadok podľa jeho riadka fix a spustite inštaláciu znova.
INSTALLATION_NAME_MISSING Hodnota keys.installationName je prázdna. Nastavte vlastný trvalý názov inštalácie.
INSTALLATION_NAME_EXAMPLE Názov sa zhoduje s názvom zo vzorových hodnôt chartu. Zvoľte si vlastný názov.
KEYS_CUSTODIAN_MISSING Hodnota keys.custody.recipients je prázdna. Pridajte verejného príjemcu age1... každého správcu.
KEYS_CUSTODIAN_EXAMPLE Príjemcom je vzorový správca chartu, ktorého identitu nikto nevlastní. Nahraďte ho príjemcami vašich správcov.

Príkaz nexusctl skončí s kódom 0, keď môže pokračovať, s kódom 1, keď ho zablokovala kontrola, a s kódom 2, keď sa vôbec nemohol spustiť (nečitateľný súbor hodnôt, nesprávny príznak). Skript sa môže na základe týchto troch stavov vetviť.

Druhá časť: skúšobná prevádzka na prenosnom počítači s k3d

Nástroj k3d spúšťa k3s vnútri kontajnerov Docker, takže celý klaster žije na notebooku a jedným príkazom zmizne. Nástroje na vydávanie verzií, ktoré testujú každé vydanie systému Nexus, zostavujú svoje klastre presne týmto spôsobom a skopírovanie ich nastavení vám ušetrí opätovné objavovanie problémov, s ktorými sa už stretli.

Potrebujete Docker, k3d 5.8.3, kubectl, Helm v4 a prehliadač Chrome. Tomás použil svoj Mac.

Vytvorenie klastra

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

Každý príznak má svoj dôvod.

  • --agents 0 vytvorí jeden serverový uzol a žiadne pracovné uzly (workers). Nexus bez problémov beží na jednom uzle a druhý len spotrebúva pamäť.
  • --image rancher/k3s:v1.33.6-k3s1 zafixuje verziu k3s, na ktorej sa testuje každé vydanie. Bez neho dostanete verziu, ktorú má k3d nastavenú ako predvolenú.
  • --disable=traefik@server:0 vynechá Traefik. Notebook nemá žiadnu verejnú adresu, ktorú by mohol obsluhovať, a ku konzole namiesto toho pristupujete cez vlastné rozhranie HTTPS (nižšie).
  • --wait --timeout 300s sa vráti až vtedy, keď klaster odpovie, alebo po piatich minútach zlyhá.

Ak na svojom notebooku zrkadlíte register vydaní, pridajte --registry-config <registries.yaml>, aby sa sťahovanie obrazov smerovalo na zrkadlo (mirror), a --k3s-arg "--disable-default-registry-endpoint@server:0", aby sa nič nevracalo k nadradenému (upstream) registru. Nástroje na vydávanie verzií bežia týmto spôsobom, pričom každý obraz prichádza výlučne cez zrkadlo.

Inštalácia nástroja cert-manager

Chart vytvorí vlastnú lokálnu CA, nexus-local-ca, ako vydavateľa (issuer) v nástroji cert-manager a každá služba získava svoj certifikát od nej. Bez prostriedkov nástroja cert-manager v klastri odmietne helm install chart v priebehu niekoľkých sekúnd. Najprv nainštalujte cert-manager v1.21.3 z chartu, ktorý zverejňuje 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 nástroja cert-manager nepotrebuje nič iné, a to najmä žiadny trust-manager.

Inštalácia systému Nexus

  1. Vytvorte súbor hodnôt pre notebook. TLS končí na vašom vlastnom rozhraní, takže tls.mode má hodnotu 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. Nainštalujte chart z registra a vynechajte --wait (upozornenie nižšie vysvetľuje prečo).
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. Potom sami počkajte na pracovné záťaže (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

Cyklus pre StatefulSet je tu preto, lebo niektoré z nich aktualizujú na požiadanie jeden pod za druhým a kubectl rollout status takéto objekty odmieta. Čakanie na readyReplicas funguje pre každú stratégiu aktualizácie.

Keď sa oba príkazy dokončia, každý Deployment je v stave Available a každý StatefulSet má svoje pody pripravené. Zatiaľ sa nikto nemôže prihlásiť. Je to tak správne: inštalácia ešte nie je prevzatá.

Prečo sa cez presmerovanie portov (port-forward) nikdy neprihlásite

Zrejmým ďalším krokom je kubectl port-forward svc/nexus-alpha 3000:3000 a prehliadač na adrese http://127.0.0.1:3000. Stránky konzoly sa načítajú, takže to vyzerá, akoby to fungovalo. Nefunguje, a žiadne nastavenie to nezmení. V ceste stoja tri veci, každá z nich zámerne.

Čo tomu bráni Prečo
Pôvod (origin) Prihlásenie do konzoly odmietne požiadavku, ktorej pôvod (origin) nie je https://<hosts.console>, v tomto prípade https://console.harrow.example. Stránka poskytovaná z http://127.0.0.1:3000 má nesprávny pôvod, takže prihlásenie sa nikdy nespustí.
Súbor cookie Reláciu tvorí súbor cookie __Host- označený ako Secure. Prehliadače ukladajú takýto súbor cookie iba cez protokol HTTPS, bez atribútu domény, presne pre toho hostiteľa, ktorý ho nastavil. Cez obyčajný protokol HTTP ho prehliadač zahodí.
Prístupový kľúč (passkey) Prvý správca sa prihlasuje pomocou prístupového kľúča a prístupový kľúč vyžaduje zabezpečený kontext s platným certifikátom. Chrome odmietne vytvoriť prístupový kľúč za upozornením na certifikát, a to aj vtedy, keď ste ho odklikli.

Prehliadač teda musí komunikovať s https://console.harrow.example s certifikátom, ktorému dôveruje, a tento názov musí smerovať na váš notebook.

Prístup ku konzole cez protokol HTTPS na prenosnom počítači

Postup uvedený nižšie používa na vydanie certifikátu vlastnú CA chartu, presmerovanie portov na dosiahnutie konzoly a samostatný profil prehliadača Chrome, ktorý dôveruje tejto jednej CA a mapuje názov konzoly na váš notebook. Vaše systémové úložisko dôveryhodných certifikátov a súbor /etc/hosts zostanú bez zmeny.

Diagram zobrazuje vľavo Chrome s popisom „samostatný profil: dôveruje iba nexus-local-ca; console.harrow.example:443 namapované na 127.0.0.1:28443“. Šípka s popisom „HTTPS“ smeruje do poľa „rozhranie HTTPS na 127.0.0.1:28443 (certifikát od nexus-local-ca)“. Šípka s popisom „HTTP, Host ponechaný, X-Forwarded-Proto https“ smeruje do poľa „kubectl port-forward 127.0.0.1:3000“ a posledná šípka vchádza do poľa klastra k3d k „Service nexus-alpha, port http (3000)“. Bodkovaná čiara od nástroja cert-manager vnútri klastra k poľu rozhrania má popis „vydáva certifikát“.
Ako sa prehliadač na notebooku dostane ku konzole v klastri k3d cez protokol HTTPS.

Vydanie certifikátu pre názov konzoly

  1. Požiadajte cert-manager o certifikát pre hostiteľa konzoly podpísaný vydavateľom chartu:
# 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

Nástroj cert-manager ho podpíše vnútri klastra. Súkromný kľúč CA nikdy nečítate.

  1. Skopírujte certifikát, jeho kľúč a certifikát CA z objektu 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. Vypočítajte pin certifikačnej autority. Chrome identifikuje dôveryhodný kľúč pomocou hodnoty SHA-256 jeho verejného kľúča v kódovaní base64:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Pripnite (pin) kľúč CA, nie kľúč certifikátu. Certifikát platí jeden deň a pri každom obnovení nástrojom cert-manager dostane nový kľúč, zatiaľ čo CA zostáva rovnaká.

Predradenie rozhrania HTTPS pred presmerovanie portov

  1. Presmerujte objekt Service konzoly. Jeho port má názov http, čo je v tomto vydaní 3000:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Spustite poslucháča (listener) HTTPS na adrese 127.0.0.1:28443, ktorý presmerováva na 127.0.0.1:3000. Postačí akýkoľvek reverzný proxy server, ktorému už dôverujete, pokiaľ robí štyri veci:
    • poskytuje tls.crt nasledovaný ca.crt ako reťazec s kľúčom tls.key;
    • ponecháva hlavičku Host ako console.harrow.example;
    • nastavuje X-Forwarded-Proto: https;
    • prepúšťa povýšenia spojenia na WebSocket (upgrades), pretože ich konzola používa.

Presmerovanie portov na objekt Service sa naviaže na ten jeden pod, ktorý si vybralo pri spustení. Keď aktualizácia alebo reštart nahradí pod konzoly, presmerovanie zostane spustené, ale nepresmerováva nikam a prehliadač zobrazí chybu bad gateway. Vždy, keď sa pod konzoly zmení, reštartujte presmerovanie portov.

Otvorenie prehliadača Chrome s pinom a mapovaním názvu

Na počítači 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 výstupom riadka openssl. V systéme Linux spustite Chrome s rovnakými tromi príznakmi.

Tieto tri príznaky fungujú spoločne. --host-resolver-rules posiela console.harrow.example na porte 443 na vaše rozhranie, a to iba v rámci tohto profilu. --ignore-certificate-errors-spki-list dôveruje certifikátom vydaným týmto jedným kľúčom CA a Chrome to rešpektuje iba s príznakom --user-data-dir. Samostatný profil udrží túto výnimku mimo vášho každodenného prehliadania. Nie je to plošný prepínač „ignorovať chyby certifikátov“: čokoľvek, čo nie je podpísané certifikačnou autoritou klastra, naďalej zlyhá.

S otvoreným týmto profilom smeruje https://console.harrow.example/install na stránku prevzatia inštalácie a je možné vytvoriť prístupový kľúč. Odtiaľto pokračuje kapitola 2.12, Prvé spustenie.

Keď sa notebook reštartuje

Úložisko kľúčov má dve časti: samotné úložisko kľúčov a malú službu na odpečatenie (unsealer), ktorá drží jeho odomykací kľúč. Po akomkoľvek reštarte uzla (reštart systému Docker, reštart notebooku, k3d cluster stop a start) sa služba na odpečatenie spustí ako zapečatená. Úložisko kľúčov sa odpečatí cez ňu, takže kým správca neodpečatí túto službu vlastnou identitou age, nič, čo vyžaduje kľúč, nefunguje. Je to vlastnosť návrhu a na produkčnom klastri to funguje rovnako. Postup odpečatenia ukazuje kapitola 2.15, Druhý deň: prevádzka systému Nexus.

Keď skončíte so skúšaním:

k3d cluster delete harrow-eval

Odstránením klastra sa odstráni inštalácia a všetko v nej.

nexusctl kubeconfig

Klaster, ktorý zostavil príkaz nexusctl install --single-node, patrí nástroju nexusctl. Ak sa k nemu chcete dostať pomocou kubectl, helm alebo akéhokoľvek iného nástroja, vyžiadajte si jeho kubeconfig:

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

Tento súbor udeľuje plný správcovský prístup ku klastru. Uchovávajte ho s oprávneniami v režime 600 na strojoch ľudí, ktorí prevádzkujú inštaláciu, a nikde inde. Každý ďalší príkaz v časti 2, ktorý prijíma --context alebo číta KUBECONFIG, funguje voči jednému uzlu prostredníctvom tohto súboru. To isté platí pre aktualizáciu (upgrade): nexusctl upgrade plan --bundle <file> a nexusctl upgrade apply --bundle <file> na jednom uzle aktualizujú aj klaster k3s, ktorý vlastní nexusctl.

Diagram predstavuje stoh štyroch vrstiev na poli s popisom „jeden server so systémom Linux“. Zospodu: „k3s v1.33.6+k3s1 (Traefik v kube-system, porty 80 a 443)“, potom „cert-manager v1.21.3 a lokálna CA chartu nexus-local-ca“, potom „dátová vrstva Nexus: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao“, potom „služby Nexus: konzola, prihlásenie, brána a ostatné“. Vpravo vychádzajú z hornej vrstvy mimo poľa tri šípky s popismi console.harrow.example, api.harrow.example a auth.harrow.example. Vľavo smeruje ikona terminálu s popisom „nexusctl kubeconfig“ do vrstvy k3s.
Čo nexusctl install --single-node vloží na jeden server so systémom Linux.

Čo sa prenáša do klastra

Všetko, čo ste urobili na jednom stroji, má svoj ekvivalent aj na klastri. Súbor hodnôt je ten istý súbor s iným registrom, režimom TLS alebo triedou úložiska (storage class), ako ukazuje kapitola 2.11, Variácie: externé úložiská, TLS a ingress. Prvé spustenie je identické. Čo sa neprenáša, je samotná inštalácia: názov inštalácie je natrvalo pevne daný a inštaláciu nie je možné presunúť z notebooku na server. Keď Tomás prešiel zo svojho notebooku na pilotný server, začal odznova s novým názvom, harrow-pilot, a harrow-eval si ponechal na experimenty.