IdħolIbbukkja laqgħa informattiva

Kapitlu 2.8

Installazzjonijiet fuq magna waħda

Installa Nexus fuq server wieħed ta' Linux b'nexusctl, jew evalwah fuq laptop b'k3d, u ilħaq il-console permezz ta' HTTPS sabiex id-dħul u l-passkeys jaħdmu.

Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

18 minuti qari

Qabel ma Harrow Port Authority poġġiet lil Nexus fuq il-cluster tal-produzzjoni tagħha, Tomás Reilly ried żewġ installazzjonijiet iżgħar. Waħda kienet pilota fuq server Linux żejjed fil-bini tal-operazzjonijiet, għat-tnax-il persuna li kienu se jippruvawh l-ewwel. L-oħra kienet taħdem fuq il-laptop tiegħu stess, sabiex ikun jista' jkisser l-affarijiet mingħajr ma ħadd jinduna. Dan il-kapitlu jkopri t-tnejn li huma. Huma jużaw l-istess chart, l-istess immaġnijiet u l-istess ewwel tħaddim bħal installazzjoni sħiħa ta' Kubernetes, għalhekk dak li titgħallem fuq magna waħda jgħodd ukoll għall-oħra.

Il-mogħdija tas-server hija kmand wieħed: nexusctl install --single-node jibni cluster k3s fuq il-magna, jinstalla cert-manager u mbagħad jinstalla Nexus. Il-mogħdija tal-laptop tirrikjedi aktar intervent manwali. Inti tibni cluster k3d int stess, tinstalla cert-manager u ċ-chart permezz ta' Helm, u mbagħad tagħmel biċċa xogħol żejda li taqbad lil kważi kulħadd: tpoġġi l-console wara HTTPS fuq il-magna tiegħek stess, minħabba li port-forward sempliċi qatt ma jista' jdaħħal lil ħadd fis-sistema.

Kemm trid tkun kbira l-magna

Nexus jitlob madwar 2.05 cores tas-CPU (central processing unit) u 6.7 GiB ta' memorja f'talbiet bil-valuri prestabbiliti taċ-chart, u l-volumi tiegħu jammontaw għal 142 GiB. Dak it-total huwa PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, il-ħażna tal-oġġetti 50, iż-żewġ ħażniet ta' OpenBao 1 u 5, u l-volum tal-irċevuti 1. It-talbiet huma dak li jirriżerva l-iskedatur, u l-użu reali jkun ogħla ladarba n-nies ikunu qed jaħdmu.

Magna CPU Memorja (RAM, random-access memory) Disk
Node wieħed rakkomandat 8 vCPU 32 GiB 250 GB SSD (solid-state drive)
Minimu għall-evalwazzjoni 4 vCPU 16 GiB 200 GB

Laptop li jissodisfa l-minimu tal-evalwazzjoni jħaddem lil Nexus, iżda jgħodd il-limitu tal-memorja ta' Docker stess, mhux tal-laptop. Agħti lil Docker mill-inqas 16 GiB qabel ma tibda.

Iż-żewġ mogħdijiet jeħtieġu Kubernetes 1.33 jew aktar riċenti. Il-mogħdija b'node wieħed iġġib tagħha stess: k3s v1.33.6+k3s1, id-distribuzzjoni li fuqha tiġi ttestjata kull verżjoni.

L-ewwel parti: server wieħed ta' Linux b'nexusctl

Is-server pilota ta' Tomás huwa magna bi 8 cores bi 32 GiB ta' memorja u SSD ta' 500 GB, li tħaddem Linux kurrenti mingħajr xejn ieħor fuqha. L-installazzjoni teħtieġ root, minħabba li tinstalla k3s bħala servizz tas-sistema.

Ikseb nexusctl u ċċekkjah

  1. Niżżel nexusctl għall-arkitettura tiegħek minn https://downloads.adverant.ai/nexus/1.0.0-alpha.1/, flimkien maċ-ċavetta pubblika tal-verżjoni. Issejvja ċ-ċavetta bħala release.pub. Kapitlu 2.4, Il-ksib u l-verifika ta' verżjoni, jispjega kif tiċċekkja l-marka tas-swaba' taċ-ċavetta ma' dik li jippubblika Adverant.
  2. Iċċekkja l-fajl binarju u l-verżjoni biċ-ċavetta:
nexusctl version --json
nexusctl verify

nexusctl verify jiċċekkja t-tniżżil maċ-ċavetta tal-verżjoni ta' Adverant u jirrifjuta kull ħaġa li ma jistax jivverifika. Jekk ifalli, ieqaf u niżżel mill-ġdid. Qatt tħaddem installazzjoni minn fajl li ma ġiex ivverifikat.

Oħloq iċ-ċavetta tal-kustodju

Il-ħażna taċ-ċwievet tal-installazzjoni tissiġilla ċ-ċwievet ta' rkupru tagħha għal kustodju wieħed jew aktar. Kustodju huwa persuna li żżomm fajl ta' identità age offline, u ċ-chart jirrifjuta li jinstalla mingħajr mill-inqas wieħed. Fuq il-magna tal-kustodju stess:

age-keygen -o custodian.key

Il-fajl jibda b'linja # public key: age1.... Dik in-nofs pubblika hija dak li jidħol fil-fajl tal-valuri. Il-fajl tal-identità nnifsu qatt ma joħroġ mill-magna tal-kustodju. Fuq Mac b'Secure Enclave, age-plugin-se keygen --access-control=any-biometry -o custodian.key joħloq ċavetta li teħtieġ Touch ID biex tintuża, u n-nofs pubblika tagħha tibda b'age1se1.

Ikteb il-fajl tal-valuri

# 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> hija l-linja age1... minn custodian.key. Żid entrata waħda fil-lista għal kull kustodju.

keys.installationName huwa permanenti. L-ewwel bidu tal-ħażna taċ-ċwievet joħloq l-identità tal-installazzjoni taħt dak l-isem, u xejn ma jibdillu ismu wara. Irid jaqbel ma' ^[a-z][a-z0-9-]{0,62}$: ittri żgħar, li jibdew b'ittra, sa massimu ta' 63 karattru. Tikkupjax nexus-example jew ir-riċevitur tal-eżempju mill-fajls tal-eżempju taċ-chart stess. Iċ-chart jirrifjuta lit-tnejn li huma b'isimhom, u l-kontroll ta' qabel l-installazzjoni (preflight) jirrapporta l-istess kodiċijiet l-ewwel.

It-tliet hosts huma l-identità tal-installazzjoni. Kull servizz jirrifjuta li jibda mingħajrhom, u kull dħul fis-sistema, cookie u passkey huma marbuta ma' hosts.console. Agħżel ismijiet li xorta tkun tridhom ħames snin oħra.

Ipponta t-tliet ismijiet lejn is-server

In-nies jilħqu l-console, l-API (application programming interface) u s-servizz tad-dħul fis-sistema permezz tal-kontrollur tad-dħul integrat ta' k3s, Traefik, fuq il-portijiet 80 u 443 tas-server. Żid tliet rekords DNS (Domain Name System) għal console.harrow.example, api.harrow.example u auth.harrow.example, fejn kull wieħed jipponta lejn l-indirizz tas-server. Il-kontroll ta' qabel l-installazzjoni jiċċekkja kull isem u jgħidlek liema wieħed m'għandux rekord.

Il-politika tan-netwerk taċ-chart tħalli biss namespace wieħed jilħaq it-tliet servizzi pubbliċi. Il-valur prestabbilit tagħha, kube-system, huwa fejn k3s iħaddem lil Traefik, għalhekk fuq node wieħed tħalli lil networkPolicy.ingressNamespace kif inhu.

Ħaddem il-kontroll ta' qabel l-installazzjoni, imbagħad installa

  1. Ħaddem il-kontroll ta' qabel l-installazzjoni bil-flag ta' node wieħed. Dan jaqra l-magna u l-fajl tal-valuri tiegħek u ma jibdel xejn.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Aqra l-linja tas-sommarju fl-aħħar. Twissija qatt ma timblokka l-installazzjoni, iżda falliment jimblokkaha, u kull ringiela li tfalli jkollha linja 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. Installa. Il-flag --edition irid jaqbel ma' edition fil-fajl tal-valuri.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Oqgħod araha taħdem. Din terġa' tħaddem il-kontroll ta' qabel l-installazzjoni, tinstalla k3s v1.33.6+k3s1, tinstalla cert-manager v1.21.3, tinstalla Nexus, u tistenna li kull servizz iwieġeb għall-kontroll tas-saħħa tiegħu. Fuq is-server ta' Tomás ħadet ftit inqas minn għaxar 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

