BejelentkezésBemutató kérése

2.8. fejezet

Egygépes telepítések

Telepítse a Nexust egyetlen Linux-szerverre a nexusctl segítségével, vagy próbálja ki egy laptopon k3d-vel, és érje el a konzolt HTTPS-en keresztül, hogy a bejelentkezés és a hozzáférési kulcsok (passkey) működjenek.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

18 perc olvasási idő

Mielőtt a Harrow Port Authority éles fürtjére telepítette volna a Nexust, Tomás Reilly két kisebb telepítést szeretett volna. Az egyik egy kísérleti rendszer volt az üzemeltetési épület egyik tartalék Linux-szerverén azon tizenkét ember számára, akik elsőként próbálták ki. A másik a saját laptopján futott, hogy úgy tehessen tönkre dolgokat, hogy azt senki sem veszi észre. Ez a fejezet mindkettőt bemutatja. Ugyanazt a chartot, ugyanazokat a képfájlokat és ugyanazt az első indítást használják, mint egy teljes Kubernetes-telepítés, így amit az egyik gépen megtanul, az a másikra is érvényes.

A szerveres útvonal egyetlen parancs: a nexusctl install --single-node felépít egy k3s-fürtöt a gépen, telepíti a cert-managert, majd telepíti a Nexust. A laptopos útvonal több kézi beavatkozást igényel. Ön építi fel a k3d-fürtöt, telepíti a cert-managert és a chartot a Helmmel, majd elvégez egy további feladatot, amelyen szinte mindenki fennakad: a konzolt HTTPS mögé helyezi a saját gépén, mert egy egyszerű porttovábbítás soha senkit nem tud bejelentkeztetni.

Mekkora gép szükséges

A Nexus a chart alapértelmezett beállításaival körülbelül 2.05 CPU (központi feldolgozóegység) magot és 6.7 GiB memóriát igényel, a kötetei pedig összesen 142 GiB-ot tesznek ki. Ez az összeg a következőkből áll: PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, az objektumtároló 50, a két OpenBao tároló 1 és 5, a nyugták kötete pedig 1. Az igénylések azok az értékek, amelyeket az ütemező lefoglal, a tényleges használat pedig magasabb lesz, amint elkezdődik a munka.

Gép CPU Memória (RAM, közvetlen elérésű memória) Lemez
Ajánlott egyetlen csomópont 8 vCPU 32 GiB 250 GB SSD (félvezető-alapú meghajtó)
Minimum a kiértékeléshez 4 vCPU 16 GiB 200 GB

Egy olyan laptop, amely megfelel a kiértékelési minimumnak, képes futtatni a Nexust, de a Docker saját memóriakorlátja számít, nem a laptopé. Indítás előtt adjon a Dockernek legalább 16 GiB-ot.

Mindkét útvonalhoz Kubernetes 1.33 vagy újabb verzió szükséges. Az egycsomópontos útvonal hozza a sajátját: a k3s v1.33.6+k3s1 verziót, amelyen minden kiadást tesztelnek.

Első rész: egyetlen Linux-szerver nexusctl-lel

Tomás kísérleti szervere egy 8 magos gép 32 GiB memóriával és 500 GB-os SSD-vel, amelyen egy aktuális Linux fut, minden más nélkül. A telepítéshez root jogosultság szükséges, mert a k3s-t rendszerszolgáltatásként telepíti.

A nexusctl beszerzése és ellenőrzése

  1. Töltse le az architektúrájának megfelelő nexusctl fájlt innen: https://downloads.adverant.ai/nexus/1.0.0-alpha.1/, a kiadás nyilvános kulcsával együtt. Mentse a kulcsot release.pub néven. A 2.4. fejezet (Kiadás beszerzése és ellenőrzése) elmagyarázza, hogyan ellenőrizheti a kulcs ujjlenyomatát az Adverant által közzétett ujjlenyomattal.
  2. Ellenőrizze a bináris fájlt és a kiadást a kulccsal:
nexusctl version --json
nexusctl verify

