PrisijungtiUžsisakyti pristatymą

2.8 skyrius

Diegimas viename kompiuteryje

Įdiekite Nexus viename Linux serveryje naudodami nexusctl arba išbandykite jį nešiojamajame kompiuteryje su k3d ir pasiekite pultą per HTTPS, kad veiktų prisijungimas ir prieigos raktai.

Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

18 min. skaitymo

Prieš tai, kai Harrow Port Authority įdiegė Nexus savo gamybiniame klasteryje, Tomás Reilly norėjo atlikti du mažesnius diegimus. Vienas buvo bandomasis diegimas atsarginiame Linux serveryje operacijų pastate, skirtas dvylikai žmonių, kurie jį išbandys pirmieji. Kitas veikė jo paties nešiojamajame kompiuteryje, kad jis galėtų eksperimentuoti ir daryti klaidas niekam nepastebint. Šiame skyriuje aptariami abu variantai. Juose naudojama ta pati diagrama (chart), tie patys atvaizdai (images) ir tas pats pirmasis paleidimas kaip ir pilno Kubernetes diegimo atveju, todėl tai, ko išmoksite viename kompiuteryje, pravers ir kitur.

Serverio diegimo būdas reikalauja vienos komandos: nexusctl install --single-node sukuria k3s klasterį kompiuteryje, įdiegia cert-manager ir tada įdiegia Nexus. Nešiojamojo kompiuterio būdas reikalauja daugiau rankinio darbo. Jūs patys sukuriate k3d klasterį, įdiegiate cert-manager ir diagramą naudodami Helm, o tada atliekate vieną papildomą užduotį, kuri pakiša koją beveik visiems: savo kompiuteryje pultą (console) paslepiate už HTTPS, nes paprastas prievado peradresavimas (port-forward) niekada neleis niekam prisijungti.

Kokio dydžio turi būti kompiuteris

Naudojant numatytąsias diagramos reikšmes, Nexus užklausose prašo apie 2.05 CPU (centrinio procesoriaus) branduolių ir 6.7 GiB atminties, o jo tomai (volumes) iš viso sudaro 142 GiB. Šią sumą sudaro: PostgreSQL – 50, Valkey – 5, Neo4j – 20, Qdrant – 10, objektų saugykla – 50, dvi OpenBao saugyklos – 1 ir 5, bei kvitų (receipts) tomas – 1. Užklausos nurodo, kiek išteklių rezervuoja planuoklis (scheduler), o realus naudojimas išauga, kai žmonės pradeda dirbti.

Kompiuteris CPU Atmintis (RAM, laisvosios kreipties atmintis) Diskas
Rekomenduojamas vienas mazgas 8 vCPU 32 GiB 250 GB SSD (puslaidininkis diskas)
Minimalūs reikalavimai išbandymui 4 vCPU 16 GiB 200 GB

Nešiojamasis kompiuteris, atitinkantis minimalius išbandymo reikalavimus, galės paleisti Nexus, tačiau svarbus yra paties Docker atminties limitas, o ne nešiojamojo kompiuterio. Prieš pradėdami, skirkite Docker bent 16 GiB.

Abiem būdams reikalinga Kubernetes 1.33 arba naujesnė versija. Vieno mazgo (single-node) būdas turi savo įrankį: k3s v1.33.6+k3s1 – distribuciją, su kuria testuojama kiekviena laida.

Pirmoji dalis: vienas Linux serveris su nexusctl

Tomás bandomasis serveris yra 8 branduolių kompiuteris su 32 GiB atminties ir 500 GB SSD disku, kuriame veikia šiuolaikinė Linux sistema ir nėra nieko kito. Diegimui reikalingos root teisės, nes k3s įdiegiamas kaip sisteminė paslauga.

Gaukite nexusctl ir jį patikrinkite

  1. Atsisiųskite savo architektūrai skirtą nexusctl iš https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ kartu su laidos viešuoju raktu. Išsaugokite raktą kaip release.pub. 2.4 skyriuje „Laidos gavimas ir patikrinimas“ paaiškinama, kaip patikrinti rakto kontrolinį kodą (fingerprint) su tuo, kurį skelbia Adverant.
  2. Patikrinkite dvejetainį failą ir laidą naudodami raktą:
nexusctl version --json
nexusctl verify

nexusctl verify patikrina atsisiųstą failą pagal Adverant laidos raktą ir atmeta viską, ko negali patvirtinti. Jei patikra nepavyksta, sustokite ir atsisiųskite dar kartą. Niekada nevykdykite diegimo iš failo, kurio nepavyko patvirtinti.

Sukurkite saugotojo raktą

Diegimo raktų saugykla užrakina savo atkūrimo raktus vienam ar keliems saugotojams (custodians). Saugotojas yra asmuo, kuris neprisijungęs prie tinklo (offline) saugo age tapatybės failą, o diagrama atsisako diegti sistemą be bent vieno tokio asmens. Paties saugotojo kompiuteryje:

age-keygen -o custodian.key

Failas prasideda eilute # public key: age1.... Ši viešoji dalis yra tai, kas įrašoma į reikšmių (values) failą. Pats tapatybės failas niekada nepalieka saugotojo kompiuterio. Mac kompiuteryje su Secure Enclave age-plugin-se keygen --access-control=any-biometry -o custodian.key sukuria raktą, kurio naudojimui reikalingas Touch ID, o jo viešoji dalis prasideda age1se1.

Parašykite reikšmių 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> yra age1... eilutė iš custodian.key. Pridėkite po vieną sąrašo įrašą kiekvienam saugotojui.

keys.installationName yra nuolatinis. Pirmasis raktų saugyklos paleidimas sukuria diegimo tapatybę šiuo pavadinimu, ir vėliau niekas negali jo pervadinti. Jis turi atitikti ^[a-z][a-z0-9-]{0,62}$: mažosios raidės, prasideda raide, daugiausia 63 simboliai. Nekopijuokite nexus-example ar pavyzdinio gavėjo iš pačios diagramos pavyzdinių failų. Diagrama atmeta abu pagal pavadinimą, o išankstinė patikra (preflight) pirmiausia praneša tuos pačius kodus.

Trys mazgai (hosts) sudaro diegimo tapatybę. Be jų kiekviena paslauga atsisako pasileisti, o kiekvienas prisijungimas, slapukas (cookie) ir prieigos raktas (passkey) yra susieti su hosts.console. Pasirinkite pavadinimus, kurių norėsite ir po penkerių metų.

Nukreipkite tris pavadinimus į serverį

Žmonės pasiekia pultą, API (programų sąsają) ir prisijungimo paslaugą per k3s integruotą įeinančio srauto valdiklį (ingress controller) Traefik, naudodami serverio 80 ir 443 prievadus. Pridėkite tris DNS (domenų vardų sistemos) įrašus, skirtus console.harrow.example, api.harrow.example ir auth.harrow.example, kurių kiekvienas nukreiptų į serverio adresą. Išankstinė patikra patikrina kiekvieną pavadinimą ir nurodo, kuris iš jų neturi įrašo.

Diagramos tinklo politika leidžia tik vienai vardų sričiai (namespace) pasiekti tris viešąsias paslaugas. Jos numatytoji reikšmė kube-system yra ten, kur k3s paleidžia Traefik, todėl viename mazge networkPolicy.ingressNamespace palikite nepakeistą.

Atlikite išankstinę patikrą, tada įdiekite

  1. Paleiskite išankstinę patikrą su vieno mazgo vėliavėle (flag). Ji nuskaito kompiuterio bei jūsų reikšmių failo duomenis ir nieko nekeičia.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Pabaigoje perskaitykite suvestinės eilutę. Įspėjimas niekada neblokuoja diegimo, tačiau klaida blokuoja, o kiekviena nepavykusi eilutė turi fix eilutę.
 ────────────────────────────────────────────────────────────
 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. Įdiekite. Vėliavėlė --edition turi sutapti su edition reikšmių faile.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Stebėkite eigą. Sistema dar kartą atlieka išankstinę patikrą, įdiegia k3s v1.33.6+k3s1, įdiegia cert-manager v1.21.3, įdiegia Nexus ir laukia, kol kiekviena paslauga atsakys į būklės patikrinimą (health check). Tomás serveryje tai užtruko šiek tiek mažiau nei dešimt minučių.
 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