Żomm dik il-marka tas-swaba' fuq l-iskrin. Se tqabbilha fil-brawżer meta tieħu pussess tal-installazzjoni bil-kodiċi. Jekk il-kodiċi jiskadi qabel ma tużah, nexusctl claim-code --administrator <email> joħloq wieħed ġdid. Kapitlu 2.12, L-ewwel tħaddim, ikompli minn hemm.

Installa l-edizzjoni Community
Installa l-edizzjoni Community
L-installazzjoni Community fuq server wieħed hija tniżżil, verifika, kontroll ta' qabel l-installazzjoni u installazzjoni, imbagħad l-ewwel amministratur. M'hemm l-ebda pass ta' liċenzja.

Poġġi ċ-ċertifikat f'postu

B'tls.mode: existing, it-tliet rotot tad-dħul iservu ċ-ċertifikat fis-Secret imsemmi minn tls.existingSecret. Dan irid ikopri t-tliet hosts kollha. Il-kontroll ta' qabel l-installazzjoni jaqra dak is-Secret meta jkun jeżisti u jwissi meta ċ-ċertifikat jiskadi fi żmien 30 jum. Meta s-Secret ikun għadu mhux hemm, ir-ringiela tgħidlek biex toħolqu, u din hija twissija, mhux falliment.

