Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.8
Instalacije na jednoj mašini
Instalirajte Nexus na jedan Linux server pomoću alata nexusctl ili ga procenite na laptopu pomoću k3d i pristupite konzoli preko HTTPS-a kako bi prijava i passkey ključevi radili.
Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

Pre nego što je Harrow Port Authority postavio Nexus na svoj produkcioni klaster, Tomás Reilly je želeo dve manje instalacije. Jedna je bila pilot na rezervnom Linux serveru u zgradi operacija, za dvanaest ljudi koji će ga prvi isprobati. Druga je radila na njegovom sopstvenom laptopu, kako bi mogao da kvari stvari a da to niko ne primeti. Ovo poglavlje obuhvata obe. One koriste isti chart, iste slike i isto prvo pokretanje kao i potpuna Kubernetes instalacija, tako da se ono što naučite na jednoj mašini prenosi i na druge.
Put sa serverom je jedna komanda: nexusctl install --single-node pravi k3s klaster na mašini, instalira cert-manager, a zatim instalira Nexus. Put sa laptopom zahteva više ručnog rada. Sami pravite k3d klaster, instalirate cert-manager i chart pomoću Helm-a, a zatim obavljate još jedan posao koji zbuni gotovo svakoga: postavljate konzolu iza HTTPS-a na sopstvenoj mašini, jer običan port-forward nikada ne može nikoga da prijavi.
Koliko velika mašina mora da bude
Nexus sa podrazumevanim podešavanjima chart-a zahteva oko 2.05 CPU (centralna procesorska jedinica) jezgara i 6.7 GiB memorije u zahtevima (requests), a njegovi volumeni ukupno iznose 142 GiB. Taj zbir čine PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, skladište objekata 50, dva OpenBao skladišta 1 i 5, i volumen za potvrde 1. Zahtevi su ono što planer (scheduler) rezerviše, a stvarna potrošnja je veća kada ljudi počnu da rade.
| Mašina | CPU | Memorija (RAM, memorija sa nasumičnim pristupom) | Disk |
|---|---|---|---|
| Preporučeni pojedinačni čvor | 8 vCPU | 32 GiB | 250 GB SSD (disk sa čvrstim stanjem) |
| Minimum za procenu | 4 vCPU | 16 GiB | 200 GB |
Laptop koji ispunjava minimum za procenu pokrenuće Nexus, ali se računa ograničenje memorije samog Docker-a, a ne laptopa. Pre početka dodelite Docker-u najmanje 16 GiB.
Oba puta zahtevaju Kubernetes 1.33 ili noviji. Put sa jednim čvorom donosi sopstveni: k3s v1.33.6+k3s1, distribuciju na kojoj se testira svako izdanje.
Prvi deo: jedan Linux server sa alatom nexusctl
Tomásov pilot server je mašina sa 8 jezgara, 32 GiB memorije i SSD diskom od 500 GB, sa aktuelnim Linux-om i ničim drugim na njoj. Instalacija zahteva root pristup, jer instalira k3s kao sistemski servis.
Preuzmite nexusctl i proverite ga
- Preuzmite
nexusctlza svoju arhitekturu sahttps://downloads.adverant.ai/nexus/1.0.0-alpha.1/, zajedno sa javnim ključem izdanja. Sačuvajte ključ kaorelease.pub. Poglavlje 2.4, Preuzimanje i provera izdanja, objašnjava kako da otisak ključa uporedite sa onim koji Adverant objavljuje. - Proverite binarnu datoteku i izdanje pomoću ključa:
nexusctl version --json
nexusctl verifynexusctl verify proverava preuzetu datoteku prema Adverant ključu izdanja i odbija sve što ne može da verifikuje. Ako provera ne uspe, zaustavite se i preuzmite ponovo. Nikada ne pokrećite instalaciju iz datoteke koja nije verifikovana.
Napravite ključ čuvara
Skladište ključeva instalacije zapečaćuje svoje ključeve za oporavak za jednog ili više čuvara. Čuvar je osoba koja van mreže drži datoteku age identiteta, a chart odbija instalaciju bez najmanje jednog čuvara. Na sopstvenoj mašini čuvara:
age-keygen -o custodian.keyDatoteka počinje redom # public key: age1.... Ta javna polovina je ono što ide u datoteku vrednosti. Sama datoteka identiteta nikada ne napušta mašinu čuvara. Na Mac računaru sa Secure Enclave, age-plugin-se keygen --access-control=any-biometry -o custodian.key pravi ključ za čije je korišćenje potreban Touch ID, a njegova javna polovina počinje sa age1se1.
Napišite datoteku vrednosti
# 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> je red age1... iz custodian.key. Dodajte po jednu stavku liste za svakog čuvara.
keys.installationName je trajan. Prvo pokretanje skladišta ključeva kreira identitet instalacije pod tim imenom i ništa ga kasnije ne preimenuje. Mora da odgovara ^[a-z][a-z0-9-]{0,62}$: mala slova, počinje slovom, najviše 63 znaka. Ne kopirajte nexus-example niti primer primaoca iz sopstvenih datoteka primera chart-a. Chart odbija oba po imenu, a preflight prvi prijavljuje iste kodove.
Tri hosta čine identitet instalacije. Svaki servis odbija da se pokrene bez njih, a svaka prijava, kolačić i passkey vezani su za hosts.console. Izaberite imena koja ćete želeti i za pet godina.
Usmerite tri imena na server
Korisnici pristupaju konzoli, API-ju (interfejs za programiranje aplikacija) i servisu za prijavu preko ugrađenog ingress kontrolera k3s-a, Traefik, na portovima 80 i 443 servera. Dodajte tri DNS (sistem imena domena) zapisa za console.harrow.example, api.harrow.example i auth.harrow.example, od kojih svaki pokazuje na adresu servera. Preflight proverava svako ime i javlja vam koje nema zapis.
Mrežna politika chart-a dozvoljava samo jednom namespace-u da pristupa trima javnim servisima. Njena podrazumevana vrednost, kube-system, jeste mesto gde k3s pokreće Traefik, pa na jednom čvoru networkPolicy.ingressNamespace ostavljate nepromenjeno.
Pokrenite preflight, zatim instalirajte
- Pokrenite preflight sa oznakom za jedan čvor. On čita mašinu i vašu datoteku vrednosti i ništa ne menja.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml- Pročitajte zbirni red na kraju. Upozorenje nikada ne blokira instalaciju, ali neuspeh je blokira, a svaki neuspeli red sadrži red
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
- Instalirajte. Oznaka
--editionmora da se slaže saeditionu datoteci vrednosti.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community- Pratite izvršavanje. Ponovo pokreće preflight, instalira k3s v1.33.6+k3s1, instalira cert-manager v1.21.3, instalira Nexus i čeka da svaki servis odgovori na proveru ispravnosti. Na Tomásovom serveru to je trajalo nešto manje od deset minuta.
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
Zadržite taj otisak na ekranu. Uporedićete ga u pregledaču kada budete preuzimali instalaciju pomoću koda. Ako kod istekne pre nego što ga iskoristite, nexusctl claim-code --administrator <email> pravi novi. Poglavlje 2.12, Prvo pokretanje, nastavlja odatle.
Postavite sertifikat
Uz tls.mode: existing, tri ingress rute poslužuju sertifikat iz Secret-a imenovanog u tls.existingSecret. On mora da pokriva sva tri hosta. Preflight čita taj Secret kada postoji i upozorava kada sertifikat ističe u roku od 30 dana. Kada Secret još ne postoji, red vam govori da ga napravite, i to je upozorenje, a ne neuspeh.
Na jednom čvoru klaster ne postoji dok ga instalacija ne napravi, pa Secret napravite odmah nakon instalacije. Prvo ispišite kubeconfig klastera (poslednji odeljak ovog poglavlja to objašnjava), a zatim pomoću njega napravite 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.keyharrow-public.crt sadrži sertifikat praćen eventualnim posredničkim sertifikatima, a harrow-public.key njegov privatni ključ. Ako vaši sertifikati potiču od privatnog CA (sertifikaciono telo), nexusctl preflight i nexusctl install prihvataju --ca-bundle <file> kako bi mogli da provere lanac. Ostali načini rada sa TLS-om (Transport Layer Security) opisani su u poglavlju 2.11, Varijacije: spoljna skladišta, TLS i ingress.
Ako ovo ne uspe
| Šta vidite | Šta znači | Šta učiniti |
|---|---|---|
PREFLIGHT_FAILED (409) |
Preflight je pronašao neuspeh, pa instalacija nije započeta. Ništa nije instalirano. | Ispravite svaki neuspeli red pomoću njegovog reda fix i ponovo pokrenite instalaciju. |
INSTALLATION_NAME_MISSING |
keys.installationName je prazan. |
Postavite sopstveno trajno ime instalacije. |
INSTALLATION_NAME_EXAMPLE |
Ime je ono iz primera vrednosti chart-a. | Izaberite sopstveno ime. |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients je prazan. |
Dodajte javnog age1... primaoca svakog čuvara. |
KEYS_CUSTODIAN_EXAMPLE |
Jedan primalac je primer čuvara iz chart-a, čiji identitet niko ne poseduje. | Zamenite ga primaocima svojih čuvara. |
nexusctl završava sa kodom 0 kada može da nastavi, 1 kada ga je neka provera blokirala i 2 kada uopšte nije mogao da se izvrši (nečitljiva datoteka vrednosti, pogrešna oznaka). Skripta može da se grana prema ova tri koda.
Drugi deo: probna instalacija na laptopu sa alatom k3d
k3d pokreće k3s unutar Docker kontejnera, tako da ceo klaster živi na laptopu i nestaje jednom komandom. Alati za izdanja koji testiraju svako Nexus izdanje prave svoje klastere upravo na ovaj način, a kopiranje njihovih podešavanja štedi vas ponovnog otkrivanja problema na koje su oni već naišli.
Potrebni su vam Docker, k3d 5.8.3, kubectl, Helm v4 i Chrome. Tomás je koristio svoj Mac.
Napravite 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.kubeconfigSvaka oznaka ima svoj razlog.
--agents 0daje jedan serverski čvor i nijedan radni čvor. Nexus bez problema radi na jednom čvoru, a drugi samo troši memoriju.--image rancher/k3s:v1.33.6-k3s1fiksira verziju k3s-a na kojoj se testira svako izdanje. Bez toga dobijate ono što je podrazumevano u k3d-u.--disable=traefik@server:0izostavlja Traefik. Laptop nema javnu adresu koju bi posluživao, a konzoli umesto toga pristupate preko sopstvenog HTTPS fronta (u nastavku).--wait --timeout 300sse vraća tek kada klaster odgovori, ili ne uspeva nakon pet minuta.
Ako na laptopu imate preslikani registar izdanja, dodajte --registry-config <registries.yaml> da biste preuzimanje slika usmerili na preslikani registar, i --k3s-arg "--disable-default-registry-endpoint@server:0" kako se ništa ne bi vraćalo na izvorni registar. Alati za izdanja rade na ovaj način, pri čemu svaka slika dolazi isključivo preko preslikanog registra.
Instalirajte cert-manager
Chart pravi sopstveni lokalni CA, nexus-local-ca, kao cert-manager issuer, i svaki servis od njega dobija svoj sertifikat. Bez cert-manager resursa u klasteru, helm install odbija chart u roku od nekoliko sekundi. Prvo instalirajte cert-manager v1.21.3, iz chart-a koji objavljuje projekat cert-manager:
helm install cert-manager cert-manager-v1.21.3.tgz -n cert-manager \
--create-namespace --set crds.enabled=true --wait --timeout 10mNexus-u ništa drugo nije potrebno od cert-manager-a, a posebno mu nije potreban trust-manager.
Instalirajte Nexus
- Napišite datoteku vrednosti za laptop. TLS se završava na vašem sopstvenom frontu, pa je
tls.modenone.
# 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>"- Instalirajte chart iz registra i izostavite
--wait(upozorenje u nastavku objašnjava zašto).
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- Zatim sami sačekajte radna opterećenja:
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
donePetlja za StatefulSet postoji zato što se neki od njih ažuriraju po jedan pod na zahtev, a kubectl rollout status ih odbija. Čekanje na readyReplicas radi za svaku strategiju ažuriranja.
Kada se obe komande vrate, svaki Deployment je Available i svaki StatefulSet ima spremne podove. Još niko ne može da se prijavi. To je ispravno: instalacija još nije preuzeta.
Zašto prosleđivanje portova (port-forward) nikada ne može da vas prijavi
Očigledan sledeći korak je kubectl port-forward svc/nexus-alpha 3000:3000 i pregledač na http://127.0.0.1:3000. Stranice konzole se učitavaju, pa izgleda kao da radi. Ne radi, i nijedno podešavanje to neće promeniti. Tri stvari stoje na putu, svaka namerno.
| Šta to sprečava | Zašto |
|---|---|
| Poreklo (origin) | Prijava u konzolu odbija zahtev čije poreklo nije https://<hosts.console>, ovde https://console.harrow.example. Stranica posluživana sa http://127.0.0.1:3000 ima pogrešno poreklo, pa prijava nikada ne počinje. |
| Kolačić | Sesija je kolačić __Host- označen kao Secure. Pregledači takav kolačić čuvaju samo preko HTTPS-a, bez atributa domena, isključivo za host koji ga je postavio. Preko običnog HTTP-a pregledač ga odbacuje. |
| Passkey | Prvi administrator se prijavljuje pomoću passkey-a, a passkey zahteva bezbedan kontekst sa važećim sertifikatom. Chrome odbija da napravi passkey iza upozorenja o sertifikatu, čak i ako ste ga prihvatili. |
Dakle, pregledač mora da komunicira sa https://console.harrow.example, uz sertifikat kojem veruje, a to ime mora da vodi do vašeg laptopa.
Pristupanje konzoli preko HTTPS protokola na vašem laptopu
Metod u nastavku koristi sopstveni CA chart-a za izdavanje sertifikata, port-forward za pristup konzoli i zaseban Chrome profil koji veruje tom jednom CA i mapira ime konzole na vaš laptop. Vaše sistemsko skladište poverenja i /etc/hosts ostaju nepromenjeni.
Izdajte sertifikat za ime konzole
- Zatražite od cert-manager-a sertifikat za host konzole, potpisan issuer-om chart-a:
# 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 ga potpisuje unutar klastera. Privatni ključ CA nikada ne čitate.
- Kopirajte sertifikat, njegov ključ i CA sertifikat iz Secret-a:
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- Izračunajte pin CA. Chrome identifikuje pouzdani ključ prema base64 SHA-256 vrednosti njegovog javnog ključa:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64Fiksirajte ključ CA, a ne ključ sertifikata. Sertifikat važi jedan dan i dobija novi ključ svaki put kada ga cert-manager obnovi, dok CA ostaje isti.
Postavite HTTPS front ispred port-forward veze
- Prosledite Service konzole. Njegov port je onaj sa imenom
http, što je 3000 u ovom izdanju:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000- Pokrenite HTTPS listener na
127.0.0.1:28443koji prosleđuje na127.0.0.1:3000. Odgovara bilo koji reverse proxy kojem već verujete, sve dok radi četiri stvari:- poslužuje
tls.crtpraćen saca.crtkao lanac, uztls.key; - zadržava zaglavlje
Hostkaoconsole.harrow.example; - postavlja
X-Forwarded-Proto: https; - propušta WebSocket nadogradnje, jer ih konzola koristi.
- poslužuje
Prosleđivanje porta (port-forward) ka Service objektu vezuje se za jedan pod koji je izabrao pri pokretanju. Nakon što nadogradnja ili ponovno pokretanje zameni pod konzole, prosleđivanje ostaje aktivno i ne prosleđuje nikuda, a pregledač prikazuje grešku „bad gateway“. Ponovo pokrenite port-forward kad god se pod konzole promeni.
Otvorite Chrome sa pinovanjem i mapiranjem imena
Na Mac računaru:
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> je izlaz linije openssl. Na Linuxu pokrenite Chrome sa ista tri parametra.
Ova tri parametra deluju zajedno. --host-resolver-rules šalje console.harrow.example na portu 443 ka vašem frontu, isključivo unutar ovog profila. --ignore-certificate-errors-spki-list smatra pouzdanim sertifikate izdate tim jednim CA ključem, a Chrome ga poštuje samo uz --user-data-dir. Zaseban profil drži ovaj izuzetak dalje od vašeg svakodnevnog pregledanja. To nije opšti prekidač „ignoriši greške sertifikata“: sve što nije potpisao CA klastera i dalje ne prolazi.
Kada je taj profil otvoren, https://console.harrow.example/install vodi do stranice za preuzimanje, i može se kreirati pristupni ključ (passkey). Poglavlje 2.12, Prvo pokretanje, nastavlja odavde.
Kada se laptop ponovo pokrene
Skladište ključeva ima dva dela: samo skladište ključeva i mali unsealer koji čuva njegov ključ za otključavanje. Nakon bilo kakvog ponovnog pokretanja čvora (ponovno pokretanje Dockera, ponovno pokretanje laptopa, k3d cluster stop i start) unsealer se pokreće zapečaćen. Skladište ključeva se otpečaćuje preko njega, tako da sve dok kustos ne otpečati unsealer svojim age identitetom, ništa što zahteva ključ ne radi. To je svojstvo dizajna i isto je i na produkcionom klasteru. Poglavlje 2.15, Drugi dan: upravljanje sistemom Nexus, prikazuje otpečaćivanje.
Kada završite sa evaluacijom:
k3d cluster delete harrow-evalBrisanjem klastera briše se instalacija i sve što se u njoj nalazi.
nexusctl kubeconfig
Klaster koji je izgradio nexusctl install --single-node pripada nexusctl. Da biste mu pristupili pomoću kubectl, helm ili bilo kog drugog alata, zatražite njegov kubeconfig:
sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus get deploy,statefulsetOva datoteka daje potpun administrativni pristup klasteru. Čuvajte je sa režimom 600, na računarima osoba koje upravljaju instalacijom, i nigde drugde. Svaka kasnija komanda u Delu 2 koja prima --context ili čita KUBECONFIG radi nad jednim čvorom preko ove datoteke. Isto važi i za nadogradnju: nexusctl upgrade plan --bundle <file> i nexusctl upgrade apply --bundle <file> na jednom čvoru nadograđuju i k3s klaster čiji je vlasnik nexusctl.
nexusctl install --single-node postavlja na jedan Linux server.Šta se prenosi na klaster
Sve što ste uradili na jednom računaru ima svoj ekvivalent na klasteru. Datoteka sa vrednostima je ista datoteka sa drugačijim registrom, TLS režimom ili klasom skladišta, kako pokazuje poglavlje 2.11, Varijacije: eksterna skladišta, TLS i ingress. Prvo pokretanje je identično. Ono što se ne prenosi jeste sama instalacija: naziv instalacije je trajno fiksiran, a instalacija se ne može preneti sa laptopa na server. Kada je Tomás prešao sa svog laptopa na pilot server, počeo je ispočetka sa novim nazivom, harrow-pilot, a harrow-eval je zadržao za eksperimente.