Palikite šį kontrolinį kodą (fingerprint) ekrane. Jį palyginsite naršyklėje, kai patvirtinsite teises į diegimą naudodami kodą. Jei kodo galiojimas baigsis prieš jums jį panaudojant, nexusctl claim-code --administrator <email> sukurs naują. Tolesni veiksmai aprašyti 2.12 skyriuje „Pirmasis paleidimas“.

Community leidimo diegimas
Community leidimo diegimas
Community leidimo diegimas viename serveryje apima atsisiuntimą, patikrinimą, išankstinę patikrą ir diegimą, o tada – pirmojo administratoriaus sukūrimą. Licencijos žingsnio nėra.

Įkelkite sertifikatą į vietą

Naudojant tls.mode: existing, trys įeinančio srauto (ingress) maršrutai pateikia sertifikatą iš Secret objekto, kurio pavadinimas nurodytas tls.existingSecret. Jis turi apimti visus tris mazgus (hosts). Išankstinė patikra nuskaito šį Secret objektą, jei jis egzistuoja, ir įspėja, jei sertifikato galiojimas baigiasi per 30 dienų. Kai Secret objekto dar nėra, eilutėje nurodoma jį sukurti – tai yra įspėjimas, o ne klaida.

Viename mazge klasteris neegzistuoja, kol diegimo procesas jo nesukuria, todėl sukurkite Secret objektą iš karto po įdiegimo. Pirmiausia išsaugokite klasterio kubeconfig failą (tai paaiškinta paskutiniame šio skyriaus poskyryje), o tada naudodami jį sukurkite Secret objektą:

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 saugo sertifikatą ir po jo einančius tarpinius sertifikatus, o harrow-public.key – jo privatųjį raktą. Jei jūsų sertifikatai yra iš privačios CA (sertifikavimo institucijos), nexusctl preflight ir nexusctl install priima --ca-bundle <file>, kad galėtų patikrinti grandinę. Kiti TLS (transporto lygmens saugumo) valdymo būdai aprašyti 2.11 skyriuje „Variacijos: išorinės saugyklos, TLS ir įeinantis srautas“.

Jei tai nepavyksta

Ką matote Ką tai reiškia Ką daryti
PREFLIGHT_FAILED (409) Išankstinė patikra rado klaidą, todėl diegimas neprasidėjo. Niekas nebuvo įdiegta. Ištaisykite kiekvieną nepavykusią eilutę, vadovaudamiesi jos fix eilute, ir paleiskite diegimą iš naujo.
INSTALLATION_NAME_MISSING keys.installationName yra tuščias. Nustatykite paties diegimo nuolatinį pavadinimą.
INSTALLATION_NAME_EXAMPLE Šis pavadinimas yra paimtas iš diagramos pavyzdinių reikšmių. Pasirinkite savo pavadinimą.
KEYS_CUSTODIAN_MISSING keys.custody.recipients yra tuščias. Pridėkite kiekvieno saugotojo viešąjį age1... gavėją.
KEYS_CUSTODIAN_EXAMPLE Gavėjas yra diagramos pavyzdinis saugotojas, kurio tapatybės niekas neturi. Pakeiskite jį savo saugotojų gavėjais.

nexusctl grąžina išėjimo kodą 0, kai galima tęsti, 1 – kai patikra jį užblokavo, ir 2 – kai jo apskritai nepavyko paleisti (neperskaitomas reikšmių failas, netinkama vėliavėlė). Scenarijus (script) gali šakotis pagal šias tris reikšmes.

Antroji dalis: išbandymas nešiojamajame kompiuteryje su k3d

k3d paleidžia k3s Docker konteinerių viduje, todėl visas klasteris veikia nešiojamajame kompiuteryje ir išnyksta su viena komanda. Laidų įrankiai, kuriais testuojama kiekviena Nexus laida, kuria savo klasterius būtent taip, todėl nukopijavę jų nustatymus išvengsite problemų, su kuriomis jie jau susidūrė.

Jums reikės Docker, k3d 5.8.3, kubectl, Helm v4 ir Chrome. Tomás naudojo savo Mac kompiuterį.

Sukurkite 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

