Přihlásit seDomluvit prezentaci

Kapitola 2.8

Instalace na jeden stroj

Nainstalujte Nexus na jeden linuxový server pomocí nexusctl nebo jej vyzkoušejte na notebooku s k3d a přistupujte ke konzoli přes HTTPS, aby fungovalo přihlašování a přístupové klíče (passkeys).

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

18 min čtení

Než organizace Harrow Port Authority nasadila Nexus do svého produkčního clusteru, chtěl Tomás Reilly provést dvě menší instalace. Jednou z nich byl pilotní provoz na záložním linuxovém serveru v provozní budově, určený pro dvanáct lidí, kteří si systém měli vyzkoušet jako první. Druhá běžela na jeho vlastním notebooku, aby si mohl vše vyzkoušet nanečisto, aniž by si toho kdokoli všiml. Tato kapitola se věnuje oběma případům. Využívají stejný chart, stejné obrazy a stejné první spuštění jako plná instalace v prostředí Kubernetes, takže vše, co se naučíte na jednom stroji, uplatníte i jinde.

Cesta na serveru obnáší jediný příkaz: nexusctl install --single-node na stroji sestaví cluster k3s, nainstaluje cert-manager a poté nainstaluje Nexus. Cesta na notebooku vyžaduje více ruční práce. Sami si sestavíte cluster k3d, pomocí nástroje Helm nainstalujete cert-manager a příslušný chart a poté provedete jeden krok navíc, na kterém se zasekne téměř každý: umístíte konzoli na svém stroji za protokol HTTPS, protože přes prosté přesměrování portů (port-forward) se nikdo nikdy nepřihlásí.

Jak velký musí stroj být

Nexus s výchozími hodnotami chartu vyžaduje v požadavcích (requests) přibližně 2.05 jádra CPU (centrální procesorová jednotka) a 6.7 GiB paměti a jeho svazky (volumes) dávají dohromady 142 GiB. Tento součet tvoří PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, objektové úložiště 50, dvě úložiště OpenBao 1 a 5 a svazek pro potvrzení (receipts) 1. Požadavky udávají, co plánovač rezervuje; skutečné využití je vyšší, jakmile v systému začnou pracovat uživatelé.

Stroj CPU Paměť (RAM, paměť s přímým přístupem) Disk
Doporučený samostatný uzel 8 vCPU 32 GiB 250 GB SSD (solid-state drive)
Minimum pro zkušební provoz 4 vCPU 16 GiB 200 GB

Notebook, který splňuje minimum pro zkušební provoz, sice Nexus zvládne spustit, ale rozhodující je vlastní limit paměti pro Docker, nikoli celková paměť notebooku. Než začnete, přidělte prostředí Docker alespoň 16 GiB.

Obě cesty vyžadují Kubernetes 1.33 nebo novější. Cesta pro samostatný uzel si přináší vlastní: k3s v1.33.6+k3s1, což je distribuce, na které je testováno každé vydání.

Část první: jeden linuxový server s nexusctl

Tomásův pilotní server je 8jádrový stroj s 32 GiB paměti a 500 GB SSD diskem, na kterém běží aktuální Linux a nic dalšího. Instalace vyžaduje oprávnění uživatele root, protože instaluje k3s jako systémovou službu.

Získání a kontrola nástroje nexusctl

  1. Stáhněte si nexusctl pro svou architekturu z https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ společně s veřejným klíčem vydání. Klíč uložte jako release.pub. Kapitola 2.4, Získání a ověření vydání, vysvětluje, jak zkontrolovat otisk klíče oproti otisku, který zveřejňuje Adverant.
  2. Zkontrolujte binární soubor a vydání pomocí klíče:
nexusctl version --json
nexusctl verify

Příkaz nexusctl verify zkontroluje stažený soubor oproti klíči vydání společnosti Adverant a odmítne vše, co nedokáže ověřit. Pokud kontrola selže, zastavte a soubor stáhněte znovu. Nikdy nespouštějte instalaci ze souboru, který neprošel ověřením.

Vytvoření klíče správce klíčů

Úložiště klíčů dané instalace zapečetí své obnovovací klíče pro jednoho nebo více správců klíčů (custodians). Správce klíčů je osoba, která uchovává soubor identity nástroje age v režimu offline; bez alespoň jednoho takového správce se chart odmítne nainstalovat. Na vlastním stroji správce klíčů spusťte:

age-keygen -o custodian.key