Fuq node wieħed il-cluster ma jkunx jeżisti sakemm l-installazzjoni tkun ħolqitu, għalhekk oħloq is-Secret eżatt wara l-installazzjoni. Ikteb il-kubeconfig tal-cluster l-ewwel (l-aħħar taqsima ta' dan il-kapitlu tispjegaha), imbagħad oħloq is-Secret bih:

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 iżomm iċ-ċertifikat segwit minn kwalunkwe ċertifikat intermedju, u harrow-public.key iċ-ċavetta privata tiegħu. Jekk iċ-ċertifikati tiegħek jiġu minn CA (certificate authority) privata, nexusctl preflight u nexusctl install jieħdu --ca-bundle <file> sabiex ikunu jistgħu jiċċekkjaw il-katina. Il-modi l-oħra biex timmaniġġja t-TLS (Transport Layer Security) jinsabu f'kapitlu 2.11, Varjazzjonijiet: ħażniet esterni, TLS u ingress.

Jekk dan ifalli

X'taraw Xi tfisser X'għandek tagħmel
PREFLIGHT_FAILED (409) Il-kontroll ta' qabel l-installazzjoni sab falliment, għalhekk l-installazzjoni ma bdietx. Ma ġie installat xejn. Irranġa kull ringiela li falliet, bl-użu tal-linja fix tagħha, u erġa' ħaddem l-installazzjoni.
INSTALLATION_NAME_MISSING keys.installationName huwa vojt. Issettja l-isem permanenti tal-installazzjoni stess.
INSTALLATION_NAME_EXAMPLE L-isem huwa dak mill-valuri tal-eżempju taċ-chart. Agħżel l-isem tiegħek stess.
KEYS_CUSTODIAN_MISSING keys.custody.recipients huwa vojt. Żid ir-riċevitur age1... pubbliku ta' kull kustodju.
KEYS_CUSTODIAN_EXAMPLE Riċevitur huwa l-kustodju tal-eżempju taċ-chart, li l-identità tiegħu ma jżommha ħadd. Ibdel dan bir-riċevituri tal-kustodji tiegħek.

nexusctl joħroġ b'0 meta jkun jista' jkompli, b'1 meta kontroll ikun imblokkah, u bi 2 meta ma jkunx seta' jaħdem xejn (fajl tal-valuri li ma jinqarax, flag ħażin). Skript jista' jieħu deċiżjoni abbażi ta' dawn it-tlieta.

It-tieni parti: evalwazzjoni fuq laptop b'k3d

k3d iħaddem k3s ġewwa kontejners ta' Docker, għalhekk cluster sħiħ jgħix fuq laptop u jisparixxi bi kmand wieħed. L-għodod tal-verżjoni li jittestjaw kull verżjoni ta' Nexus jibnu l-clusters tagħhom eżattament b'dan il-mod, u l-ikkupjar tas-settings tagħhom jiffrankalek milli terġa' tiskopri l-problemi li huma diġà ltaqgħu magħhom.

Għandek bżonn Docker, k3d 5.8.3, kubectl, Helm v4 u Chrome. Tomás uża l-Mac tiegħu.

Oħloq il-cluster

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

Kull flag għandu raġuni.

  • --agents 0 jagħti node ta' server wieħed u l-ebda worker. Nexus jaħdem tajjeb ħafna fuq node wieħed, u t-tieni wieħed jaħli biss il-memorja.
  • --image rancher/k3s:v1.33.6-k3s1 jiffissa l-verżjoni ta' k3s li fuqha tiġi ttestjata kull verżjoni. Mingħajru tieħu dak li k3d juża bħala valur prestabbilit.
  • --disable=traefik@server:0 iħalli barra lil Traefik. Laptop m'għandux indirizz pubbliku x'joffri, u minflok tilħaq il-console permezz tal-faċċata HTTPS tiegħek stess (hawn taħt).
  • --wait --timeout 300s jirritorna biss meta l-cluster iwieġeb, jew ifalli wara ħames minuti.

Jekk tirreplika r-reġistru tal-verżjoni fuq il-laptop tiegħek, żid --registry-config <registries.yaml> biex tibgħat il-ġbid tal-immaġnijiet lejn il-mirror, u --k3s-arg "--disable-default-registry-endpoint@server:0" sabiex xejn ma jerġa' jaqa' fuq reġistru upstream. L-għodod tal-verżjoni jaħdmu b'dan il-mod, fejn kull immaġni tiġi biss permezz tal-mirror.

Installa cert-manager

Iċ-chart jagħmel is-CA lokali tiegħu stess, nexus-local-ca, bħala emittent ta' cert-manager, u kull servizz jieħu ċ-ċertifikat tiegħu minnu. Mingħajr ir-riżorsi ta' cert-manager fil-cluster, helm install jirrifjuta ċ-chart fi ftit sekondi. Installa cert-manager v1.21.3 l-ewwel, miċ-chart li jippubblika l-proġett 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 m'għandu bżonn xejn ieħor minn cert-manager, u b'mod partikolari l-ebda trust-manager.

Installa Nexus

  1. Ikteb fajl tal-valuri għal-laptop. It-TLS jintemm fil-faċċata tiegħek stess, għalhekk tls.mode huwa 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. Installa ċ-chart mir-reġistru, u ħalli barra --wait (it-twissija hawn taħt tgħid għaliex).
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. Imbagħad stenna l-workloads int stess:
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

Iċ-ċiklu ta' StatefulSet qiegħed hemm minħabba li xi wħud minnhom jaġġornaw pod wieħed kull darba fuq talba, u kubectl rollout status jirrifjuta lil dawk. Li tistenna fuq readyReplicas jaħdem għal kull strateġija ta' aġġornament.

Meta ż-żewġ kmandi jirritornaw, kull Deployment ikun Disponibbli u kull StatefulSet ikollu l-pods tiegħu lesti. Ħadd ma jista' jidħol fis-sistema s'issa. Dan huwa korrett: ħadd għadu ma ħa pussess tal-installazzjoni.

Għaliex port-forward qatt ma jista' jdaħħlek fis-sistema

Il-pass ovvju li jmiss huwa kubectl port-forward svc/nexus-alpha 3000:3000 u brawżer fuq http://127.0.0.1:3000. Il-paġni tal-console jitgħabbew, għalhekk jidher bħallikieku jaħdem. Ma jaħdimx, u l-ebda setting ma jġiegħlu jaħdem. Tliet affarijiet iżommuh, kull waħda apposta.

X'iżommu Għaliex
L-oriġini Id-dħul fis-sistema tal-console jirrifjuta talba li l-oriġini tagħha mhijiex https://<hosts.console>, hawnhekk https://console.harrow.example. Paġna servuta minn http://127.0.0.1:3000 għandha l-oriġini żbaljata, għalhekk id-dħul fis-sistema qatt ma jibda.
Il-cookie Is-sessjoni hija cookie __Host- immarkata Secure. Il-brawżers jaħżnu cookie bħal din biss fuq HTTPS, mingħajr attribut ta' dominju, eżattament għall-host li ssettjaha. Fuq HTTP sempliċi l-brawżer jarmiha.
Il-passkey L-ewwel amministratur jidħol fis-sistema b'passkey, u passkey teħtieġ kuntest sigur b'ċertifikat validu. Chrome jirrifjuta li joħloq passkey wara twissija ta' ċertifikat, anke waħda li tkun ikklikkjajt biex taqbeż.

Għalhekk il-brawżer irid ikellem lil https://console.harrow.example, b'ċertifikat li jafda, u dak l-isem irid iwassal għal-laptop tiegħek.

Kif tilħaq il-console permezz ta' HTTPS fuq il-laptop tiegħek

Il-metodu t'hawn taħt juża s-CA taċ-chart stess biex joħroġ iċ-ċertifikat, port-forward biex jilħaq il-console, u profil separat ta' Chrome li jafda dik is-CA waħda u jimmappja l-isem tal-console mal-laptop tiegħek. Il-ħażna ta' fiduċja tas-sistema tiegħek u /etc/hosts jibqgħu kif inhuma.

Id-dijagramma turi Chrome fuq ix-xellug, bit-tikketta "separate profile: trusts nexus-local-ca only; console.harrow.example:443 mapped to 127.0.0.1:28443". Vleġġa bit-tikketta "HTTPS" tmur lejn kaxxa "HTTPS front on 127.0.0.1:28443 (certificate from nexus-local-ca)". Vleġġa bit-tikketta "HTTP, Host kept, X-Forwarded-Proto https" tmur lejn "kubectl port-forward 127.0.0.1:3000", u vleġġa finali tidħol fil-kaxxa tal-cluster k3d lejn "Service nexus-alpha, port http (3000)". Linja bit-tikek minn cert-manager ġewwa l-cluster lejn il-kaxxa ta' quddiem għandha t-tikketta "issues the certificate".
Kif brawżer fuq il-laptop jilħaq il-console fil-cluster k3d fuq HTTPS.

Oħroġ ċertifikat għall-isem tal-console

  1. Itlob lil cert-manager għal ċertifikat għall-host tal-console, iffirmat mill-emittent taċ-chart:
# 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 jiffirmah ġewwa l-cluster. Inti qatt ma taqra ċ-ċavetta privata tas-CA.

  1. Ikkopja ċ-ċertifikat, iċ-ċavetta tiegħu u ċ-ċertifikat tas-CA 'l barra mis-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. ikkalkula l-pin tas-CA. Chrome jidentifika ċavetta fdata permezz tal-base64 SHA-256 taċ-ċavetta pubblika tagħha:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Orbot il-pin maċ-ċavetta tas-CA, mhux taċ-ċertifikat. Iċ-ċertifikat idum ġurnata u jieħu ċavetta ġdida kull darba li cert-manager iġeddu, filwaqt li s-CA tibqa' l-istess.

Poġġi faċċata HTTPS quddiem port-forward

  1. Ibgħat 'il quddiem is-Service tal-console. Il-port tiegħu huwa dak imsemmi http, li huwa 3000 f'din il-verżjoni:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Ħaddem listener HTTPS fuq 127.0.0.1:28443 li jibgħat 'il quddiem lejn 127.0.0.1:3000. Kwalunkwe reverse proxy li diġà tafda jgħodd, sakemm jagħmel erba' affarijiet:
    • iservi tls.crt segwit minn ca.crt bħala l-katina, b'tls.key;
    • iżomm il-header Host bħala console.harrow.example;
    • jissettja X-Forwarded-Proto: https;
    • jgħaddi l-aġġornamenti ta' WebSocket, minħabba li l-console jużahom.

Port-forward lejn Service jorbot il-pod wieħed li għażel meta beda. Wara li aġġornament jew bidu mill-ġdid jibdel il-pod tal-console, il-forward jibqa' mixgħul u ma jibgħat lejn xejn, u l-brawżer juri bad gateway. Erġa' ibda l-port-forward kull meta jinbidel il-pod tal-console.

Iftaħ Chrome bil-pin u l-immappjar tal-isem

Fuq 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> huwa l-output tal-linja openssl. Fuq Linux, ibda Chrome bl-istess tliet flags.

It-tliet flags jaħdmu flimkien. --host-resolver-rules jibgħat console.harrow.example fuq il-port 443 lejn il-faċċata tiegħek, ġewwa dan il-profil biss. --ignore-certificate-errors-spki-list jafda ċ-ċertifikati maħruġa minn dik iċ-ċavetta CA waħda, u Chrome jonoraha biss b'--user-data-dir. Il-profil separat iżomm l-eċċezzjoni 'l bogħod mill-ibbrawżjar ta' kuljum tiegħek. Mhuwiex swiċċ ġenerali biex "tinjora l-iżbalji taċ-ċertifikati": kull ħaġa li mhix iffirmata mis-CA tal-cluster xorta tfalli.

B'dak il-profil miftuħ, https://console.harrow.example/install iwassal għall-paġna tat-teħid tal-pussess, u tista' tinħoloq passkey. Kapitlu 2.12, L-ewwel tħaddim, ikompli minn hawn.

Meta l-laptop jerġa' jinxtegħel

Il-ħażna taċ-ċwievet għandha żewġ partijiet: il-ħażna taċ-ċwievet innifisha u unsealer żgħir li jżomm iċ-ċavetta tal-ftuħ tagħha. Wara kwalunkwe bidu mill-ġdid tan-node (bidu mill-ġdid ta' Docker, reboot tal-laptop, k3d cluster stop u start) l-unsealer jibda ssiġillat. Il-ħażna taċ-ċwievet tiftaħ lilha nnifisha permezz tiegħu, għalhekk sakemm kustodju jiftaħ l-unsealer bl-identità age tiegħu stess, xejn li jeħtieġ ċavetta ma jaħdem. Dik hija karatteristika tad-disinn, u hija l-istess fuq cluster tal-produzzjoni. Kapitlu 2.15, It-tieni jum: it-tħaddim ta' Nexus, juri l-ftuħ tas-siġill.

Meta tkun lest bl-evalwazzjoni:

k3d cluster delete harrow-eval

It-tħassir tal-cluster iħassar l-installazzjoni u kull ma fiha.

nexusctl kubeconfig

Cluster li bena nexusctl install --single-node jappartjeni lil nexusctl. Biex tilħqu b'kubectl, helm jew kwalunkwe għodda oħra, itlob il-kubeconfig tiegħu:

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

Il-fajl jagħti aċċess amministrattiv sħiħ lill-cluster. Żommu fil-modalità 600, fuq il-magni tan-nies li jħaddmu l-installazzjoni, u imkien ieħor. Kull kmand aktar tard fil-Parti 2 li jieħu --context jew jaqra KUBECONFIG jaħdem fuq node wieħed permezz ta' dan il-fajl. L-istess japplika għal aġġornament: nexusctl upgrade plan --bundle <file> u nexusctl upgrade apply --bundle <file> fuq node wieħed jaġġornaw ukoll il-cluster k3s li jippossjedi nexusctl.

Id-dijagramma hija munzell ta' erba' saffi fuq kaxxa bit-tikketta "one Linux server". Mill-qiegħ: "k3s v1.33.6+k3s1 (Traefik in kube-system, ports 80 and 443)", imbagħad "cert-manager v1.21.3 and the chart's local CA nexus-local-ca", imbagħad "Nexus data tier: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao", imbagħad "Nexus services: console, sign-in, gateway, and the rest". Fuq il-lemin, tliet vleġeġ mis-saff ta' fuq joħorġu mill-kaxxa bit-tikketti console.harrow.example, api.harrow.example u auth.harrow.example. Fuq ix-xellug, ikona ta' terminal bit-tikketta "nexusctl kubeconfig" tipponta ġos-saff ta' k3s.
Dak li nexusctl install --single-node ipoġġi fuq server Linux wieħed.

X'jgħaddi għal cluster

Kull ma għamilt fuq magna waħda għandu ekwivalenti fuq cluster. Il-fajl tal-valuri huwa l-istess fajl b'reġistru, modalità TLS jew klassi ta' ħażna differenti, kif juri kapitlu 2.11, Varjazzjonijiet: ħażniet esterni, TLS u ingress. L-ewwel tħaddim huwa identiku. Dak li ma jgħoddx minn waħda għall-oħra huwa l-installazzjoni nnifisha: l-isem tal-installazzjoni huwa fiss għal dejjem, u installazzjoni ma tistax tittieħed minn fuq laptop għal fuq server. Meta Tomás mar mil-laptop tiegħu għas-server pilota huwa reġa' beda b'isem ġdid, harrow-pilot, u żamm harrow-eval għall-esperimenti.