A nexusctl verify ellenőrzi a letöltést az Adverant kiadási kulcsával, és elutasít mindent, amit nem tud hitelesíteni. Ha sikertelen, álljon meg, és töltse le újra. Soha ne futtasson telepítést olyan fájlból, amelynek az ellenőrzése nem sikerült.

A kulcsőrzői kulcs elkészítése

A telepítés kulcstárolója egy vagy több kulcsőrzőhöz zárja le a helyreállítási kulcsait. A kulcsőrző olyan személy, aki offline tárol egy age személyazonossági fájlt, és a chart megtagadja a telepítést, ha nincs megadva legalább egy. A kulcsőrző saját gépén:

age-keygen -o custodian.key

A fájl egy # public key: age1... sorral kezdődik. Ez a nyilvános fél kerül be a values fájlba. Maga a személyazonossági fájl soha nem hagyja el a kulcsőrző gépét. Egy Secure Enclave-vel rendelkező Mac gépen az age-plugin-se keygen --access-control=any-biometry -o custodian.key olyan kulcsot készít, amelynek használatához Touch ID szükséges, és a nyilvános fele age1se1 karakterekkel kezdődik.

A values fájl megírása

# 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>"

A <custodian-age-recipient> a age1... sor a custodian.key fájlból. Adjon hozzá egy listaelemet kulcsőrzőnként.

Az keys.installationName végleges. A kulcstároló első indítása ezen a néven hozza létre a telepítés személyazonosságát, és ezt utólag semmi sem tudja átnevezni. Meg kell felelnie a ^[a-z][a-z0-9-]{0,62}$ mintának: kisbetűs, betűvel kezdődik, és legfeljebb 63 karakterből áll. Ne másolja át a nexus-example értéket vagy a példa címzettet a chart saját példafájljaiból. A chart mindkettőt név szerint elutasítja, és az előzetes ellenőrzés is ugyanezeket a kódokat jelenti először.

A három állomásnév jelenti a telepítés személyazonosságát. Nélkülük minden szolgáltatás megtagadja az indulást, és minden bejelentkezés, süti és hozzáférési kulcs (passkey) a hosts.console címhez van kötve. Válasszon olyan neveket, amelyeket öt év múlva is használni szeretne.

A három név ráirányítása a szerverre

A felhasználók a konzolt, az API-t (alkalmazásprogramozási felület) és a bejelentkezési szolgáltatást a k3s beépített ingress vezérlőjén, a Traefiken keresztül érik el a szerver 80-as és 443-as portján. Adjon hozzá három DNS (Domain Name System) rekordot a console.harrow.example, api.harrow.example és auth.harrow.example nevekhez úgy, hogy mindegyik a szerver címére mutasson. Az előzetes ellenőrzés megvizsgálja mindegyik nevet, és megmondja, melyikhez nincs rekord.

A chart hálózati házirendje csak egyetlen névtérnek engedélyezi a három nyilvános szolgáltatás elérését. Az alapértelmezett kube-system az a hely, ahol a k3s a Traefiket futtatja, így egyetlen csomópont esetén az networkPolicy.ingressNamespace beállítást hagyja változatlanul.

Előzetes ellenőrzés futtatása, majd telepítés

  1. Futtassa az előzetes ellenőrzést az egycsomópontos kapcsolóval. Ez beolvassa a gépet és a values fájlt, és semmit sem módosít.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Olvassa el a végén található összegző sort. A figyelmeztetés soha nem blokkolja a telepítést, a hiba viszont igen, és minden sikertelen sor tartalmaz egy fix sort.
 ────────────────────────────────────────────────────────────
 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. Telepítés. A --edition kapcsolónak meg kell egyeznie a values fájlban szereplő edition értékkel.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Figyelje a futását. Újra lefuttatja az előzetes ellenőrzést, telepíti a k3s v1.33.6+k3s1 verziót, telepíti a cert-manager v1.21.3 verziót, telepíti a Nexust, és megvárja, amíg minden szolgáltatás válaszol az állapotellenőrzésre. Tomás szerverén ez valamivel kevesebb mint tíz percet vett igénybe.
 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