Soubor začíná řádkem # public key: age1.... Tato veřejná polovina je to, co se vkládá do souboru hodnot (values). Samotný soubor identity nikdy neopouští stroj správce klíčů. Na počítači Mac s čipem Secure Enclave vytvoří age-plugin-se keygen --access-control=any-biometry -o custodian.key klíč, jehož použití vyžaduje Touch ID a jehož veřejná polovina začíná age1se1.

Vytvoření souboru hodnot

# 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 řádek age1... ze souboru custodian.key. Přidejte jednu položku seznamu pro každého správce klíčů.

Hodnota keys.installationName je trvalá. Při prvním spuštění úložiště klíčů se pod tímto názvem vytvoří identita instalace a nic ji už dodatečně nepřejmenuje. Musí odpovídat výrazu ^[a-z][a-z0-9-]{0,62}$: malá písmena, na začátku písmeno, nejvýše 63 znaků. Nekopírujte nexus-example ani ukázkového příjemce z vlastních ukázkových souborů chartu. Chart obojí jmenovitě odmítne a předběžná kontrola (preflight) nahlásí stejné kódy jako první.

Tyto tři názvy hostitelů tvoří identitu instalace. Bez nich se každá služba odmítne spustit a každé přihlášení, soubor cookie i přístupový klíč (passkey) jsou vázány na hosts.console. Zvolte názvy, které budete chtít používat i za pět let.

Nasměrování tří názvů na server

Uživatelé přistupují ke konzoli, rozhraní API (aplikační programovací rozhraní) a přihlašovací službě přes vestavěný ingress controller systému k3s, Traefik, na portech 80 a 443 daného serveru. Přidejte tři záznamy DNS (Domain Name System) pro console.harrow.example, api.harrow.example a auth.harrow.example, z nichž každý bude směřovat na adresu serveru. Předběžná kontrola každý název ověří a oznámí vám, pro který z nich záznam chybí.

Síťová politika chartu umožňuje přístup ke třem veřejným službám pouze jednomu jmennému prostoru (namespace). Její výchozí hodnota, kube-system, je místo, kde k3s spouští Traefik, takže na samostatném uzlu ponecháte networkPolicy.ingressNamespace beze změny.

Spuštění předběžné kontroly a následná instalace

  1. Spusťte předběžnou kontrolu s příznakem pro samostatný uzel. Přečte stav stroje a váš soubor hodnot a nic nezmění.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Na konci si přečtěte souhrnný řádek. Varování instalaci nikdy nezablokuje, ale selhání ano, přičemž každý neúspěšný řádek obsahuje řádek 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. Spusťte instalaci. Příznak --edition musí souhlasit s hodnotou edition v souboru hodnot.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Sledujte průběh. Příkaz znovu spustí předběžnou kontrolu, nainstaluje k3s v1.33.6+k3s1, nainstaluje cert-manager v1.21.3, nainstaluje Nexus a počká, až každá služba odpoví na kontrolu stavu (health check). Na Tomásově serveru to trvalo necelých 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

Nechte si tento otisk zobrazený na obrazovce. Budete jej porovnávat v prohlížeči, až si budete instalaci nárokovat pomocí kódu. Pokud platnost kódu vyprší dříve, než jej použijete, příkaz nexusctl claim-code --administrator <email> vygeneruje nový. Kapitola 2.12, První spuštění, na tento krok navazuje.

Instalace edice Community
Instalace edice Community
Instalace edice Community na jeden server obnáší stažení, kontrolu, předběžnou kontrolu a instalaci, po nichž následuje vytvoření prvního administrátora. Krok s licencí zde není.

Umístění certifikátu

Při nastavení tls.mode: existing poskytují tři trasy ingressu certifikát uložený v objektu Secret s názvem určeným v tls.existingSecret. Certifikát musí pokrývat všechny tři hostitele. Předběžná kontrola tento Secret přečte, pokud existuje, a zobrazí varování, pokud platnost certifikátu končí do 30 dnů. Když tam Secret ještě není, řádek vás vyzve k jeho vytvoření – jde o varování, nikoli o selhání.

Na samostatném uzlu cluster neexistuje, dokud jej instalace nevytvoří, takže Secret vytvořte ihned po instalaci. Nejprve vypište kubeconfig clusteru (vysvětluje to poslední část této kapitoly) a poté pomocí něj vytvořte 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

