Útgáfa 1.0.0-alpha.1nýjast
Kafli 2.5
Forathugun með nexusctl
Hver einasta athugun sem `nexusctl preflight` framkvæmir, hvað hver þeirra les og hvernig hún bregst, skýrslan sem hún prentar og vistar, hvernig sú skýrsla skilar sér á forathugunarsíðu stjórnborðsins og hvert einasta flagg.
Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

Fyrsta undirbúningsathugun okkar hjá Harrow Port Authority féll á fjórum prófunum og tvær þeirra hefðu kostað okkur mun meira en einn síðdegispart. Við höfðum byrjað á gildaskránni með því að afrita dæmið úr Helm-pakkanum (chart), og undirbúningsathugunin hafnaði bæði dæmigildinu fyrir nafn uppsetningarinnar og dæmigildinu fyrir vörsluaðilann. Enginn hefur einkalykil þess vörsluaðila undir höndum. Uppsetningu sem er innsigluð með honum er aldrei hægt að opna aftur eftir endurræsingu hnúts. Undirbúningsathugunin greindi þetta á nokkrum sekúndum, áður en nokkuð var til sem hægt var að tapa.
nexusctl preflight les klasann þinn og gildaskrána þína, birtir það sem fannst, vistar skýrslu og breytir engu á klasanum. Keyrðu hana fyrir hverja uppsetningu og hverja uppfærslu. Þessi kafli fjallar um allar athuganir sem hún gerir, snið skýrslunnar, hvert skýrslan fer og rofana.
Reksturinn
Undirbúningsathugunin þarf tvennt: kube-samhengi klasans sem þú ætlar að setja upp á og gildaskrána sem uppsetningin mun nota. Skrifaðu gildaskrána fyrst; í kafla 2.6, Uppsetning Community á Kubernetes, er farið yfir hvern lykil. Síðan:
nexusctl preflight --context harrow-prod --values harrow-values.yamlHún les klasann í gegnum client-go eingöngu með get- og list-köllum. Ef tls.mode hjá þér er existing skaltu búa til nexus nafnarýmið og Transport Layer Security (TLS) Secret áður en þú keyrir hana (kafli 2.6, Uppsetning Community á Kubernetes, skref 3), annars greinir skilríkjaathugunin frá því að Secret vanti.
| Rofi | Hvað hann gerir | Sjálfgefið |
|---|---|---|
--context <name> |
Kube-samhengið sem á að athuga. Áskilið | ekkert |
--values <file> |
Gildaskráin sem uppsetningin mun nota. Áskilið | ekkert |
--namespace <name> |
Hvar Nexus er sett upp | nexus |
--release <version> |
Útgáfan sem verið er að athuga | útgáfa meðfylgjandi korts |
--report-dir <dir> |
Hvar skýrsluskrárnar tvær eru vistaðar | núverandi mappa |
--record <mode> |
auto, always eða never: hvort afhenda eigi lyklaþjónustu þessarar uppsetningar skýrsluna, svo að uppsetningarsíða hennar sýni hana |
auto |
--kubeconfig <file> |
Kubeconfig-skráin sem á að lesa | KUBECONFIG, síðan ~/.kube/config |
--ca-bundle <file> |
Þín eigin vottunarstöðvarskilríki (CA), fyrir keðju sem athuganirnar eiga að treysta | ekkert |
--single-node |
Athuga eina vél fyrir uppsetningu á einni vél (kafli 2.8, Uppsetningar á einni vél) | slökkt |
Lágmarkskrafa útgáfunnar fyrir Kubernetes er ekki slegin inn í nexusctl. Hún les neðri mörk kubeVersion kortsins úr kortinu sem hún ber með sér, þannig að athugunin og helm install geta aldrei verið ósammála.
Hvað keyrsla prentar
Hér er fyrsta keyrsla Harrow, eins og hún birtist:
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
Þegar eitthvað mistekst koma villurnar fyrst, síðan viðvaranirnar og loks það sem stóðst. Hver lína sýnir niðurstöðuna, heiti athugunarinnar, hvað fannst og hvað hún þarf; hver lína sem stóðst ekki er með fix línu fyrir neðan sig. Síðustu tvær línurnar eru samantektin og skýrsluskráin.
Við löguðum gildin, bættum við tveimur Domain Name System (DNS) færslum, bjuggum til Secret og keyrðum hana aftur:
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
Keyrsla án villna birtir athuganirnar undir þremur fyrirsögnum þeirra: Klasi, Net og Tími og lyklar. Viðvaranir stöðva aldrei ferlið. Við héldum skjáviðvöruninni viljandi: á þessum tengda tilraunaklasa notaði aðstoðarmaður Harrow hýst líkan með eigin lykli hafnarinnar.
Útgöngukóðar
| Kóði | Merking |
|---|---|
0 |
Uppsetningin getur haldið áfram. Viðvaranir stöðva hana ekki |
1 |
Uppsetningin er stöðvuð: að minnsta kosti ein athugun mistókst |
2 |
Ekki tókst að keyra undirbúningsathugun: ekki var hægt að lesa kubeconfig, samhengið, gildaskrána eða forritaskil (API) klasans, eða rofi var rangur |
Skriftur ættu að lesa útgöngukóðann, ekki orðin. Okkar skrifta keyrir undirbúningsathugun sem fyrsta skref í hverri uppfærslu og stöðvast við allt annað en 0.
Keyrðu nexusctl fyrir útgáfuna sem þú ert að færa þig yfir í, ekki þá sem þú settir upp með. Kröfurnar koma úr kortinu sem hún ber með sér, þannig að nýrri útgáfa getur hækkað lágmarkskröfu Kubernetes eða beðið um meira minni, og aðeins hennar eigin nexusctl veit af því. --release breytir útgáfunni sem skýrslan nefnir; það breytir ekki reglum hvaða korts er beitt. Hjá Harrow geymum við nexusctl hverrar útgáfu við hlið korts hennar í breytingaskránni, þannig að afturköllun er athuguð með tólinu sem passar við hana.
Hver athugun
Athuganirnar eru ellefu. Tíu þeirra skila einni línu hver; vistfangaathugunin skilar einni línu fyrir hvern hýsil, þannig að heildarkeyrsla hefur þrettán línur. Níu athuganir verða að standast og ef eitthvað vantar er það villa. Tvær, grafíkhnútarnir og skilríkið, ættu að standast og ef eitthvað vantar er það viðvörun. Síðasti dálkurinn er kröfutextinn sem hver lína tekur með sér inn í skýrsluna; CPU í honum stendur fyrir örgjörva (central processing unit).
| Auðkenni athugunar | Hluti | Verður að standast | Krafa sem birtist |
|---|---|---|---|
kubernetes-version |
cluster | já | Kubernetes 1.33 eða nýrra |
nodes-ready |
cluster | já | Allir hnútar tilbúnir |
storage-class |
cluster | já | Geymsluflokkur fyrir gögnin |
resources |
cluster | já | Nægur örgjörvi og minni fyrir útgáfuna |
graphics-nodes |
cluster | nei | Skjákortshnútar |
ingress-class |
network | já | Innstreymisflokkur fyrir vistföngin þrjú |
ingress-ports |
network | já | Innstreymisstýringin opin á gáttum 80 og 443 |
address-console, address-api, address-auth |
network | já | Vistfang console, api eða auth leysist í DNS |
certificate |
network | nei | Skilríki gilt í 30 daga í viðbót |
custodians |
time-and-keys | já | Fólkið sem geymir endurheimtarlykla þessarar uppsetningar |
installation-name |
time-and-keys | já | Varanlegt eigin nafn þessarar uppsetningar |
kubernetes-version
Les útgáfu API-þjónsins og ber hana saman við lágmarkskröfu kortsins. Hún finnur til dæmis 1.33.6+k3s1. Fyrir neðan 1.33 mistekst hún með leiðréttingunni upgrade the cluster to 1.33 or later. Ef útgáfustrengurinn er ekki á sniði sem nexusctl getur lesið, mistekst hún frekar en að giska.
nodes-ready
Listar upp hnútana og telur þá þar sem skilyrðið Ready er satt, sem 3 of 3. Hver hnútur sem ekki er tilbúinn er nefndur og leiðréttingin segir þér að koma honum aftur í Ready-ástand og lesa skilyrði hans. Klasi án nokkurra hnúta mistekst með vísbendingu um að samhengið vísi hugsanlega á rangan klasa.
storage-class
Ef gildin þín stilla storage.className flettir athugunin þeim flokki upp og mistekst með <name> does not exist þegar hann vantar. Ef þau gera það ekki leitar hún að flokki sem er merktur sjálfgefinn og greinir frá honum sem local-path (default). Ef enginn sjálfgefinn er til staðar mistekst hún með none marked default, og kröfudálkurinn segir hvers vegna það skiptir máli: the database cannot claim a disk. Ef tveir flokkar eru merktir sjálfgefnir gefur klasinn nýrri beiðni þann nýjasta, þannig að greint er frá honum.
resources
Reiknar út hvað útgáfan biður um út frá kortinu og gildunum þínum, og leggur síðan saman úthlutanlega örgjörvakjarna (CPU) og minni allra hnúta sem eru Ready, ekki einangraðir (cordoned), og bera hvorki NoSchedule né NoExecute merkingu (taint). Pod-einingar kortsins bera engar undanþágur (tolerations), þannig að merktur hnútur getur ekki keyrt þær og er ekki talinn með. Klasi sem skortir tilföng mistekst og sýnir nákvæmlega hvað vantar upp á, svo sem add nodes with 1 more core and 2.5 GiB more memory, or lower the sizes under components and dataTier in harrow-values.yaml. Þarfir eru námundaðar upp og framboð námundað niður, þannig að athugunin gefur aldrei of jákvæða mynd.
graphics-nodes
Leitar að Ready-hnút með skjáörgjörva (GPU) sem hann getur úthlutað, nvidia.com/gpu. Ef enginn finnst varar hún við: the assistant will need a hosted model. Undirbúningsathugunin lítur á þetta sem ráðleggingu og stöðvar aldrei ferlið vegna hennar, því aðstoðarmaðurinn getur svarað í gegnum hýst gervigreindarlíkan (AI) í staðinn. Kafli 2.14, Gervigreindarveitur og líkön, fjallar um báðar leiðirnar.
ingress-class
Ef ingress.className er stillt flettir athugunin þeim flokki upp. Ef ekki, leitar hún að nákvæmlega einum flokki sem er merktur sjálfgefinn. Tveir flokkar merktir sjálfgefnir valda líka villu, vegna þess að API-þjónninn hafnar þá Ingress án flokks. Athuguninni er sleppt, og línunni hennar haldið utan við, þegar ingress.enabled er false.
ingress-ports
Leitar í nafnarýminu sem nefnt er af networkPolicy.ingressNamespace (sjálfgefið kube-system, þar sem k3s keyrir Traefik) að einni LoadBalancer- eða NodePort-þjónustu (Service) sem opnar bæði gáttir 80 og 443. Netstefna kortsins leyfir aðeins því nafnarými að ná til opinberu þjónustanna þriggja, þannig að innstreymisstýring annars staðar gæti ekki þjónað Nexus jafnvel þótt hún væri að hlusta. Leiðréttingin nefnir báðar útleiðirnar: opnaðu stýringuna þar, eða stilltu networkPolicy.ingressNamespace á staðinn þar sem hún keyrir. Sleppt þegar ingress.enabled er false.
address
Flettir upp hosts.console, hosts.api og hosts.auth frá vinnustöðinni þinni, fimm sekúndur hvert, og birtir eina línu fyrir hvern hýsil. Hýsill án færslu mistekst með <host> → no record. Óstilltur hýsill mistekst með hosts.<key> is not set. Þegar nafn hefur nokkur vistföng sýnir línan það fyrsta, IPv4 á undan IPv6, og hversu mörg í viðbót eru til staðar.
certificate
Keyrir aðeins þegar tls.mode er existing og tls.existingSecret nefnir Secret; með cert-manager eða none er ekkert skilríki frá þér til að lesa, og línunni er sleppt. Hún les tls.crt úr Secret í uppsetningarnafnarýminu og ekkert annað. Skilríki sem gildir í 30 daga eða lengur stenst sem ends 3 Nov 2027. Skilríki sem rennur út fyrr varar við með ends in 9 days; skilríki sem þegar er runnið út varar við með ended 4 days ago. Ef Secret vantar, eða ef ekkert skilríki er í því, kemur viðvörun með leiðréttingunni.
custodians
Les keys.custody.recipients. Ef enginn er til staðar mistekst hún með kóðanum KEYS_CUSTODIAN_MISSING. Ef einhver viðtakandi er sýndarvörsluaðilinn úr eigin gildaskrám kortsins mistekst hún með KEYS_CUSTODIAN_EXAMPLE, vegna þess að enginn hefur þann lykil undir höndum og endurheimtarlyklar uppsetningarinnar yrðu innsiglaðir engum. Ef hún stenst birtist fjöldinn, svo sem 3 custodians.
installation-name
Les keys.installationName. Ef það er óstillt mistekst hún með INSTALLATION_NAME_MISSING. Ef það er stillt á sýndarnafnið úr gildaskrám kortsins mistekst hún með INSTALLATION_NAME_EXAMPLE. Ef hún stenst birtist nafnið. Kröfudálkurinn segir hvers vegna þessi skiptir meira máli en flestar aðrar: the first key-store bootstrap mints the installation identity under it, permanently.
Síðustu tvær athuganirnar skila nákvæmlega sömu kóðum og kortið sjálft notar til að hafna uppsetningu. Undirbúningsathugunin lætur þig einfaldlega vita fyrst, áður en Helm hefur búið nokkuð til.
Skýrsluskrárnar
Hver keyrsla vistar tvær skrár í --report-dir, nefndar eftir tímanum sem hún keyrði: preflight-2026-11-12-0902.txt, línurnar eins og þær birtust án litakóða, og preflight-2026-11-12-0902.json, sömu keyrslu á föstu sniði sem forrit getur lesið. Úttakið í skipanalínunni og vistuðu línurnar koma af sama lista, þannig að þau eru aldrei ólík.
JSON-skýrslan fylgir skemanu nexus.preflight/v1:
| Reitur | Hvað það geymir |
|---|---|
schema |
Nákvæmlega nexus.preflight/v1 |
tool |
Hlutur: name (nexusctl) og version |
release |
Útgáfan sem var athuguð |
ran_at |
Hvenær hún keyrði, á samræmdum heimstíma (UTC) |
context |
Heiti kube-samhengisins |
values |
Aðeins grunnheiti gildaskrárinnar |
read_only |
Alltaf true |
checks |
Ein færsla fyrir hverja línu: id, section, name, requirement, must_pass, outcome (pass, warn eða fail), found, needs, fix, og ef eitthvað bregst af völdum vélar, code |
counts |
passed, warnings og failed |
can_install |
true þegar ekkert mistókst |
report_file |
Heiti .txt skrárinnar |
transcript |
Hlutur: title (nexusctl preflight) og lines, hver lína með sínu kind (prompt, ok, warn, bad, note, out eða blank), sínu text og at, og stundum marks |
Skýrslan er gerð til að vera sýnd áður en nokkur skráir sig inn, þannig að hún inniheldur ekkert notendanafn, ekkert hýsilheiti vinnustöðvar, enga skráarslóð, engan tóka og ekkert úr kubeconfig-skránni þinni. values er grunnheiti og context er heiti samhengisins. Ef skýrsla keyrslu myndi brjóta einhverja af þessum reglum, neitar nexusctl að birta, vista eða afhenda hana, og tekur það fram. Skýrsla er í mesta lagi 256 KiB, með í mesta lagi 64 athugunum og 512 stafatáknum í hverjum textareit.
Hvernig skýrslan skilar sér í stjórnborðið
Eina skrifaðgerð undirbúningsathugunarinnar er fullgerða skýrslan, sem afhent er lyklaþjónustu uppsetningarinnar, nexus-keys, þannig að uppsetningarforrit stjórnborðsins geti sýnt hana á síðu undirbúningsathugunarinnar áður en nokkur hefur gert tilkall til uppsetningarinnar. --record ákveður hvort reynt skuli:
--record |
Hvað gerist |
|---|---|
auto |
Afhendir skýrsluna aðeins þegar nafnarýmið er með nexus-keys Deployment |
always |
Krefst afhendingar; undirbúningsathugun hættir með 2 ef ekkert er til staðar til að afhenda hana til |
never |
Afhendir hana ekki |
Þannig að keyrsla fyrir fyrstu uppsetningu hefur ekkert til að afhenda til og geymir skýrsluna á vinnustöðinni þinni. Keyrsla eftir uppsetninguna og áður en tilkall er gert skráir hana.
Afhendingin notar þinn eigin klasaaðgang. nexusctl keyrir /app/nexus-keys preflight-record í keys gámnum á tilbúnu nexus-keys pod-i og sendir skýrsluna inn á staðalinntak (standard input). Það er það sama og:
kubectl exec -i -n nexus -c keys deploy/nexus-keys -- /app/nexus-keys preflight-record < preflight-2026-11-12-0902.jsonLyklaþjónustan athugar skýrsluna samkvæmt sömu reglum og nexusctl beitir og geymir aðeins þá nýjustu. Þegar hún er afhent birtir nexusctl eina línu í viðbót sem segir frá því, og vistaða JSON-skráin fær note sem skráir afhendinguna.
Uppsetningarforrit stjórnborðsins les hana af opinberu leið lyklaþjónustunnar, GET /v1/installation/preflight. Sú leið svarar aðeins á meðan enginn hefur gert tilkall til uppsetningarinnar: áður en nokkur skýrsla er skráð svarar hún 404 RECORD_NOT_FOUND, og um leið og einhver gerir tilkall til uppsetningarinnar svarar hún ROUTE_NOT_FOUND fyrir fullt og allt, nákvæmlega eins og tilkallsleiðin gerir. Skýrslu sem afhent er eftir tilkallið er hafnað með INSTALLATION_CLAIMED.
Á stjórnborðinu birtist keyrsla með villum sem „Undirbúningsathugun getur ekki haldið áfram“: fjöldi villna, viðvarana og þess sem stóðst, síðan hver athugun flokkuð undir „Verður að standast“ og „Ætti að standast“, þar sem þær sem stóðust ekki koma fyrst og orðin yfir það sem fannst við hlið hverrar. Keyrsla án villna fær ekki þá síðu; stjórnborðið fer beint áfram í tilkallið (kafli 2.12, Fyrsta keyrslan).
Aðgangur sem keyrslan þarf
Undirbúningsathugunin keyrir sem þú, með kubeconfig-skránni þinni. Aðgangurinn þarf að geta lesið:
- hnúta (nodes), fyrir athuganir á útgáfu, tilbúnu ástandi, tilföngum og skjáörgjörvum;
- geymsluflokka (storage classes) og innstreymisflokka (ingress classes);
- þjónustur (Services) í innstreymisnafnarýminu;
- TLS Secret í uppsetningarnafnarýminu, þegar skilríkjaathugunin keyrir.
Þegar lestri er hafnað segir línan could not read <what> (the cluster refused), og leiðréttingin segir hvaða lesaðgang þarf að veita. Orðin innihalda aldrei vistfang þjónsins eða eigin villutexta hans, vegna þess að skýrslan gæti verið sýnd fyrir innskráningu. Afhendingin þarf einnig pods/exec á nexus-keys pod-einingarnar; án þess vistar auto skrárnar og birtir viðvörun, og always hættir með 2.
Þegar forathugunin sjálf getur ekki keyrt
Útgöngukóði 2 þýðir að engin skýrsla var búin til. Skilaboðin á staðalvilluúttaki (standard error) segja hvers vegna:
| Skilaboð | Hvað skal gera |
|---|---|
--context is required: the kube context to check |
Bæta við --context |
--values is required: the values file the install will use |
Bæta við --values |
could not read the values file harrow-values.yaml |
Athugaðu slóðina og heimildir skrárinnar |
preflight takes flags only |
Fjarlægðu aukaviðfangið |
the report breaks its contract and was not printed, saved or handed over |
Reitur hefði innihaldið eitthvað persónulegt; tilkynntu það til Adverant ásamt rofum keyrslunnar |
--record always: there is no nexus-keys Deployment in the namespace nexus to hand the report to |
Settu fyrst upp, eða notaðu --record auto |
could not hand the report to this installation |
Athugaðu aðgang þinn til að keyra exec inn í nexus-keys |
Klasi þar sem ekki næst í API hættir líka með 2. Lagaðu kubeconfig eða netið og keyrðu hana aftur.
Þegar undirbúningsathugun lýkur með 0 failed skaltu halda áfram í kafla 2.6, Uppsetning Community á Kubernetes, til að setja upp Community, eða kafla 2.7, Uppsetning Enterprise og virkjun leyfis, fyrir Enterprise.