Kiekviena vėliavėlė turi savo paskirtį.

  • --agents 0 suteikia vieną serverio mazgą ir jokių darbuotojų (workers) mazgų. Nexus puikiai veikia viename mazge, o antrasis tik eikvoja atmintį.
  • --image rancher/k3s:v1.33.6-k3s1 užfiksuoja k3s versiją, su kuria testuojama kiekviena laida. Be jos gausite tą versiją, kurią pagal numatytuosius nustatymus parenka k3d.
  • --disable=traefik@server:0 neįtraukia Traefik. Nešiojamasis kompiuteris neturi viešojo adreso, kurį galėtų aptarnauti, todėl pultą pasieksite per savo paties HTTPS priekinę sąsają (žr. toliau).
  • --wait --timeout 300s grąžina atsakymą tik tada, kai klasteris atsako, arba nutraukia darbą po penkių minučių.

Jei savo nešiojamajame kompiuteryje naudojate laidos registro veidrodį (mirror), pridėkite --registry-config <registries.yaml>, kad atvaizdų atsisiuntimai būtų nukreipti į veidrodį, ir --k3s-arg "--disable-default-registry-endpoint@server:0", kad niekas nebūtų siunčiama iš pirminio (upstream) registro. Laidų įrankiai veikia būtent taip – kiekvienas atvaizdas gaunamas tik per veidrodį.

Įdiekite cert-manager

Diagrama sukuria savo vietinę CA nexus-local-ca kaip cert-manager išdavėją (issuer), ir kiekviena paslauga gauna savo sertifikatą iš jos. Jei klasteryje nėra cert-manager išteklių, helm install atmeta diagramą per kelias sekundes. Pirmiausia įdiekite cert-manager v1.21.3 iš diagramos, kurią skelbia cert-manager projektas:

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

Nexus iš cert-manager daugiau nieko nereikia, ypač nereikia trust-manager.

Įdiekite Nexus

  1. Parašykite reikšmių failą nešiojamajam kompiuteriui. TLS baigiasi jūsų paties priekinėje sąsajoje, todėl tls.mode yra 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. Įdiekite diagramą iš registro ir praleiskite --wait (toliau pateiktame įspėjime paaiškinta kodėl).
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. Tada patys palaukite, kol darbo krūviai (workloads) bus paruošti:
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

StatefulSet ciklas reikalingas todėl, kad kai kurie iš jų pagal užklausą atnaujina po vieną pod'ą vienu metu, o kubectl rollout status tokius atmeta. Laukimo sąlyga readyReplicas veikia su kiekviena atnaujinimo strategija.

Kai abi komandos baigia darbą, kiekvienas Deployment yra pasiekiamas (Available), o kiekvieno StatefulSet pod'ai yra paruošti. Niekas dar negali prisijungti. Taip ir turi būti: teisės į diegimą dar nepatvirtintos (unclaimed).

Kodėl prievado peradresavimas niekada neleis prisijungti

Akivaizdus kitas žingsnis būtų kubectl port-forward svc/nexus-alpha 3000:3000 ir naršyklės atidarymas adresu http://127.0.0.1:3000. Pulto puslapiai įsikrauna, todėl atrodo, kad viskas veikia. Tačiau taip nėra, ir joks nustatymas nepadės to išspręsti. Tam tyčia trukdo trys dalykai.

Kas tai sustabdo Kodėl
Kilmės šaltinis (origin) Pulto prisijungimo sistema atmeta užklausą, kurios kilmės šaltinis nėra https://<hosts.console>, šiuo atveju – https://console.harrow.example. Puslapis, pateiktas iš http://127.0.0.1:3000, turi netinkamą kilmės šaltinį, todėl prisijungimas net neprasideda.
Slapukas Sesija yra __Host- slapukas, pažymėtas Secure. Naršyklės tokį slapuką saugo tik per HTTPS, be domeno atributo, tiksliai tam mazgui (host), kuris jį nustatė. Naudojant paprastą HTTP, naršyklė jį tiesiog išmeta.
Prieigos raktas (passkey) Pirmasis administratorius prisijungia naudodamas prieigos raktą (passkey), o prieigos raktui reikalingas saugus kontekstas su galiojančiu sertifikatu. Chrome atsisako sukurti prieigos raktą, jei rodomas sertifikato įspėjimas, net jei jį patys praleidote.

Taigi naršyklė turi bendrauti su https://console.harrow.example, naudodama sertifikatą, kuriuo ji pasitiki, o šis pavadinimas turi nukreipti į jūsų nešiojamąjį kompiuterį.