Tartsa a képernyőn ezt az ujjlenyomatot. A böngészőben fogja összehasonlítani, amikor a kóddal birtokba veszi a telepítést. Ha a kód lejár, mielőtt felhasználná, a nexusctl claim-code --administrator <email> újat készít. A 2.12. fejezet (Az első indítás) innen folytatja.

A Community kiadás telepítése
A Community kiadás telepítése
A Community kiadás telepítése egyetlen szerveren a letöltésből, ellenőrzésből, előzetes ellenőrzésből és telepítésből, majd az első rendszergazda beállításából áll. Nincs licencelési lépés.

A tanúsítvány elhelyezése

A tls.mode: existing használatakor a három ingress útvonal a tls.existingSecret által megnevezett Secretben lévő tanúsítványt szolgálja ki. Ennek mindhárom állomásnevet le kell fednie. Az előzetes ellenőrzés beolvassa ezt a Secretet, ha létezik, és figyelmeztet, ha a tanúsítvány 30 napon belül lejár. Ha a Secret még nincs ott, a sor jelzi, hogy hozza létre, és ez figyelmeztetésnek, nem pedig hibának minősül.

Egyetlen csomópont esetén a fürt nem létezik, amíg a telepítés létre nem hozza, ezért közvetlenül a telepítés után hozza létre a Secretet. Először írassa ki a fürt kubeconfig fájlját (a fejezet utolsó szakasza elmagyarázza), majd hozza létre vele a Secretet:

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

A harrow-public.crt tartalmazza a tanúsítványt, amelyet a közbenső tanúsítványok követnek, a harrow-public.key pedig a privát kulcsát. Ha a tanúsítványai privát CA-tól (hitelesítésszolgáltatótól) származnak, a nexusctl preflight és a nexusctl install elfogadja a --ca-bundle <file> kapcsolót, így ellenőrizni tudják a láncot. A TLS (Transport Layer Security) kezelésének további módjai a 2.11. fejezetben (Variációk: külső tárolók, TLS és ingress) találhatók.

Ha ez sikertelen

Amit lát Mit jelent Teendők
PREFLIGHT_FAILED (409) Az előzetes ellenőrzés hibát talált, így a telepítés nem indult el. Semmi sem lett telepítve. Javítson ki minden sikertelen sort a hozzá tartozó fix sor alapján, majd futtassa újra a telepítést.
INSTALLATION_NAME_MISSING Az keys.installationName üres. Állítsa be a telepítés saját végleges nevét.
INSTALLATION_NAME_EXAMPLE A név a chart példaértékeiből származik. Válasszon saját nevet.
KEYS_CUSTODIAN_MISSING Az keys.custody.recipients üres. Adja hozzá minden kulcsőrző nyilvános age1... címzettjét.
KEYS_CUSTODIAN_EXAMPLE Az egyik címzett a chart példa kulcsőrzője, akinek a személyazonosságával senki sem rendelkezik. Cserélje le a saját kulcsőrzőinek címzettjeire.

A nexusctl 0 értékkel lép ki, ha folytatható, 1 értékkel, ha egy ellenőrzés blokkolta, és 2 értékkel, ha egyáltalán nem tudott lefutni (olvashatatlan values fájl, hibás kapcsoló). Egy parancsfájl e három érték alapján elágazhat.

Második rész: kipróbálás laptopon k3d-vel

A k3d Docker-konténerekben futtatja a k3s-t, így egy teljes fürt elfér egy laptopon, és egyetlen paranccsal eltüntethető. Az összes Nexus-kiadást tesztelő kiadási eszközök pontosan így építik fel a fürtjeiket, és a beállításaik átmásolásával megkímélheti magát azoktól a problémáktól, amelyekkel ők már szembesültek.

Szüksége lesz a Dockerre, a k3d 5.8.3-ra, a kubectl eszközre, a Helm v4-re és a Chrome-ra. Tomás a Mac gépét használta.

A fürt létrehozása

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

