Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.5
Kontrolli paraprak me nexusctl
Çdo kontroll që bën `nexusctl preflight`, çfarë lexon secili dhe si dështon, raporti që ai printon dhe ruan, si arrin ai raport në faqen e kontrollit paraprak të konsolës, dhe çdo parametër (flag).
Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

Kontrolli ynë i parë paraprak (preflight) në Harrow Port Authority dështoi në katër kontrolle, dhe dy prej tyre do të na kishin kushtuar shumë më tepër se një pasdite. E kishim nisur skedarin e vlerave duke kopjuar shembullin e chart-it, dhe kontrolli paraprak refuzoi si emrin e instalimit shembull, ashtu edhe kujdestarin shembull. Askush nuk e mban çelësin privat të atij kujdestari. Një instalim i vulosur me të nuk mund të çvuloset kurrë pas rindezjes së një nyjeje. Kontrolli paraprak e kapi këtë brenda pak sekondash, përpara se të ekzistonte ndonjë gjë për t'u humbur.
nexusctl preflight lexon klasterin tuaj dhe skedarin tuaj të vlerave, printon çfarë gjeti, ruan një raport dhe nuk ndryshon asgjë në klaster. Ekzekutojeni përpara çdo instalimi dhe çdo përditësimi. Ky kapitull mbulon çdo kontroll që ai kryen, formatin e raportit, ku shkon raporti dhe flamujt (flags).
Ekzekutimi i tij
Kontrolli paraprak ka nevojë për dy gjëra: kontekstin kube të klasterit ku do të instaloni dhe skedarin e vlerave që do të përdorë instalimi. Shkruani fillimisht skedarin e vlerave; kapitulli 2.6, Instalimi i Community në Kubernetes, shpjegon çdo çelës. Më pas:
nexusctl preflight --context harrow-prod --values harrow-values.yamlAi e lexon klasterin përmes client-go vetëm me thirrje get dhe list. Nëse tls.mode juaj është existing, krijoni hapësirën e emrave (namespace) nexus dhe Secret-in e Transport Layer Security (TLS) përpara se ta ekzekutoni (kapitulli 2.6, Instalimi i Community në Kubernetes, hapi 3), përndryshe kontrolli i certifikatës raporton se Secret-i mungon.
| Flamuri | Çfarë bën | Parazgjedhja |
|---|---|---|
--context <name> |
Konteksti kube për t'u kontrolluar. I detyrueshëm | asnjë |
--values <file> |
Skedari i vlerave që do të përdorë instalimi. I detyrueshëm | asnjë |
--namespace <name> |
Ku instalohet Nexus | nexus |
--release <version> |
Versioni (release) që po kontrollohet | versioni i vetë chart-it të përfshirë |
--report-dir <dir> |
Ku ruhen dy skedarët e raportit | dosja aktuale |
--record <mode> |
auto, always ose never: nëse raporti duhet t'i dorëzohet shërbimit të çelësave të këtij instalimi, në mënyrë që faqja e tij e instaluesit ta shfaqë atë |
auto |
--kubeconfig <file> |
Skedari kubeconfig për t'u lexuar | KUBECONFIG, pastaj ~/.kube/config |
--ca-bundle <file> |
Certifikatat e autoritetit tuaj të certifikatave (CA), për një zinxhir që kontrollet duhet ta besojnë | asnjë |
--single-node |
Kontrolloni një makinë për një instalim në një makinë të vetme (kapitulli 2.8, Instalimet në një makinë të vetme) | joaktiv |
Kufiri minimal i versionit për Kubernetes nuk është i shkruar drejtpërdrejt në nexusctl. Ai lexon kufirin e poshtëm të vetë kubeVersion të chart-it nga chart-i që mbart, kështu që kontrolli dhe helm install nuk mund të bien kurrë në kundërshtim.
Çfarë printon një ekzekutim
Ja ekzekutimi i parë i Harrow, ashtu siç u printua:
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
Kur diçka dështon, dështimet vijnë të parat, pastaj paralajmërimet, pastaj kalimet me sukses. Çdo rresht tregon rezultatin, emrin e kontrollit, çfarë u gjet dhe çfarë i nevojitet; çdo rresht që nuk kaloi ka një rresht fix poshtë tij. Dy rreshtat e fundit janë përmbledhja dhe skedari i raportit.
Ne rregulluam vlerat, shtuam dy regjistrimet e Domain Name System (DNS), krijuam Secret-in dhe e ekzekutuam përsëri:
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
Një ekzekutim pa dështime i rendit kontrollet nën tre titujt e tyre: Klasteri, Rrjeti, dhe Koha dhe çelësat. Paralajmërimet nuk bllokojnë kurrë. E mbajtëm paralajmërimin e grafikës qëllimisht: në këtë klaster pilot të lidhur, asistenti i Harrow përdorte një model të hostuar me çelësin e vetë portit.
Kodet e daljes
| Kodi | Kuptimi |
|---|---|
0 |
Instalimi mund të vazhdojë. Paralajmërimet nuk bllokojnë |
1 |
Instalimi është i bllokuar: të paktën një kontroll dështoi |
2 |
Kontrolli paraprak nuk mundi të ekzekutohej: skedari kubeconfig, konteksti, skedari i vlerave ose ndërfaqja e programimit të aplikacioneve (API) e klasterit nuk mund të lexohej, ose një flamur ishte i gabuar |
Skriptet duhet të lexojnë kodin e daljes, jo fjalët. I yni ekzekuton kontrollin paraprak si hapin e parë të çdo përditësimi dhe ndalon në çdo gjë tjetër përveç 0.
Ekzekutoni nexusctl e versionit ku po kaloni, jo atë me të cilin keni instaluar. Kërkesat vijnë nga chart-i që ai mbart, kështu që një version më i ri mund të rrisë kufirin minimal të Kubernetes ose të kërkojë më shumë memorie, dhe vetëm nexusctl i tij e di këtë. --release ndryshon versionin që përmend raporti; nuk ndryshon rregullat e cilit chart zbatohen. Në Harrow ne mbajmë nexusctl e çdo versioni pranë chart-it të tij në regjistrin e ndryshimeve, kështu që një rikthim pas (rollback) kontrollohet nga mjeti që i përshtatet atij.
Çdo kontroll
Janë njëmbëdhjetë kontrolle. Dhjetë prej tyre prodhojnë nga një rresht secili; kontrolli i adresës prodhon një rresht për çdo host, kështu që një ekzekutim i plotë ka trembëdhjetë rreshta. Nëntë kontrolle duhet të kalojnë me patjetër, dhe një mungesë është dështim. Dy, nyjet grafike dhe certifikata, është mirë të kalojnë, dhe një mungesë është paralajmërim. Kolona e fundit është teksti i kërkesës që çdo rresht mbart në raport; CPU në të është njësia qendrore e përpunimit.
| ID e kontrollit | Seksioni | Duhet të kalojë | Kërkesa që printon |
|---|---|---|---|
kubernetes-version |
cluster | po | Kubernetes 1.33 ose më i ri |
nodes-ready |
cluster | po | Çdo nyje gati |
storage-class |
cluster | po | Një klasë ruajtjeje (storage class) për të dhënat |
resources |
cluster | po | Mjaftueshëm CPU dhe memorie për versionin |
graphics-nodes |
cluster | jo | Nyjet grafike |
ingress-class |
network | po | Një klasë ingress për tre adresat |
ingress-ports |
network | po | Kontrolluesi ingress i hapur në portat 80 dhe 443 |
address-console, address-api, address-auth |
network | po | Adresa console, api ose auth zbërthehet në DNS |
certificate |
network | jo | Certifikata e vlefshme për 30 ditë të tjera |
custodians |
time-and-keys | po | Personat që mbajnë çelësat e rikuperimit të këtij instalimi |
installation-name |
time-and-keys | po | Emri i përhershëm i vetë këtij instalimi |
kubernetes-version
Lexon versionin e serverit API dhe e krahason atë me kufirin minimal të chart-it. Gjen, për shembull, 1.33.6+k3s1. Nën 1.33 dështon me rregullimin upgrade the cluster to 1.33 or later. Nëse vargu i versionit nuk është një që nexusctl mund ta lexojë, ai dështon në vend që të hamendësojë.
nodes-ready
Rendit nyjet dhe numëron ato ku kushti Ready është i vërtetë, si 3 of 3. Çdo nyje që nuk është gati përmendet me emër, dhe rregullimi ju thotë ta ktheni në gjendjen Ready dhe të lexoni kushtet e saj. Një klaster pa asnjë nyje dështon me një sugjerim se konteksti mund të tregojë drejt klasterit të gabuar.
storage-class
Nëse vlerat tuaja caktojnë storage.className, kontrolli kërkon atë klasë dhe dështon me <name> does not exist kur ajo mungon. Nëse nuk e caktojnë, ai kërkon një klasë të shënuar si të parazgjedhur (default) dhe e raporton atë si local-path (default). Pa asnjë parazgjedhje dështon me none marked default, dhe kolona e nevojave thotë pse ka rëndësi kjo: the database cannot claim a disk. Nëse dy klasa janë shënuar si të parazgjedhura, klasteri i jep një kërkese të re më të renë, kështu që ajo është klasa e raportuar.
resources
Llogarit se çfarë kërkon versioni nga chart-i dhe vlerat tuaja, pastaj mbledh bërthamat e alokueshme të njësisë qendrore të përpunimit (CPU) dhe memorien e çdo nyjeje që është Ready, e paizoluar (not cordoned), dhe që nuk mbart shenjën (taint) NoSchedule ose NoExecute. Pod-et e chart-it nuk mbartin tolerime, kështu që një nyje me shenjë (tainted) nuk mund t'i ekzekutojë ato dhe nuk numërohet. Një klaster i pamjaftueshëm dështon me mungesën e saktë, siç është add nodes with 1 more core and 2.5 GiB more memory, or lower the sizes under components and dataTier in harrow-values.yaml. Nevojat rrumbullakosen lart dhe oferta rrumbullakoset poshtë, kështu që kontrolli nuk ju bën kurrë lajka.
graphics-nodes
Kërkon një nyje Ready me një njësi të përpunimit grafik (GPU) që mund ta alokojë, nvidia.com/gpu. Kur nuk ka asnjë, paralajmëron: the assistant will need a hosted model. Kontrolli paraprak e trajton atë si këshillë dhe nuk bllokon kurrë për shkak të saj, sepse asistenti mund të përgjigjet përmes një modeli të hostuar të inteligjencës artificiale (AI). Kapitulli 2.14, Ofruesit dhe modelet e AI, mbulon të dyja rrugët.
ingress-class
Nëse ingress.className është caktuar, kontrolli kërkon atë klasë. Nëse jo, kërkon saktësisht një klasë të shënuar si të parazgjedhur. Dy klasa të shënuara si të parazgjedhura dështojnë gjithashtu, sepse serveri API atëherë refuzon një Ingress pa klasë. Kontrolli anashkalohet, dhe rreshti i tij lihet jashtë, kur ingress.enabled është false.
ingress-ports
Kërkon në hapësirën e emrave të emërtuar nga networkPolicy.ingressNamespace (si parazgjedhje kube-system, ku k3s ekzekuton Traefik) për një Service të llojit LoadBalancer ose NodePort që ekspozon të dyja portat 80 dhe 443. Politika e rrjetit e chart-it lejon vetëm atë hapësirë emrash të arrijë tre shërbimet (Services) publike, kështu që një kontrollues ingress kudo tjetër nuk do të mund t'i shërbente Nexus-it edhe sikur të ishte duke dëgjuar. Rregullimi përmend të dyja rrugëdaljet: ekspozoni kontrolluesin atje, ose caktoni networkPolicy.ingressNamespace atje ku ai ekzekutohet. Anashkalohet kur ingress.enabled është false.
address
Kërkon hosts.console, hosts.api dhe hosts.auth nga stacioni juaj i punës, nga pesë sekonda secilin, dhe printon një rresht për çdo host. Një host pa regjistrim dështon me <host> → no record. Një host i pacaktuar dështon me hosts.<key> is not set. Kur një emër ka disa adresa, rreshti tregon të parën, IPv4 përpara IPv6, dhe sa të tjera ka.
certificate
Ekzekutohet vetëm kur tls.mode është existing dhe tls.existingSecret emërton një Secret; me cert-manager ose none nuk ka asnjë certifikatë tuajën për të lexuar, dhe rreshti lihet jashtë. Ai lexon tls.crt nga Secret-i në hapësirën e emrave të instalimit dhe asgjë tjetër. Një certifikatë e vlefshme për 30 ditë ose më shumë kalon si ends 3 Nov 2027. Një që përfundon më shpejt paralajmëron ends in 9 days; një që tashmë ka përfunduar paralajmëron ended 4 days ago. Një Secret që mungon, ose një pa certifikatë në të, paralajmëron me rregullimin përkatës.
custodians
Lexon keys.custody.recipients. Kur nuk ka asnjë, dështon me kodin KEYS_CUSTODIAN_MISSING. Nëse ndonjë marrës është kujdestari shembull nga skedarët e vlerave të vetë chart-it, dështon me KEYS_CUSTODIAN_EXAMPLE, sepse askush nuk e mban atë çelës dhe çelësat e rikuperimit të instalimit do të vuloseshin për askënd. Një kalim me sukses printon numrin, siç është 3 custodians.
installation-name
Lexon keys.installationName. I pacaktuar, dështon me INSTALLATION_NAME_MISSING. I caktuar me emrin shembull nga skedarët e vlerave të chart-it, dështon me INSTALLATION_NAME_EXAMPLE. Një kalim me sukses printon emrin. Kolona e nevojave thotë pse ky ka më shumë rëndësi se shumica: the first key-store bootstrap mints the installation identity under it, permanently.
Dy kontrollet e fundit raportojnë saktësisht kodet me të cilat vetë chart-i refuzon një instalim. Kontrolli paraprak thjesht jua thotë më parë, përpara se Helm të ketë krijuar ndonjë gjë.
Skedarët e raportit
Çdo ekzekutim ruan dy skedarë në --report-dir, të emërtuar sipas kohës kur u ekzekutua: preflight-2026-11-12-0902.txt, rreshtat siç u printuan pa kode ngjyrash, dhe preflight-2026-11-12-0902.json, i njëjti ekzekutim në një format fiks që një program mund ta lexojë. Dalja në terminal dhe rreshtat e ruajtur vijnë nga e njëjta listë, kështu që nuk ndryshojnë kurrë.
Raporti JSON ndjek skemën nexus.preflight/v1:
| Fusha | Çfarë mban |
|---|---|
schema |
Saktësisht nexus.preflight/v1 |
tool |
Një objekt: name (nexusctl) dhe version |
release |
Versioni i kontrolluar |
ran_at |
Kur u ekzekutua, në Kohën Universale të Koordinuar (UTC) |
context |
Emri i kontekstit kube |
values |
Vetëm emri bazë i skedarit të vlerave |
read_only |
Gjithmonë true |
checks |
Një hyrje për rresht: id, section, name, requirement, must_pass, outcome (pass, warn ose fail), found, needs, fix, dhe në rast mungese me shkak makine, code |
counts |
passed, warnings dhe failed |
can_install |
true kur asgjë nuk dështoi |
report_file |
Emri i skedarit .txt |
transcript |
Një objekt: title (nexusctl preflight) dhe lines, çdo rresht me kind e tij (prompt, ok, warn, bad, note, out ose blank), text dhe at e tij, dhe ndonjëherë marks |
Raporti është ndërtuar që të shfaqet përpara se dikush të identifikohet, kështu që nuk mbart asnjë emër përdoruesi, asnjë emër hosti të stacionit të punës, asnjë shteg skedari, asnjë token dhe asgjë nga skedari juaj kubeconfig. values është një emër bazë dhe context është emri i kontekstit. Nëse raporti i një ekzekutimi do të shkelte ndonjë nga ato rregulla, nexusctl refuzon ta printojë, ta ruajë ose ta dorëzojë atë, dhe e thotë këtë. Një raport është më së shumti 256 KiB, me më së shumti 64 kontrolle dhe 512 karaktere në çdo fushë të vetme teksti.
Si arrin raporti në konsolë
E vetmja gjë që shkruan kontrolli paraprak është raporti i përfunduar, i dorëzuar te shërbimi i çelësave të instalimit, nexus-keys, në mënyrë që instaluesi i konsolës të mund ta shfaqë atë në faqen e tij të kontrollit paraprak përpara se dikush ta ketë marrë në pronësi (claimed) instalimin. --record vendos nëse do të provojë:
--record |
Çfarë ndodh |
|---|---|
auto |
E dorëzon raportin vetëm kur hapësira e emrave ka një Deployment nexus-keys |
always |
Insiston; kontrolli paraprak del me 2 nëse nuk ka asgjë ku ta dorëzojë |
never |
Nuk e dorëzon |
Kështu, një ekzekutim përpara instalimit të parë nuk ka ku ta dorëzojë dhe e mban raportin në stacionin tuaj të punës. Një ekzekutim pas instalimit dhe përpara marrjes në pronësi e regjistron atë.
Dorëzimi përdor vetë qasjen tuaj në klaster. nexusctl ekzekuton /app/nexus-keys preflight-record në kontejnerin keys të një pod-i gati nexus-keys dhe e kalon raportin në hyrjen standarde (standard input). Është njëlloj si:
kubectl exec -i -n nexus -c keys deploy/nexus-keys -- /app/nexus-keys preflight-record < preflight-2026-11-12-0902.jsonShërbimi i çelësave e kontrollon raportin kundrejt të njëjtave rregulla që zbaton nexusctl dhe mban vetëm më të fundit. Kur dorëzohet, nexusctl printon edhe një rresht tjetër duke e thënë këtë, dhe JSON-i i ruajtur fiton një note që regjistron dorëzimin.
Instaluesi i konsolës e lexon atë nga rruga publike e shërbimit të çelësave GET /v1/installation/preflight. Ajo rrugë përgjigjet vetëm ndërsa instalimi është i pamarrë në pronësi: përpara se të regjistrohet ndonjë raport, ajo përgjigjet 404 RECORD_NOT_FOUND, dhe sapo dikush e merr në pronësi instalimin, ajo përgjigjet ROUTE_NOT_FOUND përgjithmonë, saktësisht siç bën rruga e marrjes në pronësi. Një raport i dorëzuar pas marrjes në pronësi refuzohet me INSTALLATION_CLAIMED.
Në konsolë, një ekzekutim me dështime shfaqet si "Kontrolli paraprak nuk mund të vazhdojë": numërimet e të dështuarave, paralajmërimeve dhe të kaluarave me sukses, pastaj çdo kontroll i grupuar nën "Duhet të kalojë" dhe "Është mirë të kalojë", me ato që nuk kaluan të parat dhe fjalët e gjetura pranë secilit. Një ekzekutim pa dështime nuk e nxjerr atë faqe; konsola kalon drejt e te marrja në pronësi (kapitulli 2.12, Ekzekutimi i parë).
Qasja që i nevojitet ekzekutimit
Kontrolli paraprak ekzekutohet si ju, me skedarin tuaj kubeconfig. Llogaria ka nevojë të lexojë:
- nyjet, për kontrollet e versionit, gatishmërisë, burimeve dhe grafikës;
- klasat e ruajtjes (storage classes) dhe klasat ingress;
- shërbimet (Services) në hapësirën e emrave ingress;
- Secret-in TLS në hapësirën e emrave të instalimit, kur ekzekutohet kontrolli i certifikatës.
Kur një lexim refuzohet, rreshti thotë could not read <what> (the cluster refused), dhe rregullimi thotë cilën qasje leximi duhet të jepni. Fjalët nuk përfshijnë kurrë adresën e serverit ose tekstin e vetë gabimit të tij, sepse raporti mund të shfaqet përpara identifikimit. Dorëzimi ka nevojë gjithashtu për pods/exec në pod-et nexus-keys; pa të, auto ruan skedarët dhe printon një paralajmërim, dhe always del me 2.
Kur vetë kontrolli paraprak nuk mund të ekzekutohet
Kodi i daljes 2 do të thotë që nuk u bë asnjë raport. Mesazhi në gabimin standard (standard error) thotë pse:
| Mesazhi | Çfarë duhet të bëni |
|---|---|
--context is required: the kube context to check |
Shtoni --context |
--values is required: the values file the install will use |
Shtoni --values |
could not read the values file harrow-values.yaml |
Kontrolloni shtegun dhe lejet e skedarit |
preflight takes flags only |
Hiqni argumentin e tepërt |
the report breaks its contract and was not printed, saved or handed over |
Një fushë do të kishte mbartur diçka private; raportojani Adverant-it bashkë me flamujt e ekzekutimit |
--record always: there is no nexus-keys Deployment in the namespace nexus to hand the report to |
Instaloni fillimisht, ose përdorni --record auto |
could not hand the report to this installation |
Kontrolloni qasjen tuaj për të kryer exec në nexus-keys |
Një klaster, API i të cilit nuk mund të arrihet, del gjithashtu me 2. Rregulloni skedarin kubeconfig ose rrjetin, dhe ekzekutojeni përsëri.
Sapo kontrolli paraprak të përfundojë me 0 failed, vazhdoni te kapitulli 2.6, Instalimi i Community në Kubernetes, për të instaluar Community, ose kapitulli 2.7, Instalimi i Enterprise dhe aplikimi i një licence, për Enterprise.

