Logi sisseBroneerige tutvustus

Peatükk 2.8

Ühe masina paigaldused

Paigaldage Nexus ühele Linux-serverile tööriistaga nexusctl või katsetage seda sülearvutis tööriistaga k3d ning avage konsool üle HTTPS-i, et sisselogimine ja pääsuvõtmed töötaksid.

Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

18 minutit lugemist

Enne kui Harrow Port Authority pani Nexuse oma tööklastrisse, soovis Tomás Reilly teha kaks väiksemat paigaldust. Üks oli pilootprojekt operatsioonihoones asuvas varu-Linuxi serveris kaheteistkümnele inimesele, kes pidid seda esimesena proovima. Teine töötas tema enda sülearvutis, et ta saaks asju katki teha ilma, et keegi märkaks. See peatükk käsitleb mõlemat. Need kasutavad sama diagrammi (chart), samu tõmmiseid ja sama esmast käivitust nagu täielik Kubernetese paigaldus, nii et ühes masinas õpitu kandub edasi.

Serveri teekond koosneb ühest käsust: nexusctl install --single-node ehitab masinasse k3s klastri, paigaldab cert-manageri ja seejärel paigaldab Nexuse. Sülearvuti teekond nõuab rohkem käsitööd. Te ehitate ise k3d klastri, paigaldate Helmi abil cert-manageri ja diagrammi ning teete seejärel ühe lisatöö, mis valmistab peaaegu kõigile ootamatusi: panete konsooli oma masinas HTTPS-i taha, sest tavaline pordisuunamine ei saa kedagi sisse logida.

Kui võimas peab masin olema

Nexus küsib diagrammi vaikeseadetega päringutes (requests) umbes 2.05 CPU (central processing unit, keskprotsessor) tuuma ja 6.7 GiB mälu ning selle andmemahud ulatuvad kokku 142 GiB-ni. See kogumaht jaguneb järgmiselt: PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, objektihoidla 50, kaks OpenBao hoidlat 1 ja 5 ning kviitungite andmemaht 1. Päringud on see maht, mille plaanur reserveerib, ning tegelik kasutus on suurem, kui inimesed tööle hakkavad.

Masin CPU Mälu (RAM, random-access memory, muutmälu) Ketas
Soovitatav üksiksõlm 8 vCPU 32 GiB 250 GB SSD (solid-state drive, pooljuhtketas)
Miinimum hindamiseks 4 vCPU 16 GiB 200 GB

Hindamise miinimumnõuetele vastav sülearvuti käitab Nexust, kuid loeb Dockeri enda mälupiirang, mitte sülearvuti oma. Andke Dockerile enne alustamist vähemalt 16 GiB.

Mõlemad teekonnad vajavad Kubernetese versiooni 1.33 või uuemat. Üksiksõlme teekond toob kaasa enda oma: k3s v1.33.6+k3s1, mis on distributsioon, millel iga väljalaset testitakse.

Esimene osa: üks Linux-server tööriistaga nexusctl

Tomási pilootserver on 8-tuumaline masin 32 GiB mälu ja 500 GB SSD-ga, millel töötab ajakohane Linux ja kus pole midagi muud. Paigaldus vajab juurkasutaja (root) õigusi, kuna see paigaldab k3s-i süsteemiteenusena.

Hankige nexusctl ja kontrollige seda

  1. Laadige https://downloads.adverant.ai/nexus/1.0.0-alpha.1/-st alla oma arhitektuurile vastav nexusctl koos väljalaske avaliku võtmega. Salvestage võti nimega release.pub. Peatükk 2.4, Väljalaske hankimine ja kinnitamine, selgitab, kuidas kontrollida võtme sõrmejälge Adveranti avaldatud sõrmejälje suhtes.
  2. Kontrollige binaarfaili ja väljalaset võtme abil:
nexusctl version --json
nexusctl verify

nexusctl verify kontrollib allalaaditud faili Adveranti väljalaskevõtme suhtes ja keeldub kõigest, mida see ei suuda kinnitada. Kui see ebaõnnestub, peatuge ja laadige uuesti alla. Ärge kunagi käivitage paigaldust failist, mille kinnitamine ebaõnnestus.

Looge võtmehoidja võti

Paigalduse võtmehoidla pitseerib oma taastevõtmed ühele või mitmele võtmehoidjale (custodian). Võtmehoidja on isik, kes hoiab võrguühenduseta age'i identiteedifaili, ning diagramm keeldub paigaldamisest ilma vähemalt ühe võtmehoidjata. Võtmehoidja enda masinas:

