Versjon 1.0.0-alpha.1nyeste
Kapittel 2.8
Installasjoner på én maskin
Installer Nexus på én Linux-server med nexusctl, eller evaluer det på en bærbar PC med k3d, og nå konsollen over HTTPS slik at pålogging og passnøkler fungerer.
Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

Før Harrow Port Authority la Nexus på produksjonsklyngen sin, ville Tomás Reilly ha to mindre installasjoner. Den ene var en pilot på en ledig Linux-server i driftsbygningen, for de tolv personene som skulle prøve det først. Den andre kjørte på hans egen bærbare PC, slik at han kunne ødelegge ting uten at noen la merke til det. Dette kapittelet dekker begge. De bruker samme chart, samme avbildninger og samme førstegangskjøring som en full Kubernetes-installasjon, så det du lærer på én maskin, kan overføres videre.
Serverveien er én kommando: nexusctl install --single-node bygger en k3s-klynge på maskinen, installerer cert-manager og installerer deretter Nexus. Veien på bærbar PC krever mer egeninnsats. Du bygger en k3d-klynge selv, installerer cert-manager og chartet med Helm, og gjør deretter én ekstra jobb som nesten alle snubler i: du legger konsollen bak HTTPS på din egen maskin, fordi en enkel portvideresending aldri kan logge noen inn.
Hvor stor maskinen må være
Nexus ber om omtrent 2.05 CPU-kjerner (central processing unit) og 6.7 GiB minne i forespørsler med chartets standardverdier, og volumene utgjør til sammen 142 GiB. Denne totalen er PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, objektlageret 50, de to OpenBao-lagrene 1 og 5, og kvitteringsvolumet 1. Forespørsler er det planleggeren reserverer, og reell bruk ligger høyere når folk først er i arbeid.
| Maskin | CPU | Minne (RAM, random-access memory) | Disk |
|---|---|---|---|
| Anbefalt enkeltnode | 8 vCPU | 32 GiB | 250 GB SSD (solid-state drive) |
| Minimum for evaluering | 4 vCPU | 16 GiB | 200 GB |
En bærbar PC som oppfyller minstekravet for evaluering vil kjøre Nexus, men det er Dockers egen minnegrense som teller, ikke maskinens. Gi Docker minst 16 GiB før du starter.
Begge veier krever Kubernetes 1.33 eller nyere. Enkeltnodeveien har med sin egen: k3s v1.33.6+k3s1, distribusjonen hver utgivelse testes på.
Del én: én Linux-server med nexusctl
Tomás sin pilotserver er en maskin med 8 kjerner, 32 GiB minne og en 500 GB SSD, som kjører en oppdatert Linux uten noe annet på seg. Installasjonen krever root, fordi den installerer k3s som en systemtjeneste.
Hent nexusctl og kontroller den
- Last ned
nexusctlfor arkitekturen din frahttps://downloads.adverant.ai/nexus/1.0.0-alpha.1/, sammen med den offentlige nøkkelen for utgivelsen. Lagre nøkkelen somrelease.pub. Kapittel 2.4, Hente og verifisere en utgivelse, forklarer hvordan du kontrollerer nøkkelens fingeravtrykk mot det Adverant publiserer. - Kontroller binærfilen og utgivelsen med nøkkelen:
nexusctl version --json
nexusctl verifynexusctl verify kontrollerer nedlastingen mot Adverants utgivelsesnøkkel og avviser alt den ikke kan verifisere. Hvis den feiler, stopp og last ned på nytt. Kjør aldri en installasjon fra en fil som ikke ble verifisert.
Lag vokternøkkelen
Installasjonens nøkkellager forsegler gjenopprettingsnøklene sine til én eller flere voktere. En vokter er en person som oppbevarer en age-identitetsfil frakoblet, og chartet nekter å installere uten minst én. På vokterens egen maskin:
age-keygen -o custodian.keyFilen starter med en linje # public key: age1.... Den offentlige halvdelen er det som skal inn i verdifilen. Selve identitetsfilen forlater aldri vokterens maskin. På en Mac med Secure Enclave lager age-plugin-se keygen --access-control=any-biometry -o custodian.key en nøkkel som krever Touch ID for å brukes, og den offentlige halvdelen starter med age1se1.
Skriv verdifilen
# 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> er age1...-linjen fra custodian.key. Legg til én listeoppføring per vokter.
keys.installationName er permanent. Ved første oppstart av nøkkellageret utstedes installasjonens identitet under det navnet, og ingenting kan endre navnet etterpå. Det må samsvare med ^[a-z][a-z0-9-]{0,62}$: små bokstaver, starter med en bokstav, maksimalt 63 tegn. Ikke kopier nexus-example eller eksempelmottakeren fra chartets egne eksempelfiler. Chartet avviser begge ved navn, og forhåndskontrollen rapporterer de samme kodene først.
De tre vertene er installasjonens identitet. Hver tjeneste nekter å starte uten dem, og hver innlogging, informasjonskapsel og passnøkkel er bundet til hosts.console. Velg navn du fortsatt vil ønske å bruke om fem år.
Pek de tre navnene til serveren
Brukerne når konsollen, API-et (application programming interface) og innloggingstjenesten gjennom k3s sin innebygde ingress-kontroller, Traefik, på port 80 og 443 på serveren. Legg til tre DNS-oppføringer (Domain Name System) for console.harrow.example, api.harrow.example og auth.harrow.example, som hver peker til serverens adresse. Forhåndskontrollen sjekker hvert navn og forteller deg hvilket som mangler oppføring.
Chartets nettverkspolicy lar bare ett navnerom nå de tre offentlige tjenestene. Standardverdien, kube-system, er der k3s kjører Traefik, så på en enkeltnode lar du networkPolicy.ingressNamespace være i fred.
Kjør forhåndskontroll, og installer deretter
- Kjør forhåndskontrollen med enkeltnodeflagget. Den leser maskinen og verdifilen din og endrer ingenting.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml- Les oppsummeringslinjen på slutten. En advarsel blokkerer aldri installasjonen, men det gjør en feil, og hver rad som feiler har en
fix-linje.
────────────────────────────────────────────────────────────
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
- Installer.
--edition-flagget må samsvare mededitioni verdifilen.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community- Se den kjøre. Den kjører forhåndskontrollen på nytt, installerer k3s v1.33.6+k3s1, installerer cert-manager v1.21.3, installerer Nexus, og venter på at hver tjeneste skal svare på helsesjekken sin. På Tomás sin server tok det litt under ti minutter.
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
Behold det fingeravtrykket på skjermen. Du skal sammenligne det i nettleseren når du gjør krav på installasjonen med koden. Hvis koden utløper før du får brukt den, lager nexusctl claim-code --administrator <email> en ny. Kapittel 2.12, Førstegangskjøringen, tar over derfra.
Legg sertifikatet på plass
Med tls.mode: existing leverer de tre ingress-rutene sertifikatet i den Secret som er navngitt av tls.existingSecret. Det må dekke alle tre vertene. Forhåndskontrollen leser denne Secret når den finnes, og advarer når sertifikatet utløper innen 30 dager. Når denne Secret ikke er der ennå, ber raden deg om å opprette den, og det er en advarsel, ikke en feil.
På en enkeltnode eksisterer ikke klyngen før installasjonen har opprettet den, så opprett denne Secret rett etter installasjonen. Skriv ut klyngens kubeconfig først (den siste delen av dette kapittelet forklarer det), og opprett deretter denne Secret med den:
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.keyharrow-public.crt inneholder sertifikatet etterfulgt av eventuelle mellomsertifikater, og harrow-public.key den private nøkkelen. Hvis sertifikatene dine kommer fra en privat CA (certificate authority), tar nexusctl preflight og nexusctl install imot --ca-bundle <file> slik at de kan kontrollere kjeden. De andre måtene å håndtere TLS (Transport Layer Security) på står i kapittel 2.11, Variasjoner: eksterne lagre, TLS og ingress.
Hvis dette feiler
| Hva dere ser | Hva det betyr | Hva du skal gjøre |
|---|---|---|
PREFLIGHT_FAILED (409) |
Forhåndskontrollen fant en feil, så installasjonen startet ikke. Ingenting ble installert. | Rett hver rad som feiler ved hjelp av fix-linjen, og kjør installasjonen på nytt. |
INSTALLATION_NAME_MISSING |
keys.installationName er tom. |
Angi installasjonens eget permanente navn. |
INSTALLATION_NAME_EXAMPLE |
Navnet er det som står i chartets eksempelverdier. | Velg ditt eget navn. |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients er tom. |
Legg til hver vokters offentlige age1...-mottaker. |
KEYS_CUSTODIAN_EXAMPLE |
En mottaker er chartets eksempelvokter, hvis identitet ingen sitter på. | Bytt den ut med mottakerne til vokterne dine. |
nexusctl avslutter med 0 når den kan gå videre, 1 når en sjekk blokkerte den, og 2 når den ikke kunne kjøre i det hele tatt (en uleselig verdifil, et feil flagg). Et skript kan forgrene basert på disse tre.
Del to: en evaluering på en bærbar PC med k3d
k3d kjører k3s inne i Docker-containere, slik at en hel klynge lever på en bærbar PC og forsvinner med én kommando. Utgivelsesverktøyene som tester hver Nexus-utgivelse bygger klyngene sine på nøyaktig denne måten, og ved å kopiere innstillingene deres slipper du å gjenoppdage problemene de allerede har støtt på.
Du trenger Docker, k3d 5.8.3, kubectl, Helm v4 og Chrome. Tomás brukte Mac-en sin.
Opprett klyngen
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.kubeconfigHvert flagg har en grunn.
--agents 0gir én servernode og ingen arbeidere. Nexus kjører fint på én node, og en ekstra koster bare minne.--image rancher/k3s:v1.33.6-k3s1låser k3s-versjonen som hver utgivelse testes på. Uten det får du det k3d bruker som standard.--disable=traefik@server:0utelater Traefik. En bærbar PC har ingen offentlig adresse å betjene, og du når konsollen gjennom din egen HTTPS-front i stedet (nedenfor).--wait --timeout 300sreturnerer først når klyngen svarer, eller feiler etter fem minutter.
Hvis du speiler utgivelsesregisteret på den bærbare PC-en din, legger du til --registry-config <registries.yaml> for å sende nedlastinger av avbildninger til speilet, og --k3s-arg "--disable-default-registry-endpoint@server:0" slik at ingenting faller tilbake til et oppstrømsregister. Utgivelsesverktøyene kjører på denne måten, der hver avbildning kun kommer gjennom speilet.
Installer cert-manager
Chartet lager sin egen lokale CA, nexus-local-ca, som en cert-manager-utsteder, og hver tjeneste får sertifikatet sitt fra den. Uten ressursene til cert-manager i klyngen avviser helm install chartet i løpet av sekunder. Installer cert-manager v1.21.3 først, fra chartet som cert-manager-prosjektet publiserer:
helm install cert-manager cert-manager-v1.21.3.tgz -n cert-manager \
--create-namespace --set crds.enabled=true --wait --timeout 10mNexus trenger ikke noe annet fra cert-manager, og spesielt ingen trust-manager.
Installer Nexus
- Skriv en verdifil for den bærbare PC-en. TLS avsluttes ved din egen front, så
tls.modeernone.
# 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>"- Installer chartet fra registeret, og utelat
--wait(advarselen nedenfor forklarer hvorfor).
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- Vent deretter på arbeidsbelastningene selv:
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
doneStatefulSet-løkken er der fordi noen av dem oppdaterer én pod om gangen på forespørsel, og kubectl rollout status avviser disse. Å vente på readyReplicas fungerer for alle oppdateringsstrategier.
Når begge kommandoene returnerer, er hver Deployment tilgjengelig (Available) og hvert StatefulSet har poddene sine klare. Ingen kan logge inn ennå. Det er riktig: ingen har gjort krav på installasjonen.
Hvorfor en port-videresending aldri kan logge deg inn
Det åpenbare neste trekket er kubectl port-forward svc/nexus-alpha 3000:3000 og en nettleser på http://127.0.0.1:3000. Konsollens sider lastes inn, så det ser ut som om det fungerer. Det gjør det ikke, og ingen innstilling vil få det til å fungere. Tre ting står i veien, hver av dem med hensikt.
| Hva som stopper det | Hvorfor |
|---|---|
| Opprinnelsen (origin) | Konsollens innlogging avviser en forespørsel hvis opprinnelse ikke er https://<hosts.console>, her https://console.harrow.example. En side levert fra http://127.0.0.1:3000 har feil opprinnelse, så innloggingen starter aldri. |
| Informasjonskapselen | Økten er en __Host--informasjonskapsel merket Secure. Nettlesere lagrer en slik informasjonskapsel kun over HTTPS, uten domeneattributt, for nøyaktig den verten som satte den. Over vanlig HTTP kaster nettleseren den. |
| Passnøkkelen | Den første administratoren logger inn med en passnøkkel, og en passnøkkel krever en sikker kontekst med et gyldig sertifikat. Chrome nekter å opprette en passnøkkel bak en sertifikatadvarsel, selv en du har klikket deg videre fra. |
Så nettleseren må snakke med https://console.harrow.example, med et sertifikat den stoler på, og det navnet må føre til den bærbare PC-en din.
Nå konsollen over HTTPS på den bærbare PC-en din
Metoden nedenfor bruker chartets egen CA til å utstede sertifikatet, en portvideresending for å nå konsollen, og en separat Chrome-profil som stoler på denne ene CA-en og knytter konsollens navn til den bærbare PC-en din. Systemets tillitslager og /etc/hosts forblir som de er.
Utsted et sertifikat for konsollens navn
- Be cert-manager om et sertifikat for konsollverten, signert av chartets utsteder:
# 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=120scert-manager signerer det inne i klyngen. Du leser aldri CA-ens private nøkkel.
- Kopier sertifikatet, nøkkelen og CA-sertifikatet ut av denne 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- Regn ut CA-ens pin. Chrome identifiserer en betrodd nøkkel ved hjelp av base64 SHA-256 av den offentlige nøkkelen:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64Fest (pin) CA-ens nøkkel, ikke sertifikatets. Sertifikatet varer i én dag og får en ny nøkkel hver gang cert-manager fornyer det, mens CA-en forblir den samme.
Sett en HTTPS-front foran en portvideresending
- Videresend konsollens Service. Porten er den som heter
http, som er 3000 i denne utgivelsen:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000- Kjør en HTTPS-lytter på
127.0.0.1:28443som videresender til127.0.0.1:3000. Enhver omvendt proxy du allerede stoler på vil fungere, så lenge den gjør fire ting:- leverer
tls.crtetterfulgt avca.crtsom kjeden, medtls.key; - beholder
Host-headeren somconsole.harrow.example; - setter
X-Forwarded-Proto: https; - slipper gjennom WebSocket-oppgraderinger, fordi konsollen bruker dem.
- leverer
En portvideresending til en Service binder den ene podden den valgte da den startet. Etter at en oppgradering eller en omstart erstatter konsollpodden, blir videresendingen liggende oppe og videresender til ingenting, og nettleseren viser en feil gateway (bad gateway). Start portvideresendingen på nytt hver gang konsollpodden endres.
Åpne Chrome med pin-verdien og navnetilordningen
På en 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> er utdataene fra openssl-linjen. På Linux starter du Chrome med de samme tre flaggene.
De tre flaggene fungerer sammen. --host-resolver-rules sender console.harrow.example på port 443 til fronten din, kun inne i denne profilen. --ignore-certificate-errors-spki-list stoler på sertifikater utstedt av denne ene CA-nøkkelen, og Chrome respekterer den kun sammen med --user-data-dir. Den separate profilen holder unntaket adskilt fra den daglige nettlesingen din. Det er ikke en generell bryter for å «ignorere sertifikatfeil»: alt som ikke er signert av klyngens CA vil fortsatt feile.
Med den profilen åpen fører https://console.harrow.example/install til siden for å gjøre krav på installasjonen, og en passnøkkel kan opprettes. Kapittel 2.12, Førstegangskjøringen, fortsetter herfra.
Når den bærbare PC-en starter på nytt
Nøkkellageret har to deler: selve nøkkellageret og en liten opplåser (unsealer) som holder opplåsingsnøkkelen. Etter enhver omstart av noden (en Docker-omstart, en omstart av den bærbare PC-en, k3d cluster stop og start) starter opplåseren forseglet. Nøkkellageret låser opp seg selv gjennom den, så inntil en vokter låser opp opplåseren med sin egen age-identitet, fungerer ingenting som trenger en nøkkel. Det er en egenskap ved designet, og det er likt på en produksjonsklynge. Kapittel 2.15, Dag to: drift av Nexus, viser opplåsingen.
Når du er ferdig med evalueringen:
k3d cluster delete harrow-evalÅ slette klyngen sletter installasjonen og alt i den.
nexusctl kubeconfig
En klynge som nexusctl install --single-node bygget, tilhører nexusctl. For å nå den med kubectl, helm eller et annet verktøy, be om dens kubeconfig:
sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus get deploy,statefulsetFilen gir full administrativ tilgang til klyngen. Hold den på modus 600, på maskinene til personene som drifter installasjonen, og ingen andre steder. Hver senere kommando i Del 2 som tar --context eller leser KUBECONFIG, fungerer mot en enkeltnode gjennom denne filen. Det samme gjelder for en oppgradering: nexusctl upgrade plan --bundle <file> og nexusctl upgrade apply --bundle <file> på en enkeltnode oppgraderer også k3s-klyngen som nexusctl eier.
nexusctl install --single-node legger på én Linux-server.Hva som videreføres til en klynge
Alt du gjorde på én maskin har et motstykke på en klynge. Verdifilen er den samme filen med et annet register, en annen TLS-modus eller lagringsklasse, slik kapittel 2.11, Variasjoner: eksterne lagre, TLS og ingress, viser. Førstegangskjøringen er identisk. Det som ikke kan overføres, er selve installasjonen: installasjonsnavnet er låst for godt, og en installasjon kan ikke løftes fra en bærbar PC over på en server. Da Tomás gikk fra den bærbare PC-en til pilotserveren, startet han på nytt med et nytt navn, harrow-pilot, og beholdt harrow-eval for eksperimenter.