Soubor harrow-public.crt obsahuje samotný certifikát následovaný případnými zprostředkujícími (intermediate) certifikáty a harrow-public.key obsahuje jeho soukromý klíč. Pokud vaše certifikáty pocházejí ze soukromé CA (certifikační autority), příkazy nexusctl preflight a nexusctl install přijímají parametr --ca-bundle <file>, aby mohly zkontrolovat řetězec certifikátů. Další způsoby práce s protokolem TLS (Transport Layer Security) najdete v kapitole 2.11, Varianty: externí úložiště, TLS a ingress.

Pokud to selže

Co vidíte Co to znamená Co dělat
PREFLIGHT_FAILED (409) Předběžná kontrola narazila na selhání, takže instalace nezačala. Nic nebylo nainstalováno. Opravte každý neúspěšný řádek pomocí jeho řádku fix a spusťte instalaci znovu.
INSTALLATION_NAME_MISSING Pole keys.installationName je prázdné. Nastavte vlastní trvalý název instalace.
INSTALLATION_NAME_EXAMPLE Název se shoduje s názvem z ukázkových hodnot chartu. Zvolte si vlastní název.
KEYS_CUSTODIAN_MISSING Pole keys.custody.recipients je prázdné. Přidejte veřejného příjemce age1... každého správce klíčů.
KEYS_CUSTODIAN_EXAMPLE Příjemcem je ukázkový správce klíčů z chartu, jehož identitu nikdo nevlastní. Nahraďte jej příjemci svých správců klíčů.

Příkaz nexusctl skončí s kódem 0, když může pokračovat, 1, když jej zablokovala kontrola, a 2, když vůbec nemohl proběhnout (nečitelný soubor hodnot, chybný příznak). Skript se může na základě těchto tří stavů větvit.

Část druhá: zkušební provoz na notebooku s k3d

Nástroj k3d spouští k3s uvnitř kontejnerů Docker, takže celý cluster žije na notebooku a jediným příkazem zase zmizí. Nástroje pro správu vydání, které testují každé vydání systému Nexus, sestavují své clustery přesně tímto způsobem; zkopírováním jejich nastavení se vyhnete opětovnému objevování problémů, na které už narazily.

Potřebujete Docker, k3d 5.8.3, kubectl, Helm v4 a prohlížeč Chrome. Tomás použil svůj Mac.

Vytvoření clusteru

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ý příznak má svůj důvod.

  • --agents 0 vytvoří jeden serverový uzel a žádné pracovní uzly (workers). Nexus bez problémů běží na jednom uzlu a druhý by jen spotřebovával paměť.
  • --image rancher/k3s:v1.33.6-k3s1 zafixuje verzi k3s, na které je testováno každé vydání. Bez něj dostanete tu verzi, kterou má k3d nastavenou jako výchozí.
  • --disable=traefik@server:0 vynechá Traefik. Notebook nemá žádnou veřejnou adresu, kterou by mohl obsluhovat, a ke konzoli se místo toho dostanete přes vlastní rozhraní HTTPS (viz níže).
  • --wait --timeout 300s se vrátí až ve chvíli, kdy cluster odpovídá, nebo po pěti minutách selže.

Pokud na svém notebooku zrcadlíte registr vydání, přidejte --registry-config <registries.yaml>, aby se stahování obrazů směřovalo na zrcadlo (mirror), a --k3s-arg "--disable-default-registry-endpoint@server:0", aby nic nepřecházelo v záloze na nadřazený (upstream) registr. Nástroje pro vydání běží tímto způsobem, přičemž každý obraz přichází výhradně přes zrcadlo.

Instalace nástroje cert-manager

Chart vytvoří svou vlastní lokální CA, nexus-local-ca, jako vydavatele (issuer) v nástroji cert-manager a každá služba od ní získává svůj certifikát. Bez prostředků nástroje cert-manager v clusteru příkaz helm install chart během několika sekund odmítne. Nejprve nainstalujte cert-manager v1.21.3 z chartu, který zveřejň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ástroje cert-manager nic dalšího nepotřebuje, a zejména nepotřebuje trust-manager.

Instalace systému Nexus

  1. Vytvořte soubor hodnot pro notebook. Protokol TLS končí na vašem vlastním 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. Nainstalujte chart z registru a vynechte --wait (varování níže vysvětluje proč).
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. Poté na úlohy (workloads) počkejte sami:
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

Smyčka pro objekty StatefulSet je zde proto, že některé z nich aktualizují na vyžádání vždy jeden pod po druhém a kubectl rollout status takové odmítá. Čekání na readyReplicas funguje pro každou strategii aktualizace.