age-keygen -o custodian.key

Fail algab reaga # public key: age1.... See avalik pool on see, mis läheb väärtuste faili. Identiteedifail ise ei lahku kunagi võtmehoidja masinast. Secure Enclave'iga Macis loob age-plugin-se keygen --access-control=any-biometry -o custodian.key võtme, mille kasutamiseks on vaja Touch ID-d, ja selle avalik pool algab reaga age1se1.

Kirjutage väärtuste fail

# 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> on age1... rida failist custodian.key. Lisage loendisse üks kirje iga võtmehoidja kohta.

keys.installationName on püsiv. Võtmehoidla esimene käivitamine vermib paigalduse identiteedi selle nime all ja miski ei nimeta seda hiljem ümber. See peab vastama mustrile ^[a-z][a-z0-9-]{0,62}$: väiketähed, algab tähega, kõige rohkem 63 tähemärki. Ärge kopeerige nexus-example ega näidissaajat diagrammi enda näidisfailidest. Diagramm keeldub mõlemast nime alusel ja eelkontroll (preflight) raporteerib samad koodid esimesena.

Need kolm hosti on paigalduse identiteet. Iga teenus keeldub ilma nendeta käivitumast ning iga sisselogimine, küpsis ja pääsuvõti on seotud väärtusega hosts.console. Valige nimed, mida soovite kasutada ka viie aasta pärast.

Suunake kolm nime serverile

Inimesed jõuavad konsooli, API (application programming interface, rakendusliides) ja sisselogimisteenuse juurde läbi k3s-i sisseehitatud ingress-kontrolleri Traefiku, mis asub serveri portidel 80 ja 443. Lisage kolm DNS-i (Domain Name System, domeeninimede süsteem) kirjet nimedele console.harrow.example, api.harrow.example ja auth.harrow.example, millest igaüks viitab serveri aadressile. Eelkontroll kontrollib iga nime ja ütleb teile, millisel kirje puudub.

Diagrammi võrgupoliitika lubab ainult ühel nimeruumil jõuda kolme avaliku teenuseni. Selle vaikeväärtus kube-system on koht, kus k3s käitab Traefikut, nii et üksiksõlmel jätate networkPolicy.ingressNamespace puutumata.

Käivitage eelkontroll, seejärel paigaldage

  1. Käivitage eelkontroll üksiksõlme lipuga. See loeb masinat ja teie väärtuste faili ega muuda midagi.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Lugege lõpus olevat kokkuvõtterida. Hoiatus ei blokeeri kunagi paigaldust, kuid tõrge teeb seda ja iga ebaõnnestunud rida sisaldab rida 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. Paigaldage. Lipp --edition peab ühtima väärtuste failis oleva väärtusega edition.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Jälgige selle tööd. See käivitab uuesti eelkontrolli, paigaldab k3s v1.33.6+k3s1, paigaldab cert-manager v1.21.3, paigaldab Nexuse ja ootab, kuni iga teenus vastab oma tervisekontrollile. Tomási serveris võttis see aega veidi alla kümne minuti.
 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

Hoidke see sõrmejälg ekraanil. Te võrdlete seda brauseris, kui võtate paigalduse koodi abil enda nimele. Kui kood aegub enne selle kasutamist, loob nexusctl claim-code --administrator <email> uue. Peatükk 2.12, Esimene käivitus, jätkab sealt edasi.

Paigaldage Community väljaanne
Paigaldage Community väljaanne
Community paigaldus ühes serveris koosneb allalaadimisest, kontrollimisest, eelkontrollist ja paigaldamisest, millele järgneb esimene administraator. Litsentsi sammu ei ole.

Paigaldage sertifikaat

Väärtusega tls.mode: existing teenindavad kolm ingress-marsruuti sertifikaati, mis asub tls.existingSecret poolt nimetatud Secretis. See peab katma kõiki kolme hosti. Eelkontroll loeb seda Secretit, kui see on olemas, ja hoiatab, kui sertifikaat aegub 30 päeva jooksul. Kui Secretit veel pole, käsib rida teil selle luua, ja see on hoiatus, mitte tõrge.

Üksiksõlmel ei eksisteeri klastrit enne, kui paigaldus on selle loonud, seega looge Secret kohe pärast paigaldust. Kirjutage esmalt välja klastri kubeconfig (selle peatüki viimane jaotis selgitab seda), seejärel looge sellega 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 sisaldab sertifikaati, millele järgnevad mis tahes vahesertifikaadid, ja harrow-public.key selle privaatvõtit. Kui teie sertifikaadid pärinevad privaatsest CA-st (certificate authority, sertifitseerimiskeskus), võtavad nexusctl preflight ja nexusctl install vastu lipu --ca-bundle <file>, et nad saaksid ahelat kontrollida. Teised viisid TLS-i (Transport Layer Security, transpordikihi turbeprotokoll) haldamiseks on toodud peatükis 2.11, Variatsioonid: välised hoidlad, TLS ja ingress.

