Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.5
Predprovjera pomoću alata nexusctl
Svaka provjera koju izvršava `nexusctl preflight`, što svaka od njih čita i kako pada, izvješće koje ispisuje i sprema, kako to izvješće stiže do stranice za predprovjeru u konzoli te svaka zastavica.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Naša prva predprovjera u organizaciji Harrow Port Authority nije prošla četiri provjere, a dvije od njih stajale bi nas puno više od jednog poslijepodneva. Datoteku vrijednosti započeli smo kopiranjem primjera iz charta, a predprovjera je odbila i ogledni naziv instalacije i oglednog skrbnika. Nitko ne posjeduje privatni ključ tog skrbnika. Instalacija zapečaćena njime nikada se ne može otpečatiti nakon ponovnog pokretanja čvora. Predprovjera je to uhvatila u nekoliko sekundi, prije nego što je išta postojalo što bi se moglo izgubiti.
nexusctl preflight čita vaš klaster i vašu datoteku vrijednosti, ispisuje što je pronašao, sprema izvješće i ništa ne mijenja na klasteru. Pokrenite ga prije svake instalacije i svake nadogradnje. Ovo poglavlje obuhvaća svaku provjeru koju provodi, format izvješća, kamo izvješće ide i zastavice.
Održavanje i rad
Predprovjera treba dvije stvari: kube kontekst klastera na koji ćete instalirati i datoteku vrijednosti koju će instalacija koristiti. Prvo napišite datoteku vrijednosti; poglavlje 2.6, Instaliranje izdanja Community na Kubernetes, prolazi kroz svaki ključ. Zatim:
nexusctl preflight --context harrow-prod --values harrow-values.yamlČita klaster putem klijenta client-go isključivo pomoću poziva get i list. Ako je vaš tls.mode postavljen na existing, stvorite imenski prostor nexus i Transport Layer Security (TLS) Secret prije nego što ga pokrenete (poglavlje 2.6, Instaliranje izdanja Community na Kubernetes, korak 3), inače će provjera certifikata izvijestiti da Secret nedostaje.
| Zastavica | Što radi | Zadano |
|---|---|---|
--context <name> |
Kube kontekst koji se provjerava. Obavezno | ništa |
--values <file> |
Datoteka vrijednosti koju će instalacija koristiti. Obavezno | ništa |
--namespace <name> |
Kamo se Nexus instalira | nexus |
--release <version> |
Izdanje koje se provjerava | vlastita verzija priloženog charta |
--report-dir <dir> |
Gdje se spremaju dvije datoteke izvješća | trenutačna mapa |
--record <mode> |
auto, always ili never: hoće li se izvješće predati servisu ključeva ove instalacije kako bi ga njegova stranica instalacijskog programa prikazala |
auto |
--kubeconfig <file> |
Kubeconfig koji se čita | KUBECONFIG, zatim ~/.kube/config |
--ca-bundle <file> |
Vaši vlastiti certifikati certifikacijskog tijela (CA), za lanac kojem bi provjere trebale vjerovati | ništa |
--single-node |
Provjerite jedno računalo za instalaciju na jednom računalu (poglavlje 2.8, Instalacije na jednom računalu) | isključeno |
Donja granica izdanja za Kubernetes nije upisana u nexusctl. On čita donju granicu vlastitog polja kubeVersion samog charta iz charta koji nosi, tako da se provjera i helm install nikada ne mogu razilaziti.
Što pokretanje ispisuje
Evo prvog pokretanja u organizaciji Harrow, točno kako je ispisano:
Adverant Nexus 1.0.0-alpha.1 · preflight · Tue 10 Nov 2026 08:40 · read-only
Failed first
FAIL Address (api) api.harrow.example → no record people reach Nexus by this name
fix add a DNS record for api.harrow.example that points at the ingress, then run preflight again
FAIL Address (auth) auth.harrow.example → no record people reach Nexus by this name
fix add a DNS record for auth.harrow.example that points at the ingress, then run preflight again
FAIL Key custodians the example custodian of the chart's values-community.yaml and values-enterprise.yaml (age1u63etg5v…) the key store seals its recovery keys to them; no one holds the example custodian's key
fix replace it in keys.custody.recipients in harrow-values.yaml with your custodians' own recipients: each custodian makes a key on their own machine with `age-keygen -o custodian.key` (the `# public key: age1...` line is the recipient), or `age-plugin-se keygen --access-control=any-biometry -o custodian.key` for a Secure Enclave key, keeps the identity file offline, and gives you only the recipient
FAIL Installation name nexus-example, the example name of the chart's values-community.yaml and values-enterprise.yaml the first key-store bootstrap mints the installation identity under it, permanently
fix set keys.installationName in harrow-values.yaml to this installation's own name
Warnings
warn Graphics nodes none the assistant will need a hosted model
fix add a node with a graphics card and its device plugin, or have the assistant use a hosted model
warn Certificate secret harrow-public-tls not found in nexus the public address needs it before people sign in
fix create the TLS secret harrow-public-tls in nexus before installing, or change tls.existingSecret in harrow-values.yaml
Passed
pass Kubernetes version 1.33.6+k3s1 needs 1.33 or later
pass Nodes ready 3 of 3
pass Storage class local-path (default)
pass Resources 24 cores, 93.9 GiB needs 2.1 cores, 6.7 GiB
pass Ingress class traefik (default)
pass Ingress ports traefik (LoadBalancer) on 80 and 443
pass Address (console) console.harrow.example → 10.20.4.10
────────────────────────────────────────────────────────────────────────────
7 passed · 2 warnings · 4 failed Install cannot continue until the failures pass.
Nothing was changed. Report saved to preflight-2026-11-10-0840.txt
Kada nešto ne prođe, prvo dolaze neuspjesi, zatim upozorenja, a potom prolazi. Svaki redak prikazuje ishod, naziv provjere, što je pronađeno i što je potrebno; svaki redak koji nije prošao ima redak fix ispod sebe. Posljednja dva retka su sažetak i datoteka izvješća.
Popravili smo vrijednosti, dodali dva zapisa sustava naziva domena (DNS), stvorili Secret i ponovno ga pokrenuli:
Adverant Nexus 1.0.0-alpha.1 · preflight · Thu 12 Nov 2026 09:02 · read-only
Cluster
pass Kubernetes version 1.33.6+k3s1 needs 1.33 or later
pass Nodes ready 3 of 3
pass Storage class local-path (default)
pass Resources 24 cores, 93.9 GiB needs 2.1 cores, 6.7 GiB
warn Graphics nodes none the assistant will need a hosted model
fix add a node with a graphics card and its device plugin, or have the assistant use a hosted model
Network
pass Ingress class traefik (default)
pass Ingress ports traefik (LoadBalancer) on 80 and 443
pass Address (console) console.harrow.example → 10.20.4.10
pass Address (api) api.harrow.example → 10.20.4.10
pass Address (auth) auth.harrow.example → 10.20.4.10
pass Certificate ends 3 Nov 2027
Time and keys
pass Key custodians 3 custodians
pass Installation name harrow-port-authority
────────────────────────────────────────────────────────────────────────────
12 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 on the cluster
Pokretanje bez neuspjeha ispisuje provjere pod njihova tri naslova: Klaster, Mreža te Vrijeme i ključevi. Upozorenja nikada ne blokiraju. Upozorenje za grafiku zadržali smo namjerno: na ovom povezanom pilot-klasteru, pomoćnik organizacije Harrow koristio je hostirani model s vlastitim ključem luke.
Izlazni kodovi
| Kod | Značenje |
|---|---|
0 |
Instalacija se može nastaviti. Upozorenja ne blokiraju |
1 |
Instalacija je blokirana: barem jedna provjera nije prošla |
2 |
Predprovjera se nije mogla pokrenuti: kubeconfig, kontekst, datoteka vrijednosti ili aplikacijsko programsko sučelje (API) klastera nisu se mogli pročitati ili je zastavica bila pogrešna |
Skripte bi trebale čitati izlazni kod, a ne riječi. Naša pokreće predprovjeru kao prvi korak svake nadogradnje i zaustavlja se na svemu osim na 0.
Pokrenite nexusctl izdanja na koje prelazite, a ne onoga s kojim ste instalirali. Zahtjevi dolaze iz charta koji on nosi, pa novije izdanje može podići donju granicu za Kubernetes ili tražiti više memorije, a to zna samo njegov vlastiti nexusctl. --release mijenja verziju koju izvješće navodi; ne mijenja pravila kojeg se charta primjenjuju. U organizaciji Harrow čuvamo nexusctl svakog izdanja pokraj njegovog charta u zapisu o promjenama, tako da povratak na staro provjerava alat koji mu odgovara.
Svaka provjera
Postoji jedanaest provjera. Deset ih daje po jedan redak; provjera adresa daje jedan redak po poslužitelju, tako da puno pokretanje ima trinaest redaka. Devet provjera mora proći, a propust znači neuspjeh. Dvije, grafički čvorovi i certifikat, trebale bi proći, a propust je upozorenje. Posljednji stupac je tekst zahtjeva koji svaki redak prenosi u izvješće; CPU u njemu označava središnju procesorsku jedinicu.
| ID provjere | Odjeljak | Mora proći | Zahtjev koji ispisuje |
|---|---|---|---|
kubernetes-version |
cluster | da | Kubernetes 1.33 ili noviji |
nodes-ready |
cluster | da | Svaki čvor spreman |
storage-class |
cluster | da | Klasa pohrane za podatke |
resources |
cluster | da | Dovoljno CPU-a i memorije za izdanje |
graphics-nodes |
cluster | ne | Grafički čvorovi |
ingress-class |
network | da | Ingress klasa za tri adrese |
ingress-ports |
network | da | Ingress kontroler otvoren na priključcima 80 i 443 |
address-console, address-api, address-auth |
network | da | Adresa console, api ili auth razrješava se u DNS-u |
certificate |
network | ne | Certifikat vrijedi još 30 dana |
custodians |
time-and-keys | da | Osobe koje drže ključeve za oporavak ove instalacije |
installation-name |
time-and-keys | da | Vlastiti trajni naziv ove instalacije |
kubernetes-version
Čita verziju API poslužitelja i uspoređuje je s donjom granicom charta. Pronalazi, na primjer, 1.33.6+k3s1. Ispod 1.33 ne prolazi uz popravak upgrade the cluster to 1.33 or later. Ako niz verzije nije onaj koji nexusctl može pročitati, ne prolazi umjesto da nagađa.
nodes-ready
Ispisuje čvorove i broji one čije je stanje Ready istinito, kao 3 of 3. Svaki čvor koji nije spreman navodi se imenom, a popravak vam govori da ga vratite u stanje Ready i pročitate njegova stanja. Klaster bez ijednog čvora ne prolazi uz napomenu da kontekst možda pokazuje na pogrešan klaster.
storage-class
Ako vaše vrijednosti postavljaju storage.className, provjera traži tu klasu i ne prolazi s <name> does not exist kada ona nedostaje. Ako ne postavljaju, traži klasu označenu kao zadanu i prijavljuje je kao local-path (default). Bez zadane klase ne prolazi s none marked default, a stupac potreba kaže zašto je to važno: the database cannot claim a disk. Ako su dvije klase označene kao zadane, klaster novom zahtjevu daje najnoviju, pa se ta i prijavljuje.
resources
Izračunava što izdanje traži iz charta i vaših vrijednosti, a zatim zbraja dodjeljive jezgre središnje procesorske jedinice (CPU) i memoriju svakog čvora koji je u stanju Ready, nije ograđen (cordoned) i ne nosi oznaku (taint) NoSchedule ili NoExecute. Podovi charta ne nose tolerancije, pa čvor s oznakom ne može pokretati te podove i ne ubraja se. Klaster kojem nedostaje resursa ne prolazi uz točan manjak, kao što je add nodes with 1 more core and 2.5 GiB more memory, or lower the sizes under components and dataTier in harrow-values.yaml. Potrebe se zaokružuju na više, a dostupno na niže, tako da vam provjera nikada ne laska.
graphics-nodes
Traži čvor u stanju Ready s grafičkom procesorskom jedinicom (GPU) koju može dodijeliti, nvidia.com/gpu. Ako nema nijednog, upozorava: the assistant will need a hosted model. Predprovjera to tretira kao savjet i nikada ne blokira zbog toga, jer pomoćnik umjesto toga može odgovarati putem hostiranog modela umjetne inteligencije (AI). Poglavlje 2.14, Pružatelji i modeli AI-ja, obuhvaća oba puta.
ingress-class
Ako je ingress.className postavljen, provjera traži tu klasu. Ako nije, traži točno jednu klasu označenu kao zadanu. Dvije klase označene kao zadane također ne prolaze, jer API poslužitelj tada odbija Ingress bez klase. Provjera se preskače, a njezin redak izostavlja, kada je ingress.enabled postavljen na false.
ingress-ports
Traži u imenskom prostoru imenovanom s networkPolicy.ingressNamespace (zadano kube-system, gdje k3s pokreće Traefik) jedan LoadBalancer ili NodePort Service koji izlaže i 80 i 443. Mrežna politika charta dopušta samo tom imenskom prostoru pristup trima javnim servisima (Services), tako da ingress kontroler bilo gdje drugdje ne bi mogao posluživati Nexus čak ni kada bi slušao. Popravak navodi oba izlaza: izložite kontroler ondje ili postavite networkPolicy.ingressNamespace na mjesto gdje se on izvodi. Preskače se kada je ingress.enabled postavljen na false.
address
Traži hosts.console, hosts.api i hosts.auth s vaše radne stanice, po pet sekundi za svaki, i ispisuje jedan redak po poslužitelju. Poslužitelj bez zapisa ne prolazi s <host> → no record. Nepostavljeni poslužitelj ne prolazi s hosts.<key> is not set. Kada naziv ima nekoliko adresa, redak prikazuje prvu, IPv4 prije IPv6, te koliko ih još ima.
certificate
Izvodi se samo kada je tls.mode postavljen na existing i tls.existingSecret imenuje Secret; uz cert-manager ili none nema vašeg certifikata za čitanje, pa se redak izostavlja. Čita tls.crt iz objekta Secret u imenskom prostoru instalacije i ništa drugo. Certifikat koji vrijedi 30 ili više dana prolazi kao ends 3 Nov 2027. Onaj koji istječe ranije upozorava ends in 9 days; onaj koji je već istekao upozorava ended 4 days ago. Nedostajući Secret, ili onaj u kojem nema certifikata, daje upozorenje s popravkom.
custodians
Čita keys.custody.recipients. Ako nema nijednog, ne prolazi s kodom KEYS_CUSTODIAN_MISSING. Ako je bilo koji primatelj ogledni skrbnik iz vlastitih datoteka vrijednosti charta, ne prolazi s KEYS_CUSTODIAN_EXAMPLE, jer nitko ne drži taj ključ i ključevi za oporavak instalacije bili bi zapečaćeni nikome. Prolaz ispisuje broj, primjerice 3 custodians.
installation-name
Čita keys.installationName. Ako nije postavljeno, ne prolazi s INSTALLATION_NAME_MISSING. Ako je postavljeno na ogledni naziv iz datoteka vrijednosti charta, ne prolazi s INSTALLATION_NAME_EXAMPLE. Prolaz ispisuje naziv. Stupac potreba kaže zašto je ovo važnije od većine drugih: the first key-store bootstrap mints the installation identity under it, permanently.
Posljednje dvije provjere prijavljuju točno one kodove s kojima sam chart odbija instalaciju. Predprovjera vam to samo kaže prva, prije nego što je Helm išta stvorio.
Datoteke izvješća
Svako pokretanje sprema dvije datoteke u --report-dir, nazvane prema vremenu izvođenja: preflight-2026-11-12-0902.txt, retke kakvi su ispisani bez kodova boja, i preflight-2026-11-12-0902.json, isto pokretanje u fiksnom formatu koji program može čitati. Ispis u terminalu i spremljeni retci dolaze s istog popisa, pa se nikada ne razlikuju.
JSON izvješće slijedi shemu nexus.preflight/v1:
| Polje | Što sadrži |
|---|---|
schema |
Točno nexus.preflight/v1 |
tool |
Objekt: name (nexusctl) i version |
release |
Provjereno izdanje |
ran_at |
Kada se izvršilo, u koordiniranom svjetskom vremenu (UTC) |
context |
Naziv kube konteksta |
values |
Samo osnovni naziv datoteke vrijednosti |
read_only |
Uvijek true |
checks |
Jedan unos po retku: id, section, name, requirement, must_pass, outcome (pass, warn ili fail), found, needs, fix, a pri propustu sa strojnim uzrokom, code |
counts |
passed, warnings i failed |
can_install |
true kada ništa nije palo |
report_file |
Naziv datoteke .txt |
transcript |
Objekt: title (nexusctl preflight) i lines, svaki redak sa svojim kind (prompt, ok, warn, bad, note, out ili blank), svojim text i at, a ponekad i marks |
Izvješće je izrađeno tako da se može prikazati prije nego što se itko prijavi, pa ne nosi korisničko ime, naziv poslužitelja radne stanice, putanju datoteke, token i ništa iz vašeg kubeconfiga. values je osnovni naziv, a context je naziv konteksta. Ako bi izvješće pokretanja prekršilo bilo koje od tih pravila, nexusctl ga odbija ispisati, spremiti ili predati te to i kaže. Izvješće ima najviše 256 KiB, s najviše 64 provjere i 512 znakova u bilo kojem pojedinačnom tekstualnom polju.
Kako izvješće stiže do konzole
Jedino pisanje predprovjere je završeno izvješće, predano servisu ključeva instalacije, nexus-keys, tako da ga instalacijski program konzole može prikazati na svojoj stranici predprovjere prije nego što je itko preuzeo instalaciju. --record odlučuje hoće li pokušati:
--record |
Što se događa |
|---|---|
auto |
Predaje izvješće samo kada imenski prostor ima Deployment nexus-keys |
always |
Inzistira; predprovjera izlazi s 2 ako ga nema čemu predati |
never |
Ne predaje ga |
Dakle, pokretanje prije prve instalacije nema čemu predati izvješće i zadržava ga na vašoj radnoj stanici. Pokretanje nakon instalacije, a prije preuzimanja, bilježi ga.
Predaja koristi vaš vlastiti pristup klasteru. nexusctl pokreće /app/nexus-keys preflight-record u kontejneru keys spremnog poda nexus-keys i prosljeđuje izvješće na standardni ulaz. To je isto kao:
kubectl exec -i -n nexus -c keys deploy/nexus-keys -- /app/nexus-keys preflight-record < preflight-2026-11-12-0902.jsonServis ključeva provjerava izvješće prema istim pravilima koja primjenjuje nexusctl i zadržava samo najnovije. Kada se preda, nexusctl ispisuje još jedan redak u kojem to navodi, a spremljeni JSON dobiva note koji bilježi predaju.
Instalacijski program konzole čita ga s javne rute servisa ključeva GET /v1/installation/preflight. Ta ruta odgovara samo dok instalacija nije preuzeta: prije nego što se zabilježi bilo kakvo izvješće, odgovara s 404 RECORD_NOT_FOUND, a nakon što netko preuzme instalaciju, zauvijek odgovara s ROUTE_NOT_FOUND, točno onako kako to čini i ruta za preuzimanje. Izvješće predano nakon preuzimanja odbija se s INSTALLATION_CLAIMED.
Na konzoli se pokretanje s neuspjesima prikazuje kao „Predprovjera se ne može nastaviti”: brojevi neuspjelih, upozorenja i prošlih provjera, a zatim svaka provjera grupirana pod „Mora proći” i „Trebala bi proći”, s onima koje nisu prošle na prvom mjestu i pronađenim riječima pokraj svake. Pokretanje bez neuspjeha ne dobiva tu stranicu; konzola prelazi izravno na preuzimanje (poglavlje 2.12, Prvo pokretanje).
Pristup potreban za pokretanje
Predprovjera se izvodi kao vi, s vašim kubeconfigom. Račun treba čitati:
- čvorove, za provjere verzije, spremnosti, resursa i grafike;
- klase pohrane i ingress klase;
- servise (Services) u ingress imenskom prostoru;
- TLS Secret u imenskom prostoru instalacije, kada se izvodi provjera certifikata.
Kada je čitanje odbijeno, u retku piše could not read <what> (the cluster refused), a popravak navodi koji pristup za čitanje treba odobriti. Riječi nikada ne uključuju adresu poslužitelja ili njegov vlastiti tekst pogreške, jer se izvješće može prikazati prije prijave. Predaja također treba pods/exec na podovima nexus-keys; bez toga, auto sprema datoteke i ispisuje upozorenje, a always izlazi s 2.
Kada se sama predprovjera ne može pokrenuti
Izlazni kod 2 znači da izvješće nije napravljeno. Poruka na standardnom izlazu za pogreške kaže zašto:
| Poruka | Što učiniti |
|---|---|
--context is required: the kube context to check |
Dodajte --context |
--values is required: the values file the install will use |
Dodajte --values |
could not read the values file harrow-values.yaml |
Provjerite putanju i dozvole datoteke |
preflight takes flags only |
Uklonite suvišni argument |
the report breaks its contract and was not printed, saved or handed over |
Polje bi sadržavalo nešto privatno; prijavite to tvrtki Adverant sa zastavicama pokretanja |
--record always: there is no nexus-keys Deployment in the namespace nexus to hand the report to |
Prvo instalirajte ili upotrijebite --record auto |
could not hand the report to this installation |
Provjerite svoj pristup za izvršavanje (exec) u nexus-keys |
Klaster čijem se API-ju ne može pristupiti također izlazi s 2. Popravite kubeconfig ili mrežu pa ga pokrenite ponovno.
Nakon što predprovjera završi s 0 failed, prijeđite na poglavlje 2.6, Instaliranje izdanja Community na Kubernetes, kako biste instalirali izdanje Community, ili poglavlje 2.7, Instaliranje izdanja Enterprise i primjena licencije, za izdanje Enterprise.