Pulto pasiekimas per HTTPS jūsų nešiojamajame kompiuteryje

Toliau aprašytas metodas naudoja pačios diagramos CA sertifikatui išduoti, prievado peradresavimą (port-forward) pultui pasiekti ir atskirą Chrome profilį, kuris pasitiki šia viena CA ir susieja pulto pavadinimą su jūsų nešiojamuoju kompiuteriu. Jūsų sistemos patikimų sertifikatų saugykla ir /etc/hosts lieka nepakeisti.

Diagramoje kairėje pusėje pavaizduota Chrome naršyklė su užrašu „atskiras profilis: pasitiki tik nexus-local-ca; console.harrow.example:443 susietas su 127.0.0.1:28443“. Rodyklė su užrašu „HTTPS“ nukreipia į langelį „HTTPS priekinė sąsaja adresu 127.0.0.1:28443 (sertifikatas iš nexus-local-ca)“. Rodyklė su užrašu „HTTP, Host išlaikytas, X-Forwarded-Proto https“ nukreipia į „kubectl port-forward 127.0.0.1:3000“, o paskutinė rodyklė veda į k3d klasterio langelį prie „Service nexus-alpha, prievadas http (3000)“. Punktyrinė linija iš cert-manager klasterio viduje į priekinės sąsajos langelį yra pažymėta „išduoda sertifikatą“.
Kaip naršyklė nešiojamajame kompiuteryje per HTTPS pasiekia pultą k3d klasteryje.

Išduokite sertifikatą pulto pavadinimui

  1. Paprašykite cert-manager išduoti sertifikatą pulto mazgui, pasirašytą diagramos išdavėjo:
# 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 pasirašo jį klasterio viduje. Jūs niekada neskaitote CA privačiojo rakto.

  1. Nukopijuokite sertifikatą, jo raktą ir CA sertifikatą iš Secret objekto:
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. Apskaičiuokite CA rakto atspaudą (pin). Chrome atpažįsta patikimą raktą pagal jo viešojo rakto base64 SHA-256 reikšmę:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Priskirkite (pin) CA raktą, o ne sertifikato raktą. Sertifikatas galioja vieną dieną ir gauna naują raktą kiekvieną kartą, kai cert-manager jį atnaujina, o CA išlieka ta pati.

Pastatykite HTTPS priekinę sąsają priešais prievado peradresavimą

  1. Peradresuokite pulto Service objektą. Jo prievadas yra tas, kuris pavadintas http – šioje laidoje tai yra 3000:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Paleiskite HTTPS klausytoją (listener) adresu 127.0.0.1:28443, kuris peradresuotų į 127.0.0.1:3000. Tiks bet kuris atvirkštinis tarpinis serveris (reverse proxy), kuriuo jau pasitikite, jei tik jis atlieka keturis dalykus:
    • pateikia tls.crt ir po jo einantį ca.crt kaip grandinę, kartu su tls.key;
    • išlaiko Host antraštę kaip console.harrow.example;
    • nustato X-Forwarded-Proto: https;
    • praleidžia WebSocket atnaujinimo užklausas (upgrades), nes pultas jas naudoja.

Prievado peradresavimas į Service objektą susiejamas su tuo vienu pod'u, kurį jis pasirinko paleidimo metu. Kai po atnaujinimo ar perkrovimo pulto pod'as pakeičiamas nauju, peradresavimas lieka veikti, bet niekur nebeperadresuoja, o naršyklė rodo klaidingo šliuzo (bad gateway) klaidą. Kiekvieną kartą, kai pasikeičia pulto pod'as, paleiskite prievado peradresavimą iš naujo.

Atidarykite Chrome su rakto atspaudu ir pavadinimo susiejimu

Mac kompiuteryje:

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> yra openssl eilutės išvestis. Linux sistemoje paleiskite Chrome su tomis pačiomis trimis vėliavėlėmis.