Když se oba příkazy vrátí, každý Deployment je ve stavu Available a každý StatefulSet má své pody připravené. Nikdo se zatím nemůže přihlásit. To je v pořádku: instalace zatím není nárokována.

Proč vás přesměrování portů nikdy nepřihlásí

Nabízí se další zřejmý krok: kubectl port-forward svc/nexus-alpha 3000:3000 a prohlížeč na adrese http://127.0.0.1:3000. Stránky konzole se načtou, takže to vypadá, že vše funguje. Nefunguje a žádné nastavení to nezmění. V cestě stojí tři věci, každá z nich záměrně.

Co tomu brání Proč
Původ (origin) Přihlašování do konzole odmítne požadavek, jehož původ (origin) není https://<hosts.console>, zde https://console.harrow.example. Stránka poskytovaná z http://127.0.0.1:3000 má nesprávný původ, takže přihlašování vůbec nezačne.
Soubor cookie Relace je uložena v souboru cookie s předponou __Host- označeném jako Secure. Prohlížeče takový soubor cookie ukládají pouze přes HTTPS, bez atributu domény, přesně pro toho hostitele, který jej nastavil. Přes prostý protokol HTTP jej prohlížeč zahodí.
Přístupový klíč (passkey) První administrátor se přihlašuje pomocí přístupového klíče (passkey) a ten vyžaduje zabezpečený kontext s platným certifikátem. Prohlížeč Chrome odmítne vytvořit přístupový klíč za varováním o certifikátu, a to i v případě, že jste jej odklikli.

Prohlížeč tedy musí komunikovat s adresou https://console.harrow.example, s certifikátem, kterému důvěřuje, a tento název musí směřovat na váš notebook.

Přístup ke konzoli přes HTTPS na notebooku

Níže uvedená metoda využívá k vydání certifikátu vlastní CA daného chartu, přesměrování portů pro dosažení konzole a samostatný profil prohlížeče Chrome, který důvěřuje této jedné CA a mapuje název konzole na váš notebook. Vaše systémové úložiště důvěryhodných certifikátů a soubor /etc/hosts zůstanou beze změny.

Diagram ukazuje vlevo prohlížeč Chrome s popiskem „samostatný profil: důvěřuje pouze nexus-local-ca; console.harrow.example:443 namapováno na 127.0.0.1:28443“. Šipka s popiskem „HTTPS“ vede do pole „rozhraní HTTPS na 127.0.0.1:28443 (certifikát z nexus-local-ca)“. Šipka s popiskem „HTTP, hlavička Host zachována, X-Forwarded-Proto https“ vede do „kubectl port-forward 127.0.0.1:3000“ a poslední šipka vede do pole clusteru k3d k „Service nexus-alpha, port http (3000)“. Tečkovaná čára od nástroje cert-manager uvnitř clusteru k poli rozhraní nese popisek „vydává certifikát“.
Jak se prohlížeč na notebooku dostane ke konzoli v clusteru k3d přes protokol HTTPS.

Vydání certifikátu pro název konzole

  1. Požádejte cert-manager o certifikát pro hostitele konzole, podepsaný vydavatelem 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 jej podepíše uvnitř clusteru. Soukromý klíč CA nikdy nečtete.

  1. Zkopírujte certifikát, jeho klíč 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. Zjistěte otisk (pin) certifikační autority. Prohlížeč Chrome identifikuje důvěryhodný klíč pomocí otisku SHA-256 jeho veřejného klíče v kódování base64:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Připněte (pin) klíč CA, nikoli klíč certifikátu. Certifikát platí jeden den a při každém obnovení nástrojem cert-manager dostane nový klíč, zatímco CA zůstává stejná.

Umístění rozhraní HTTPS před přesměrování portů

  1. Přesměrujte objekt Service dané konzole. Jeho port nese název http, což je v tomto vydání 3000:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Spusťte posluchač (listener) protokolu HTTPS na adrese 127.0.0.1:28443, který předává provoz na 127.0.0.1:3000. Poslouží jakákoli reverzní proxy, které již důvěřujete, pokud splňuje čtyři věci:
    • poskytuje tls.crt následovaný ca.crt jako řetězec, s klíčem tls.key;
    • zachovává hlavičku Host jako console.harrow.example;
    • nastavuje X-Forwarded-Proto: https;
    • propouští povýšení spojení na protokol WebSocket (upgrades), protože je konzole využívá.