Kui see ebaõnnestub

Mida te näete Mida see tähendab Mida teha
PREFLIGHT_FAILED (409) Eelkontroll leidis tõrke, mistõttu paigaldus ei alanud. Midagi ei paigaldatud. Parandage iga ebaõnnestunud rida, kasutades selle fix rida, ja käivitage paigaldus uuesti.
INSTALLATION_NAME_MISSING keys.installationName on tühi. Määrake paigalduse enda püsiv nimi.
INSTALLATION_NAME_EXAMPLE Nimi pärineb diagrammi näidisväärtustest. Valige oma nimi.
KEYS_CUSTODIAN_MISSING keys.custody.recipients on tühi. Lisage iga võtmehoidja avalik age1... saaja.
KEYS_CUSTODIAN_EXAMPLE Saaja on diagrammi näidisvõtmehoidja, kelle identiteeti pole kellelgi. Asendage see oma võtmehoidjate saajatega.

nexusctl väljub koodiga 0, kui see saab jätkata, koodiga 1, kui kontroll selle blokeeris, ja koodiga 2, kui seda ei saanud üldse käivitada (loetamatu väärtuste fail, vale lipp). Skript saab nende kolme põhjal hargneda.

Teine osa: katsetamine sülearvutis tööriistaga k3d

k3d käitab k3s-i Dockeri konteinerite sees, nii et terve klaster elab sülearvutis ja kaob ühe käsuga. Väljalasketööriistad, mis testivad iga Nexuse väljalaset, ehitavad oma klastrid täpselt sel viisil ning nende seadete kopeerimine säästab teid nende probleemide taasavastamisest, millega nad juba kokku puutusid.

Te vajate Dockerit, k3d 5.8.3, kubectl-i, Helm v4 ja Chrome'i. Tomás kasutas oma Maci.

Looge klaster

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

Igal lipul on oma põhjus.

  • --agents 0 annab ühe serverisõlme ja mitte ühtegi töölist (worker). Nexus töötab edukalt ühel sõlmel ja teine vaid kulutab mälu.
  • --image rancher/k3s:v1.33.6-k3s1 fikseerib k3s-i versiooni, millel iga väljalaset testitakse. Ilma selleta saate versiooni, mida k3d vaikimisi kasutab.
  • --disable=traefik@server:0 jätab Traefiku välja. Sülearvutil pole avalikku aadressi, mida teenindada, ja te jõuate konsoolini hoopis omaenda HTTPS-i esikülje kaudu (allpool).
  • --wait --timeout 300s naaseb ainult siis, kui klaster vastab, või ebaõnnestub viie minuti pärast.

Kui peegeldate väljalaskeregistrit oma sülearvutis, lisage --registry-config <registries.yaml>, et suunata tõmmiste tõmbamised peeglisse, ja --k3s-arg "--disable-default-registry-endpoint@server:0", et miski ei langeks tagasi ülesvoolu registrisse. Väljalasketööriistad töötavad sel viisil, kusjuures iga tõmmis tuleb ainult läbi peegli.

Paigaldage cert-manager

Diagramm loob oma kohaliku CA, nexus-local-ca, cert-manageri väljaandjana (issuer) ja iga teenus saab oma sertifikaadi sellelt. Ilma cert-manageri ressurssideta klastris keeldub helm install diagrammist sekundite jooksul. Paigaldage esmalt cert-manager v1.21.3 diagrammist, mille avaldab cert-manageri projekt:

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

Nexus ei vaja cert-managerilt midagi muud ja eelkõige mitte trust-manageri.

Paigaldage Nexus

  1. Kirjutage sülearvuti jaoks väärtuste fail. TLS lõpeb teie enda esiküljel, seega tls.mode on 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. Paigaldage diagramm registrist ja jätke --wait välja (allolev hoiatus ütleb, miks).
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. Seejärel oodake töökoormusi ise:
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

StatefulSeti tsükkel on seal seetõttu, et mõned neist uuendavad nõudmisel ühte podi korraga ja kubectl rollout status keeldub nendest. readyReplicas järel ootamine töötab iga uuendusstrateegia puhul.