Šios trys vėliavėlės veikia kartu. --host-resolver-rules siunčia console.harrow.example 443 prievadu į jūsų priekinę sąsają, tačiau tik šio profilio viduje. --ignore-certificate-errors-spki-list pasitiki sertifikatais, išduotais tuo vienu CA raktu, o Chrome tai pripažįsta tik kartu su --user-data-dir. Atskiras profilis apsaugo jūsų kasdienį naršymą nuo šios išimties. Tai nėra visuotinis jungiklis „ignoruoti sertifikatų klaidas“: bet kas, kas nėra pasirašyta klasterio CA, vis tiek bus atmesta.

Atidarius šį profilį, https://console.harrow.example/install nukreipia į teisių patvirtinimo (claim) puslapį, kuriame galima sukurti prieigos raktą (passkey). Tolesni žingsniai aprašyti 2.12 skyriuje „Pirmasis paleidimas“.

Kai nešiojamasis kompiuteris perkraunamas

Raktų saugykla susideda iš dviejų dalių: pačios raktų saugyklos ir nedidelio atrakinimo komponento (unsealer), kuris saugo jos atrakinimo raktą. Po bet kokio mazgo perkrovimo (Docker perkrovimo, nešiojamojo kompiuterio perkrovimo, k3d cluster stop ir start) atrakinimo komponentas pasileidžia užrakintas (sealed). Raktų saugykla atsirakina per jį, todėl tol, kol saugotojas neatrakina šio komponento savo age tapatybe, niekas, kam reikalingas raktas, neveikia. Tai yra architektūros savybė, ir gamybiniame klasteryje ji veikia lygiai taip pat. Atrakinimo procesas parodytas 2.15 skyriuje „Antroji diena: Nexus eksploatavimas“.

Kai baigsite sistemos išbandymą:

k3d cluster delete harrow-eval

Ištrynus klasterį, ištrinamas ir diegimas bei viskas, kas jame yra.

nexusctl kubeconfig

Klasteris, kurį sukūrė nexusctl install --single-node, priklauso nexusctl. Norėdami jį pasiekti naudodami kubectl, helm ar bet kurį kitą įrankį, paprašykite jo kubeconfig failo:

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

Šis failas suteikia pilną administracinę prieigą prie klasterio. Laikykite jį su 600 teisėmis (mode 600) tų žmonių, kurie valdo diegimą, kompiuteriuose ir niekur kitur. Kiekviena vėlesnė 2 dalies komanda, kuri priima --context arba nuskaito KUBECONFIG, veikia su vienu mazgu per šį failą. Tas pats galioja ir atnaujinimui: nexusctl upgrade plan --bundle <file> ir nexusctl upgrade apply --bundle <file> viename mazge taip pat atnaujina k3s klasterį, kurį valdo nexusctl.

Diagramoje pavaizduoti keturi sluoksniai, sudėti vienas ant kito langelyje su užrašu „vienas Linux serveris“. Nuo apačios: „k3s v1.33.6+k3s1 (Traefik vardų srityje kube-system, 80 ir 443 prievadai)“, tada „cert-manager v1.21.3 ir diagramos vietinė CA nexus-local-ca“, tada „Nexus duomenų lygmuo: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao“, o viršuje – „Nexus paslaugos: pultas, prisijungimas, šliuzas ir kita“. Dešinėje pusėje trys rodyklės iš viršutinio sluoksnio išeina iš langelio ir yra pažymėtos console.harrow.example, api.harrow.example bei auth.harrow.example. Kairėje pusėje terminalo piktograma su užrašu „nexusctl kubeconfig“ rodo į k3s sluoksnį.
Ką nexusctl install --single-node įdiegia viename Linux serveryje.

Kas perkeliama į klasterį

Viskas, ką atlikote viename kompiuteryje, turi atitikmenį klasteryje. Reikšmių failas yra tas pats failas, tik su kitu registru, TLS režimu ar saugyklos klase (storage class), kaip parodyta 2.11 skyriuje „Variacijos: išorinės saugyklos, TLS ir įeinantis srautas“. Pirmasis paleidimas yra identiškas. Tai, ko negalima perkelti, yra pats diegimas: diegimo pavadinimas yra užfiksuojamas visam laikui, ir diegimo negalima tiesiog iškelti iš nešiojamojo kompiuterio į serverį. Kai Tomás persikėlė iš savo nešiojamojo kompiuterio į bandomąjį serverį, jis pradėjo iš naujo su nauju pavadinimu harrow-pilot, o harrow-eval pasiliko eksperimentams.