Přesměrování portů na objekt Service se naváže na ten jeden pod, který si vybralo při svém spuštění. Poté, co upgrade nebo restart nahradí pod konzole, přesměrování zůstane běžet, ale směřuje do prázdna a prohlížeč zobrazí chybu brány (bad gateway). Kdykoli se pod konzole změní, přesměrování portů restartujte.

Otevření prohlížeče Chrome s otiskem a mapování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ýstupem řádku openssl. V systému Linux spusťte Chrome se stejnými třemi příznaky.

Tyto tři příznaky fungují společně. --host-resolver-rules posílá provoz pro console.harrow.example na portu 443 na vaše rozhraní, a to pouze v rámci tohoto profilu. --ignore-certificate-errors-spki-list důvěřuje certifikátům vydaným tímto jedním klíčem CA a Chrome jej respektuje pouze s příznakem --user-data-dir. Samostatný profil udržuje tuto výjimku odděleně od vašeho každodenního prohlížení webu. Nejedná se o plošný přepínač typu „ignorovat chyby certifikátů“: cokoli, co není podepsáno certifikační autoritou clusteru, i nadále selže.

Když máte tento profil otevřený, adresa https://console.harrow.example/install vede na stránku pro nárokování instalace a je možné vytvořit přístupový klíč (passkey). Kapitola 2.12, První spuštění, odtud pokračuje dále.

Když se notebook restartuje

Úložiště klíčů má dvě části: samotné úložiště klíčů a malou službu pro odpečetění (unsealer), která drží jeho odemykací klíč. Po jakémkoli restartu uzlu (restart prostředí Docker, restart notebooku, k3d cluster stop a start) se služba pro odpečetění spustí v zapečetěném stavu. Úložiště klíčů se odpečeťuje jejím prostřednictvím, takže dokud správce klíčů neodpečetí tuto službu pomocí své vlastní identity age, nic, co vyžaduje klíč, nefunguje. To je vlastnost návrhu systému a v produkčním clusteru to funguje stejně. Kapitola 2.15, Druhý den: provoz systému Nexus, ukazuje postup odpečetění.

Až se zkušebním provozem skončíte:

k3d cluster delete harrow-eval

Smazáním clusteru smažete instalaci i vše v ní.

nexusctl kubeconfig

Cluster, který sestavil příkaz nexusctl install --single-node, patří nástroji nexusctl. Chcete-li k němu přistupovat pomocí kubectl, helm nebo jakéhokoli jiného nástroje, vyžádejte 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 soubor uděluje plný administrátorský přístup ke clusteru. Uchovávejte jej s oprávněními v režimu 600 na strojích lidí, kteří instalaci spravují, a nikde jinde. Každý další příkaz v Části 2, který přijímá --context nebo čte KUBECONFIG, funguje prostřednictvím tohoto souboru i proti samostatnému uzlu. Totéž platí pro upgrade: nexusctl upgrade plan --bundle <file> a nexusctl upgrade apply --bundle <file> na samostatném uzlu zároveň provedou upgrade clusteru k3s, který nexusctl vlastní.

Diagram znázorňuje sadu čtyř vrstev v poli označeném „jeden linuxový server“. Zespodu: „k3s v1.33.6+k3s1 (Traefik v kube-system, porty 80 a 443)“, poté „cert-manager v1.21.3 a lokální CA chartu nexus-local-ca“, dále „datová vrstva Nexus: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao“ a nakonec „služby Nexus: konzole, přihlašování, brána a ostatní“. Směrem doprava vycházejí z horní vrstvy mimo pole tři šipky označené console.harrow.example, api.harrow.example a auth.harrow.example. Vlevo míří ikona terminálu s popiskem „nexusctl kubeconfig“ do vrstvy k3s.
Co nexusctl install --single-node nainstaluje na jeden linuxový server.

Co se přenáší do clusteru

Vše, co jste udělali na jednom stroji, má svůj ekvivalent na clusteru. Soubor hodnot je tentýž soubor jen s jiným registrem, režimem TLS nebo třídou úložiště (storage class), jak ukazuje kapitola 2.11, Varianty: externí úložiště, TLS a ingress. První spuštění je totožné. Co se nepřenáší, je samotná instalace: název instalace je pevně daný natrvalo a instalaci nelze přenést z notebooku na server. Když Tomás přešel ze svého notebooku na pilotní server, začal znovu s novým názvem, harrow-pilot, a harrow-eval si ponechal pro experimenty.