Kui mõlemad käsud naasevad, on iga Deployment saadaval (Available) ja iga StatefulSeti podid on valmis. Keegi ei saa veel sisse logida. See on õige: paigaldus on veel enda nimele võtmata.

Miks pordi suunamine (port-forward) ei lase kunagi sisse logida

Ilmselge järgmine käik on kubectl port-forward svc/nexus-alpha 3000:3000 ja brauser aadressil http://127.0.0.1:3000. Konsooli lehed laadivad, nii et tundub, nagu see töötaks. See ei tööta ja ükski seadistus ei pane seda tööle. Ees seisab kolm takistust, igaüks neist meelega.

Mis seda takistab Miks
Päritolu (origin) Konsooli sisselogimine keeldub päringust, mille päritolu ei ole https://<hosts.console>, siin https://console.harrow.example. Aadressilt http://127.0.0.1:3000 teenindataval lehel on vale päritolu, mistõttu sisselogimine ei alga kunagi.
Küpsis Sessioon on __Host- küpsis märgendiga Secure. Brauserid salvestavad sellise küpsise ainult üle HTTPS-i, ilma domeeniatribuudita, täpselt selle hosti jaoks, mis selle määras. Üle tavalise HTTP viskab brauser selle minema.
Pääsuvõti (passkey) Esimene administraator logib sisse pääsuvõtmega ja pääsuvõti vajab turvalist konteksti koos kehtiva sertifikaadiga. Chrome keeldub loomast pääsuvõtit sertifikaadihoiatuse taga, isegi sellise taga, millest te edasi klõpsasite.

Seega peab brauser rääkima aadressiga https://console.harrow.example, kasutades sertifikaati, mida ta usaldab, ja see nimi peab viima teie sülearvutini.

Konsooli avamine sülearvutis üle HTTPS-i

Allolev meetod kasutab sertifikaadi väljaandmiseks diagrammi enda CA-d, konsoolini jõudmiseks pordisuunamist ja eraldi Chrome'i profiili, mis usaldab seda ühte CA-d ja vastendab konsooli nime teie sülearvutiga. Teie süsteemi usaldushoidla ja /etc/hosts jäävad samaks.

Joonisel on vasakul Chrome sildiga „eraldi profiil: usaldab ainult nexus-local-ca-d; console.harrow.example:443 on vastendatud aadressiga 127.0.0.1:28443”. Nool sildiga „HTTPS” läheb kasti „HTTPS-i esikülg aadressil 127.0.0.1:28443 (sertifikaat väljaandjalt nexus-local-ca)”. Nool sildiga „HTTP, Host säilitatud, X-Forwarded-Proto https” läheb kasti „kubectl port-forward 127.0.0.1:3000” ja viimane nool läheb k3d klastri kasti sisse üksuseni „Service nexus-alpha, port http (3000)”. Katkendjoon klastri sees asuvast cert-managerist esikülje kasti juurde kannab silti „annab sertifikaadi välja”.
Kuidas sülearvuti brauser jõuab k3d klastris asuva konsoolini üle HTTPS-i.

Andke konsooli nimele välja sertifikaat

  1. Küsige cert-managerilt konsooli hosti jaoks sertifikaati, mille on allkirjastanud diagrammi väljaandja:
# 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 allkirjastab selle klastri sees. Te ei loe kunagi CA privaatvõtit.

  1. Kopeerige sertifikaat, selle võti ja CA sertifikaat Secretist välja:
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. Arvutage välja CA kinnitus (pin). Chrome tuvastab usaldusväärse võtme selle avaliku võtme base64 SHA-256 räsi järgi:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Kinnitage CA võti, mitte sertifikaadi oma. Sertifikaat kehtib ühe päeva ja saab iga kord uue võtme, kui cert-manager seda uuendab, samas kui CA jääb samaks.

Pange HTTPS-i esikülg pordisuunamise ette

  1. Suunake edasi konsooli Service. Selle port on see, mille nimi on http, mis selles väljalaskes on 3000:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Käivitage aadressil 127.0.0.1:28443 HTTPS-i kuulaja, mis suunab edasi aadressile 127.0.0.1:3000. Sobib iga pöördproksi (reverse proxy), mida te juba usaldate, kui see teeb nelja asja:
    • teenindab ahelana faili tls.crt, millele järgneb ca.crt, koos võtmega tls.key;
    • hoiab Host päise väärtusena console.harrow.example;
    • määrab päise X-Forwarded-Proto: https;
    • laseb läbi WebSocketi ülendamised (upgrades), kuna konsool kasutab neid.

