PrijavaRezervirajte prezentaciju

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

16 min čitanja

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.

Prije nego što instalirate
Prije nego što instalirate
Predprovjera u terminalu operatera, s brojevima pokraj nje. Primijetite da svako upozorenje ima svoj popravak ispisan ispod sebe i da pokretanje jasno kaže kako ništa nije promijenilo na klasteru.

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.json

Servis 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).

Predprovjera se ne može nastaviti
Predprovjera se ne može nastaviti
Stranica konzole za pokretanje predprovjere koje se ne može nastaviti. Provjere koje nisu prošle dolaze prve, svaka opisana riječima uz ono što je pronađeno, a instalacija ostaje blokirana dok ne prođu.
Tri stupca. Lijevo, „Radna stanica operatera”: okvir „nexusctl preflight --context --values” s dva izlaza ispod njega, „preflight-<time>.txt” i „preflight-<time>.json”. Sredina, „Instalacija, nepreuzeta”: okvir „nexus-keys” s oznakom „preflight-record, samo najnovije izvješće”. Strelica od lijevog okvira prema okviru nexus-keys označena je s „pod exec s vašim vlastitim pristupom klasteru (--record auto ili always)”. Desno, „Preglednik, prije prijave”: okvir „Instalacijski program konzole, Predprovjera se ne može nastaviti”. Strelica od okvira nexus-keys prema njemu označena je s „GET /v1/installation/preflight”. Ispod srednjeg okvira, mala bilješka glasi „nakon preuzimanja: ROUTE_NOT_FOUND”.
Kamo ide jedno izvješće predprovjere, od radne stanice operatera do preglednika.

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.