Minden kapcsolónak megvan az oka.

  • A --agents 0 egy szervercsomópontot ad, munkavégző csomópontok nélkül. A Nexus gond nélkül fut egyetlen csomóponton, egy második pedig csak memóriát fogyaszt.
  • Az --image rancher/k3s:v1.33.6-k3s1 rögzíti azt a k3s-verziót, amelyen minden kiadást tesztelnek. Enélkül azt kapja, amit a k3d alapértelmezettként használ.
  • A --disable=traefik@server:0 kihagyja a Traefiket. Egy laptopnak nincs kiszolgálható nyilvános címe, és a konzolt ehelyett a saját HTTPS előtétjén keresztül éri el (lásd alább).
  • A --wait --timeout 300s csak akkor tér vissza, amikor a fürt válaszol, vagy öt perc után hibával leáll.

Ha tükrözi a kiadási rendszerleíró adatbázist (registry) a laptopján, adja hozzá a --registry-config <registries.yaml> kapcsolót, hogy a képfájlok lehívását a tükörre irányítsa, valamint a --k3s-arg "--disable-default-registry-endpoint@server:0" kapcsolót, hogy semmi se essen vissza egy felsőbb szintű rendszerleíró adatbázisra. A kiadási eszközök így futnak, és minden képfájl kizárólag a tükrön keresztül érkezik.

A cert-manager telepítése

A chart létrehozza a saját helyi CA-ját, a nexus-local-ca-t mint cert-manager kibocsátót, és minden szolgáltatás ettől kapja a tanúsítványát. A cert-manager erőforrásai nélkül a fürtben a helm install másodperceken belül elutasítja a chartot. Először telepítse a cert-manager v1.21.3 verziót a cert-manager projekt által közzétett chartból:

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

A Nexusnak semmi másra nincs szüksége a cert-managertől, különösen nem a trust-managerre.

A Nexus telepítése

  1. Írjon egy values fájlt a laptophoz. A TLS a saját előtétjénél végződik, így a tls.mode értéke 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. Telepítse a chartot a rendszerleíró adatbázisból, és hagyja ki a --wait kapcsolót (az alábbi figyelmeztetés elmagyarázza, miért).
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. Ezután várja meg a számítási feladatokat saját maga:
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

A StatefulSet ciklus azért van ott, mert némelyikük kérésre egyszerre csak egy podot frissít, és a kubectl rollout status elutasítja ezeket. A readyReplicas állapota való várakozás minden frissítési stratégiával működik.

Amikor mindkét parancs visszatér, minden Deployment Available állapotú, és minden StatefulSet podjai készen állnak. Még senki sem tud bejelentkezni. Ez így helyes: a telepítést még nem vették birtokba.

Miért nem tud soha bejelentkezni porttovábbítással (port-forward)

A következő kézenfekvő lépés a kubectl port-forward svc/nexus-alpha 3000:3000 és egy böngésző megnyitása a http://127.0.0.1:3000 címen. A konzol oldalai betöltődnek, így úgy tűnik, mintha működne. Azonban nem működik, és semmilyen beállítással nem is tehető működővé. Három dolog áll az útjában, mindegyik szándékosan.

Mi akadályozza meg Miért
Az eredet (origin) A konzol bejelentkezése elutasítja az olyan kérést, amelynek eredete nem https://<hosts.console>, jelen esetben https://console.harrow.example. A http://127.0.0.1:3000 címről kiszolgált oldal eredete nem megfelelő, így a bejelentkezés el sem indul.
A süti A munkamenet egy Secure jelölésű __Host- süti. A böngészők az ilyen sütit csak HTTPS-en keresztül tárolják, tartományattribútum nélkül, pontosan ahhoz az állomáshoz, amelyik beállította. Egyszerű HTTP-n keresztül a böngésző eldobja.
A hozzáférési kulcs (passkey) Az első rendszergazda hozzáférési kulccsal jelentkezik be, a hozzáférési kulcshoz pedig érvényes tanúsítvánnyal rendelkező biztonságos környezet szükséges. A Chrome megtagadja a hozzáférési kulcs létrehozását tanúsítványfigyelmeztetés mögött, még akkor is, ha továbbkattintott rajta.