Pordisuunamine Service'ile seob selle ühe podi, mille see käivitumisel valis. Pärast seda, kui uuendamine või taaskäivitamine asendab konsooli podi, jääb suunamine püsti ja suunab tühjusesse ning brauser näitab vigast lüüsi (bad gateway). Taaskäivitage pordisuunamine iga kord, kui konsooli pod muutub.

Avage Chrome koos kinnituse ja nimevastendusega

Macis:

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> on rea openssl väljund. Linuxis käivitage Chrome samade kolme lipuga.

Need kolm lippu töötavad koos. --host-resolver-rules saadab aadressi console.harrow.example pordil 443 teie esiküljele ainult selle profiili sees. --ignore-certificate-errors-spki-list usaldab selle ühe CA võtme poolt välja antud sertifikaate ja Chrome arvestab seda ainult koos lipuga --user-data-dir. Eraldi profiil hoiab erandi eemal teie igapäevasest veebisirvimisest. See ei ole üldine „eira sertifikaadivigu” lüliti: kõik, mida pole allkirjastanud klastri CA, ebaõnnestub endiselt.

Kui see profiil on avatud, viib https://console.harrow.example/install paigalduse enda nimele võtmise lehele ja saab luua pääsuvõtme. Peatükk 2.12, Esimene käivitus, jätkab siit edasi.

Kui sülearvuti taaskäivitub

Võtmehoidlal on kaks osa: võtmehoidla ise ja väike lahtipitseerija (unsealer), mis hoiab selle avamisvõtit. Pärast mis tahes sõlme taaskäivitust (Dockeri taaskäivitus, sülearvuti alglaadimine, k3d cluster stop ja start) käivitub lahtipitseerija pitseerituna. Võtmehoidla pitseerib end lahti selle kaudu, nii et kuni võtmehoidja ei pitseeri lahtipitseerijat lahti omaenda age'i identiteediga, ei tööta miski, mis vajab võtit. See on disaini omadus ja see on samamoodi ka tööklastris. Peatükk 2.15, Teine päev: Nexuse käitamine, näitab lahtipitseerimist.

Kui olete hindamise lõpetanud:

k3d cluster delete harrow-eval

Klastri kustutamine kustutab paigalduse ja kõik selles sisalduva.

nexusctl kubeconfig

Klaster, mille nexusctl install --single-node ehitas, kuulub tööriistale nexusctl. Et jõuda selleni tööriistaga kubectl, helm või mõne muu tööriistaga, küsige selle kubeconfigi:

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

See fail annab klastrile täieliku administraatori juurdepääsu. Hoidke seda õigustes 600 nende inimeste masinates, kes paigaldust käitavad, ja mitte kusagil mujal. Iga hilisem 2. osa käsk, mis võtab lipu --context või loeb muutujat KUBECONFIG, töötab selle faili kaudu üksiksõlme vastu. Sama kehtib ka uuendamise kohta: nexusctl upgrade plan --bundle <file> ja nexusctl upgrade apply --bundle <file> uuendavad üksiksõlmel ka k3s-i klastrit, mida nexusctl omab.

Joonis on neljast kihist koosnev virn kastil sildiga „üks Linuxi server”. Alt üles: „k3s v1.33.6+k3s1 (Traefik nimeruumis kube-system, pordid 80 ja 443)”, seejärel „cert-manager v1.21.3 ja diagrammi kohalik CA nexus-local-ca”, seejärel „Nexuse andmekiht: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao”, seejärel „Nexuse teenused: konsool, sisselogimine, lüüs ja ülejäänud”. Paremal väljuvad ülemisest kihist kastist kolm noolt siltidega console.harrow.example, api.harrow.example ja auth.harrow.example. Vasakul osutab terminali ikoon sildiga „nexusctl kubeconfig” k3s-i kihti.
Mida nexusctl install --single-node paneb ühte Linuxi serverisse.

Mis kandub üle klastrisse

Kõigel, mida tegite ühes masinas, on vaste klastris. Väärtuste fail on sama fail, kuid erineva registri, TLS-režiimi või salvestusklassiga (storage class), nagu näitab peatükk 2.11, Variatsioonid: välised hoidlad, TLS ja ingress. Esimene käivitus on identne. Mis üle ei kandu, on paigaldus ise: paigalduse nimi on lõplikult fikseeritud ja paigaldust ei saa tõsta sülearvutist serverisse. Kui Tomás kolis oma sülearvutist pilootserverisse, alustas ta uuesti uue nimega harrow-pilot ja jättis harrow-eval katsetuste jaoks.