Tehát a böngészőnek a https://console.harrow.example címmel kell kommunikálnia egy általa megbízhatónak tartott tanúsítvánnyal, és ennek a névnek a laptopjára kell vezetnie.

A konzol elérése HTTPS-en keresztül a laptopján

Az alábbi módszer a chart saját CA-ját használja a tanúsítvány kibocsátásához, egy porttovábbítást a konzol eléréséhez, valamint egy külön Chrome-profilt, amely megbízik ebben az egyetlen CA-ban, és a konzol nevét a laptopjára képezi le. A rendszer megbízhatósági tárolója és az /etc/hosts változatlan marad.

Az ábrán bal oldalon a Chrome látható, „külön profil: csak a nexus-local-ca-ban bízik meg; console.harrow.example:443 leképezve a 127.0.0.1:28443 címre” felirattal. Egy „HTTPS” feliratú nyíl a „HTTPS előtét a 127.0.0.1:28443 címen (tanúsítvány a nexus-local-ca-tól)” dobozhoz vezet. Egy „HTTP, Host megtartva, X-Forwarded-Proto https” feliratú nyíl a „kubectl port-forward 127.0.0.1:3000” dobozhoz vezet, egy utolsó nyíl pedig a k3d-fürt dobozába, a „Service nexus-alpha, port http (3000)” elemhez. A fürtön belüli cert-managertől az előtét dobozához vezető szaggatott vonal felirata: „kibocsátja a tanúsítványt”.
Hogyan éri el a laptopon lévő böngésző a k3d-fürtben lévő konzolt HTTPS-en keresztül.

Tanúsítvány kibocsátása a konzol nevére

  1. Kérjen a cert-managertől egy tanúsítványt a konzol állomásnevére, amelyet a chart kibocsátója írt alá:
# 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

A cert-manager a fürtön belül írja alá. Ön soha nem olvassa be a CA privát kulcsát.

  1. Másolja ki a tanúsítványt, a kulcsát és a CA-tanúsítványt a Secretből:
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. Számítsa ki a CA rögzítési értékét (pin). A Chrome a nyilvános kulcs base64 SHA-256 értéke alapján azonosítja a megbízható kulcsot:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

A CA kulcsát rögzítse, ne a tanúsítványét. A tanúsítvány egy napig érvényes, és minden alkalommal új kulcsot kap, amikor a cert-manager megújítja, míg a CA változatlan marad.

HTTPS előtét elhelyezése a porttovábbítás elé

  1. Továbbítsa a konzol Service-ét. A portja a http nevű, amely ebben a kiadásban a 3000:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Futtasson egy HTTPS figyelőt a 127.0.0.1:28443 címen, amely a 127.0.0.1:3000 címre továbbít. Bármilyen, Ön által már megbízhatónak tartott fordított proxy megfelel, amennyiben elvégzi a következő négy dolgot:
    • kiszolgálja a tls.crt, majd a ca.crt fájlt láncként, a tls.key kulccsal;
    • megtartja a Host fejlécet console.harrow.example értékként;
    • beállítja az X-Forwarded-Proto: https fejlécet;
    • átengedi a WebSocket-frissítéseket, mert a konzol használja azokat.

Egy Service-hez irányuló porttovábbítás ahhoz az egyetlen podhoz kötődik, amelyet az induláskor kiválasztott. Miután egy frissítés vagy újraindítás lecseréli a konzol podját, a továbbítás fennmarad, de a semmibe továbbít, a böngésző pedig hibás átjárót (bad gateway) jelez. Indítsa újra a porttovábbítást, valahányszor a konzol podja megváltozik.

A Chrome megnyitása a rögzítéssel és a névleképezéssel

Mac gépen:

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

A <ca-pin> az openssl sor kimenete. Linuxon indítsa el a Chrome-ot ugyanezzel a három kapcsolóval.

A három kapcsoló együtt működik. A --host-resolver-rules elküldi a 443-as porton lévő console.harrow.example címet az előtétjéhez, kizárólag ezen a profilon belül. Az --ignore-certificate-errors-spki-list megbízik az ezen egyetlen CA-kulcs által kibocsátott tanúsítványokban, és a Chrome ezt csak a --user-data-dir kapcsolóval együtt veszi figyelembe. A külön profil távol tartja a kivételt a mindennapi böngészéstől. Ez nem egy általános „tanúsítványhibák figyelmen kívül hagyása” kapcsoló: minden, amit nem a fürt CA-ja írt alá, továbbra is hibát fog jelezni.

Ha ez a profil nyitva van, a https://console.harrow.example/install a birtokbavételi oldalra vezet, és létrehozható a hozzáférési kulcs. A 2.12. fejezet (Az első indítás) innen folytatja.

Amikor a laptop újraindul

A kulcstároló két részből áll: magából a kulcstárolóból és egy kis feloldóból (unsealer), amely a feloldókulcsát tárolja. A csomópont bármilyen újraindítása után (Docker-újraindítás, a laptop újraindítása, k3d cluster stop és start) a feloldó lezárt állapotban indul. A kulcstároló ezen keresztül oldja fel magát, így amíg egy kulcsőrző fel nem oldja a feloldót a saját age személyazonosságával, semmi sem működik, amihez kulcs szükséges. Ez a tervezés sajátossága, és egy éles fürtön is ugyanígy működik. A 2.15. fejezet (Második nap: a Nexus üzemeltetése) bemutatja a feloldást.

Amikor végzett a kiértékeléssel:

k3d cluster delete harrow-eval

A fürt törlése törli a telepítést és mindent, ami benne van.

nexusctl kubeconfig

A nexusctl install --single-node által felépített fürt a nexusctl tulajdona. Ha el szeretné érni a kubectl, helm vagy bármely más eszközzel, kérje le a kubeconfig fájlját:

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

A fájl teljes rendszergazdai hozzáférést biztosít a fürthöz. Tartsa 600-as jogosultsági módban azon személyek gépein, akik a telepítést üzemeltetik, és sehol máshol. A 2. rész minden későbbi parancsa, amely --context kapcsolót fogad el vagy KUBECONFIG változót olvas be, ezen a fájlon keresztül működik egyetlen csomópont esetén. Ugyanez vonatkozik a frissítésre is: a nexusctl upgrade plan --bundle <file> és a nexusctl upgrade apply --bundle <file> egyetlen csomóponton a nexusctl tulajdonában lévő k3s-fürtöt is frissíti.

Az ábra négy rétegből álló vermet mutat egy „egyetlen Linux-szerver” feliratú dobozon. Alulról felfelé: „k3s v1.33.6+k3s1 (Traefik a kube-system névtérben, 80-as és 443-as port)”, majd „cert-manager v1.21.3 és a chart helyi CA-ja, a nexus-local-ca”, ezután „Nexus adatréteg: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao”, végül „Nexus szolgáltatások: konzol, bejelentkezés, átjáró és a többi”. Jobb oldalon a legfelső rétegből három nyíl hagyja el a dobozt console.harrow.example, api.harrow.example és auth.harrow.example felirattal. Bal oldalon egy „nexusctl kubeconfig” feliratú terminálikon mutat a k3s rétegbe.
Mit helyez el a nexusctl install --single-node egyetlen Linux-szerveren.

Mi vihető át egy klaszterre

Mindennek, amit egyetlen gépen elvégzett, megvan a megfelelője egy fürtön is. A values fájl ugyanaz a fájl, csak más rendszerleíró adatbázissal, TLS-móddal vagy tárolási osztállyal, ahogy azt a 2.11. fejezet (Variációk: külső tárolók, TLS és ingress) bemutatja. Az első indítás megegyezik. Ami nem vihető át, az maga a telepítés: a telepítés neve véglegesen rögzített, és egy telepítést nem lehet átemelni egy laptopról egy szerverre. Amikor Tomás a laptopjáról átköltözött a kísérleti szerverre, elölről kezdte egy új névvel (harrow-pilot), a harrow-eval nevet pedig megtartotta kísérletezésre.