Έκδοση 1.0.0-alpha.1τελευταία
Κεφάλαιο 2.5
Προέλεγχος (preflight) με το nexusctl
Κάθε έλεγχος που εκτελεί η εντολή `nexusctl preflight`, τι διαβάζει ο καθένας και πώς αποτυγχάνει, η αναφορά που εκτυπώνει και αποθηκεύει, πώς αυτή η αναφορά φτάνει στη σελίδα προελέγχου της κονσόλας, καθώς και κάθε παράμετρος (flag).
Αυτή η σελίδα μεταφράστηκε με AI από το αγγλικό πρωτότυπο. Εάν οτιδήποτε είναι ασαφές, η αγγλική σελίδα αποτελεί το σημείο αναφοράς. Διαβάστε αυτή τη σελίδα στα αγγλικά

Ο πρώτος μας έλεγχος preflight στη Harrow Port Authority απέτυχε σε τέσσερις ελέγχους, και δύο από αυτούς θα μας είχαν κοστίσει πολύ περισσότερο από ένα απόγευμα. Είχαμε ξεκινήσει το αρχείο τιμών (values file) αντιγράφοντας το παράδειγμα του chart, και το preflight απέρριψε τόσο το ενδεικτικό όνομα εγκατάστασης όσο και τον ενδεικτικό θεματοφύλακα (custodian). Κανείς δεν κατέχει το ιδιωτικό κλειδί αυτού του θεματοφύλακα. Μια εγκατάσταση που έχει σφραγιστεί με αυτό δεν μπορεί ποτέ να αποσφραγιστεί μετά από επανεκκίνηση ενός κόμβου (node). Το preflight το εντόπισε αυτό μέσα σε λίγα δευτερόλεπτα, προτού υπάρξει οτιδήποτε που θα μπορούσε να χαθεί.
Το nexusctl preflight διαβάζει το cluster σας και το αρχείο τιμών σας, εμφανίζει ό,τι βρήκε, αποθηκεύει μια αναφορά και δεν αλλάζει τίποτα στο cluster. Εκτελέστε το πριν από κάθε εγκατάσταση και κάθε αναβάθμιση. Αυτό το κεφάλαιο καλύπτει κάθε έλεγχο που πραγματοποιεί, τη μορφή της αναφοράς, πού αποθηκεύεται η αναφορά και τις παραμέτρους (flags).
Λειτουργία
Το preflight χρειάζεται δύο πράγματα: το kube context του cluster στο οποίο θα κάνετε την εγκατάσταση και το αρχείο τιμών που θα χρησιμοποιήσει η εγκατάσταση. Γράψτε πρώτα το αρχείο τιμών· το κεφάλαιο 2.6, Εγκατάσταση του Community στο Kubernetes, αναλύει κάθε κλειδί. Στη συνέχεια:
nexusctl preflight --context harrow-prod --values harrow-values.yamlΔιαβάζει το cluster μέσω του client-go μόνο με κλήσεις get και list. Εάν το tls.mode σας είναι existing, δημιουργήστε το namespace nexus και το Secret για το Transport Layer Security (TLS) προτού το εκτελέσετε (κεφάλαιο 2.6, Εγκατάσταση του Community στο Kubernetes, βήμα 3), διαφορετικά ο έλεγχος πιστοποιητικού θα αναφέρει ότι το Secret λείπει.
| Παράμετρος | Τι κάνει | Προεπιλογή |
|---|---|---|
--context <name> |
Το kube context προς έλεγχο. Υποχρεωτικό | καμία |
--values <file> |
Το αρχείο τιμών που θα χρησιμοποιήσει η εγκατάσταση. Υποχρεωτικό | καμία |
--namespace <name> |
Πού εγκαθίσταται το Nexus | nexus |
--release <version> |
Η έκδοση (release) που ελέγχεται | η έκδοση του ίδιου του ενσωματωμένου chart |
--report-dir <dir> |
Πού αποθηκεύονται τα δύο αρχεία αναφοράς | ο τρέχων φάκελος |
--record <mode> |
auto, always ή never: εάν θα παραδοθεί η αναφορά στην υπηρεσία κλειδιών αυτής της εγκατάστασης, ώστε να εμφανίζεται στη σελίδα του προγράμματος εγκατάστασης |
auto |
--kubeconfig <file> |
Το kubeconfig προς ανάγνωση | KUBECONFIG, έπειτα ~/.kube/config |
--ca-bundle <file> |
Τα δικά σας πιστοποιητικά αρχής έκδοσης πιστοποιητικών (CA), για μια αλυσίδα την οποία πρέπει να εμπιστεύονται οι έλεγχοι | καμία |
--single-node |
Έλεγχος ενός μηχανήματος για εγκατάσταση σε ένα μόνο μηχάνημα (κεφάλαιο 2.8, Εγκαταστάσεις σε ένα μηχάνημα) | ανενεργό |
Η ελάχιστη απαιτούμενη έκδοση του Kubernetes για το release δεν είναι πληκτρολογημένη μέσα στο nexusctl. Διαβάζει το κατώτερο όριο του kubeVersion του ίδιου του chart από το chart που φέρει, επομένως ο έλεγχος και το helm install δεν μπορούν ποτέ να διαφωνήσουν.
Τι εκτυπώνει μια εκτέλεση
Ορίστε η πρώτη εκτέλεση στη Harrow, όπως εμφανίστηκε:
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
Όταν κάτι αποτυγχάνει, εμφανίζονται πρώτα οι αποτυχίες, έπειτα οι προειδοποιήσεις και μετά οι επιτυχίες. Κάθε γραμμή δείχνει το αποτέλεσμα, το όνομα του ελέγχου, τι βρέθηκε και τι χρειάζεται· κάθε γραμμή που δεν πέρασε επιτυχώς έχει μια γραμμή fix από κάτω της. Οι δύο τελευταίες γραμμές είναι η σύνοψη και το αρχείο αναφοράς.
Διορθώσαμε τις τιμές, προσθέσαμε τις δύο εγγραφές Domain Name System (DNS), δημιουργήσαμε το Secret και το εκτελέσαμε ξανά:
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
Μια εκτέλεση χωρίς αποτυχίες παραθέτει τους ελέγχους κάτω από τις τρεις επικεφαλίδες τους: Cluster, Network και Time and keys. Οι προειδοποιήσεις δεν μπλοκάρουν ποτέ τη διαδικασία. Κρατήσαμε την προειδοποίηση κάρτας γραφικών επίτηδες: σε αυτό το συνδεδεμένο πιλοτικό cluster, ο βοηθός της Harrow χρησιμοποιούσε ένα φιλοξενούμενο μοντέλο με το δικό της κλειδί του λιμανιού.
Κωδικοί εξόδου
| Κωδικός | Σημασία |
|---|---|
0 |
Η εγκατάσταση μπορεί να προχωρήσει. Οι προειδοποιήσεις δεν μπλοκάρουν |
1 |
Η εγκατάσταση μπλοκαρίστηκε: τουλάχιστον ένας έλεγχος απέτυχε |
2 |
Το preflight δεν μπόρεσε να εκτελεστεί: δεν ήταν δυνατή η ανάγνωση του kubeconfig, του context, του αρχείου τιμών ή της διεπαφής προγραμματισμού εφαρμογών (API) του cluster, ή κάποια παράμετρος ήταν λανθασμένη |
Τα σενάρια (scripts) θα πρέπει να διαβάζουν τον κωδικό εξόδου (exit code), όχι τις λέξεις. Το δικό μας εκτελεί το preflight ως το πρώτο βήμα κάθε αναβάθμισης και σταματά σε οτιδήποτε άλλο εκτός από 0.
Εκτελέστε το nexusctl της έκδοσης στην οποία μεταβαίνετε, όχι αυτής με την οποία κάνατε την εγκατάσταση. Οι απαιτήσεις προέρχονται από το chart που φέρει, οπότε μια νεότερη έκδοση μπορεί να αυξήσει την ελάχιστη έκδοση του Kubernetes ή να ζητήσει περισσότερη μνήμη, και μόνο το δικό της nexusctl το γνωρίζει αυτό. Το --release αλλάζει την έκδοση που κατονομάζει η αναφορά· δεν αλλάζει το ποιανού chart οι κανόνες εφαρμόζονται. Στη Harrow διατηρούμε το nexusctl κάθε έκδοσης δίπλα στο chart της στο αρχείο αλλαγών, ώστε μια επαναφορά (rollback) να ελέγχεται από το εργαλείο που της αντιστοιχεί.
Κάθε έλεγχος
Υπάρχουν έντεκα έλεγχοι. Δέκα από αυτούς παράγουν από μία γραμμή ο καθένας· ο έλεγχος διεύθυνσης παράγει μία γραμμή ανά κεντρικό υπολογιστή (host), οπότε μια πλήρης εκτέλεση έχει δεκατρείς γραμμές. Εννέα έλεγχοι πρέπει να περάσουν επιτυχώς, και τυχόν αστοχία αποτελεί αποτυχία. Δύο, οι κόμβοι γραφικών και το πιστοποιητικό, καλό είναι να περάσουν, και τυχόν αστοχία αποτελεί προειδοποίηση. Η τελευταία στήλη είναι το κείμενο απαίτησης που μεταφέρει κάθε γραμμή στην αναφορά· το CPU σε αυτήν είναι η κεντρική μονάδα επεξεργασίας.
| Αναγνωριστικό ελέγχου | Ενότητα | Πρέπει να περάσει | Απαίτηση που εμφανίζει |
|---|---|---|---|
kubernetes-version |
cluster | ναι | Kubernetes 1.33 ή νεότερο |
nodes-ready |
cluster | ναι | Κάθε κόμβος έτοιμος |
storage-class |
cluster | ναι | Μια κλάση αποθήκευσης (storage class) για τα δεδομένα |
resources |
cluster | ναι | Αρκετή CPU και μνήμη για την έκδοση |
graphics-nodes |
cluster | όχι | Κόμβοι γραφικών |
ingress-class |
network | ναι | Μια κλάση ingress (ingress class) για τις τρεις διευθύνσεις |
ingress-ports |
network | ναι | Ο ελεγκτής ingress (ingress controller) ανοιχτός στις θύρες 80 και 443 |
address-console, address-api, address-auth |
network | ναι | Η διεύθυνση console, api ή auth επιλύεται στο DNS |
certificate |
network | όχι | Πιστοποιητικό έγκυρο για 30 ακόμη ημέρες |
custodians |
time-and-keys | ναι | Τα άτομα που κατέχουν τα κλειδιά ανάκτησης αυτής της εγκατάστασης |
installation-name |
time-and-keys | ναι | Το μόνιμο όνομα αυτής της εγκατάστασης |
kubernetes-version
Διαβάζει την έκδοση του διακομιστή API και τη συγκρίνει με το κατώτατο όριο του chart. Βρίσκει, για παράδειγμα, 1.33.6+k3s1. Κάτω από 1.33 αποτυγχάνει με τη λύση upgrade the cluster to 1.33 or later. Εάν η συμβολοσειρά έκδοσης δεν είναι κάποια που μπορεί να διαβάσει το nexusctl, αποτυγχάνει αντί να μαντέψει.
nodes-ready
Καταγράφει τους κόμβους και μετρά εκείνους των οποίων η συνθήκη Ready είναι αληθής, ως 3 of 3. Κάθε κόμβος που δεν είναι έτοιμος κατονομάζεται, και η λύση σάς λέει να τον επαναφέρετε σε κατάσταση Ready και να διαβάσετε τις συνθήκες του. Ένα cluster χωρίς καθόλου κόμβους αποτυγχάνει με μια υπόδειξη ότι το context μπορεί να δείχνει σε λάθος cluster.
storage-class
Εάν οι τιμές σας ορίζουν το storage.className, ο έλεγχος αναζητά αυτήν την κλάση και αποτυγχάνει με <name> does not exist όταν λείπει. Εάν δεν το ορίζουν, αναζητά μια κλάση σημασμένη ως προεπιλεγμένη (default) και την αναφέρει ως local-path (default). Χωρίς προεπιλογή αποτυγχάνει με none marked default, και η στήλη απαιτήσεων εξηγεί γιατί αυτό έχει σημασία: the database cannot claim a disk. Εάν δύο κλάσεις είναι σημασμένες ως προεπιλεγμένες, το cluster δίνει σε ένα νέο αίτημα (claim) τη νεότερη, οπότε αυτή είναι που αναφέρεται.
resources
Υπολογίζει τι ζητά η έκδοση από το chart και τις τιμές σας, και στη συνέχεια αθροίζει τους διαθέσιμους προς εκχώρηση πυρήνες κεντρικής μονάδας επεξεργασίας (CPU) και τη μνήμη κάθε κόμβου που είναι Ready, δεν είναι απομονωμένος (cordoned) και δεν φέρει taint NoSchedule ή NoExecute. Τα pods του chart δεν φέρουν ανοχές (tolerations), επομένως ένας κόμβος με taint δεν μπορεί να τα εκτελέσει και δεν προσμετράται. Ένα cluster με ελλείψεις αποτυγχάνει αναφέροντας το ακριβές έλλειμμα, όπως add nodes with 1 more core and 2.5 GiB more memory, or lower the sizes under components and dataTier in harrow-values.yaml. Οι ανάγκες στρογγυλοποιούνται προς τα πάνω και η διαθεσιμότητα προς τα κάτω, ώστε ο έλεγχος να μην σας κολακεύει ποτέ.
graphics-nodes
Αναζητά έναν κόμβο σε κατάσταση Ready με μονάδα επεξεργασίας γραφικών (GPU) την οποία μπορεί να εκχωρήσει, nvidia.com/gpu. Εάν δεν υπάρχει κανένας, προειδοποιεί: the assistant will need a hosted model. Το preflight το αντιμετωπίζει ως συμβουλή και δεν μπλοκάρει ποτέ εξαιτίας του, επειδή ο βοηθός μπορεί αντ' αυτού να απαντήσει μέσω ενός φιλοξενούμενου μοντέλου τεχνητής νοημοσύνης (AI). Το Κεφάλαιο 2.14, Πάροχοι και μοντέλα AI, καλύπτει και τις δύο οδούς.
ingress-class
Εάν έχει οριστεί το ingress.className, ο έλεγχος αναζητά αυτήν την κλάση. Εάν όχι, αναζητά ακριβώς μία κλάση σημασμένη ως προεπιλεγμένη. Δύο κλάσεις σημασμένες ως προεπιλεγμένες προκαλούν επίσης αποτυχία, επειδή ο διακομιστής API αρνείται τότε ένα Ingress χωρίς κλάση. Ο έλεγχος παραλείπεται, και η γραμμή του μένει εκτός, όταν το ingress.enabled είναι false.
ingress-ports
Αναζητά στο namespace που κατονομάζεται από το networkPolicy.ingressNamespace (από προεπιλογή kube-system, όπου το k3s εκτελεί το Traefik) ένα LoadBalancer ή NodePort Service που εκθέτει τόσο την 80 όσο και την 443. Η πολιτική δικτύου του chart επιτρέπει μόνο σε αυτό το namespace να προσεγγίσει τα τρία δημόσια Services, επομένως ένας ελεγκτής ingress οπουδήποτε αλλού δεν θα μπορούσε να εξυπηρετήσει το Nexus ακόμη και αν άκουγε. Η λύση κατονομάζει και τις δύο διεξόδους: εκθέστε τον ελεγκτή εκεί, ή ορίστε το networkPolicy.ingressNamespace στο σημείο όπου εκτελείται. Παραλείπεται όταν το ingress.enabled είναι false.
address
Αναζητά τα hosts.console, hosts.api και hosts.auth από τον σταθμό εργασίας σας, πέντε δευτερόλεπτα το καθένα, και εμφανίζει μία γραμμή ανά κεντρικό υπολογιστή (host). Ένας κεντρικός υπολογιστής χωρίς εγγραφή αποτυγχάνει με <host> → no record. Ένας μη ορισμένος κεντρικός υπολογιστής αποτυγχάνει με hosts.<key> is not set. Όταν ένα όνομα έχει πολλές διευθύνσεις, η γραμμή δείχνει την πρώτη, IPv4 πριν από IPv6, και πόσες ακόμη υπάρχουν.
certificate
Εκτελείται μόνο όταν το tls.mode είναι existing και το tls.existingSecret κατονομάζει ένα Secret· με cert-manager ή none δεν υπάρχει δικό σας πιστοποιητικό για ανάγνωση, και η γραμμή παραλείπεται. Διαβάζει το tls.crt από το Secret στο namespace εγκατάστασης και τίποτα άλλο. Ένα πιστοποιητικό που ισχύει για 30 ημέρες ή περισσότερο περνά ως ends 3 Nov 2027. Ένα που λήγει νωρίτερα προειδοποιεί με ends in 9 days· ένα που έχει ήδη λήξει προειδοποιεί με ended 4 days ago. Ένα Secret που λείπει, ή ένα χωρίς πιστοποιητικό μέσα του, προειδοποιεί δίνοντας τη λύση.
custodians
Διαβάζει το keys.custody.recipients. Αν δεν υπάρχει κανένας, αποτυγχάνει με τον κωδικό KEYS_CUSTODIAN_MISSING. Εάν οποιοσδήποτε παραλήπτης είναι ο ενδεικτικός θεματοφύλακας (custodian) από τα αρχεία τιμών του ίδιου του chart, αποτυγχάνει με KEYS_CUSTODIAN_EXAMPLE, επειδή κανείς δεν κατέχει αυτό το κλειδί και τα κλειδιά ανάκτησης της εγκατάστασης θα σφραγίζονταν για κανέναν παραλήπτη. Η επιτυχία εμφανίζει το πλήθος, όπως 3 custodians.
installation-name
Διαβάζει το keys.installationName. Αν δεν έχει οριστεί, αποτυγχάνει με INSTALLATION_NAME_MISSING. Αν έχει οριστεί στο ενδεικτικό όνομα από τα αρχεία τιμών του chart, αποτυγχάνει με INSTALLATION_NAME_EXAMPLE. Η επιτυχία εμφανίζει το όνομα. Η στήλη απαιτήσεων αναφέρει γιατί αυτό έχει μεγαλύτερη σημασία από τα περισσότερα: the first key-store bootstrap mints the installation identity under it, permanently.
Οι δύο τελευταίοι έλεγχοι αναφέρουν ακριβώς τους κωδικούς με τους οποίους το ίδιο το chart αρνείται μια εγκατάσταση. Το preflight απλώς σας το λέει πρώτο, προτού το Helm δημιουργήσει οτιδήποτε.
Τα αρχεία αναφοράς
Κάθε εκτέλεση αποθηκεύει δύο αρχεία στο --report-dir, ονομασμένα με βάση την ώρα εκτέλεσης: το preflight-2026-11-12-0902.txt, τις γραμμές όπως εμφανίστηκαν χωρίς κωδικούς χρώματος, και το preflight-2026-11-12-0902.json, την ίδια εκτέλεση σε σταθερή μορφή που μπορεί να διαβάσει ένα πρόγραμμα. Η έξοδος του τερματικού και οι αποθηκευμένες γραμμές προέρχονται από την ίδια λίστα, επομένως δεν διαφέρουν ποτέ.
Η αναφορά JSON ακολουθεί το σχήμα (schema) nexus.preflight/v1:
| Πεδίο | Τι περιέχει |
|---|---|
schema |
Ακριβώς nexus.preflight/v1 |
tool |
Ένα αντικείμενο: name (nexusctl) και version |
release |
Η έκδοση που ελέγχθηκε |
ran_at |
Πότε εκτελέστηκε, σε Συντονισμένη Παγκόσμια Ώρα (UTC) |
context |
Το όνομα του kube context |
values |
Μόνο το βασικό όνομα του αρχείου τιμών |
read_only |
Πάντα true |
checks |
Μία καταχώριση ανά γραμμή: id, section, name, requirement, must_pass, outcome (pass, warn ή fail), found, needs, fix, και σε περίπτωση αστοχίας με αιτία μηχανήματος, code |
counts |
passed, warnings και failed |
can_install |
true όταν δεν απέτυχε τίποτα |
report_file |
Το όνομα του αρχείου .txt |
transcript |
Ένα αντικείμενο: title (nexusctl preflight) και lines, κάθε γραμμή με το kind της (prompt, ok, warn, bad, note, out ή blank), τα text και at της, και μερικές φορές marks |
Η αναφορά έχει κατασκευαστεί ώστε να εμφανίζεται προτού συνδεθεί οποιοσδήποτε, επομένως δεν φέρει όνομα χρήστη, όνομα κεντρικού υπολογιστή σταθμού εργασίας, διαδρομή αρχείου, token και τίποτα από το kubeconfig σας. Το values είναι ένα βασικό όνομα και το context είναι το όνομα του context. Εάν η αναφορά μιας εκτέλεσης παραβίαζε οποιονδήποτε από αυτούς τους κανόνες, το nexusctl αρνείται να την εμφανίσει, να την αποθηκεύσει ή να την παραδώσει, και το δηλώνει. Μια αναφορά είναι το πολύ 256 KiB, με το πολύ 64 ελέγχους και 512 χαρακτήρες σε οποιοδήποτε μεμονωμένο πεδίο κειμένου.
Πώς φτάνει η αναφορά στην κονσόλα
Η μοναδική εγγραφή που κάνει το preflight είναι η ολοκληρωμένη αναφορά, η οποία παραδίδεται στην υπηρεσία κλειδιών της εγκατάστασης, nexus-keys, έτσι ώστε το πρόγραμμα εγκατάστασης της κονσόλας να μπορεί να την εμφανίσει στη σελίδα preflight προτού οποιοσδήποτε διεκδικήσει (claim) την εγκατάσταση. Το --record αποφασίζει αν θα δοκιμάσει:
--record |
Τι συμβαίνει |
|---|---|
auto |
Παραδίδει την αναφορά μόνο όταν το namespace έχει ένα Deployment nexus-keys |
always |
Επιμένει· το preflight τερματίζει με 2 εάν δεν υπάρχει τίποτα στο οποίο να την παραδώσει |
never |
Δεν την παραδίδει |
Επομένως, μια εκτέλεση πριν από την πρώτη εγκατάσταση δεν έχει πού να παραδώσει, και κρατά την αναφορά στον σταθμό εργασίας σας. Μια εκτέλεση μετά την εγκατάσταση και πριν από τη διεκδίκηση την καταγράφει.
Η παράδοση χρησιμοποιεί τη δική σας πρόσβαση στο cluster. Το nexusctl εκτελεί το /app/nexus-keys preflight-record στο container keys ενός έτοιμου pod nexus-keys και περνά την αναφορά στην τυπική είσοδο (standard input). Είναι το ίδιο με το:
kubectl exec -i -n nexus -c keys deploy/nexus-keys -- /app/nexus-keys preflight-record < preflight-2026-11-12-0902.jsonΗ υπηρεσία κλειδιών ελέγχει την αναφορά με βάση τους ίδιους κανόνες που εφαρμόζει το nexusctl και κρατά μόνο την πιο πρόσφατη. Όταν παραδίδεται, το nexusctl εμφανίζει μία ακόμη γραμμή που το αναφέρει, και το αποθηκευμένο JSON αποκτά ένα note που καταγράφει την παράδοση.
Το πρόγραμμα εγκατάστασης της κονσόλας τη διαβάζει από τη δημόσια διαδρομή της υπηρεσίας κλειδιών GET /v1/installation/preflight. Αυτή η διαδρομή απαντά μόνο ενόσω η εγκατάσταση δεν έχει διεκδικηθεί: προτού καταγραφεί οποιαδήποτε αναφορά απαντά 404 RECORD_NOT_FOUND, και μόλις κάποιος διεκδικήσει την εγκατάσταση απαντά ROUTE_NOT_FOUND οριστικά, ακριβώς όπως κάνει και η διαδρομή διεκδίκησης. Μια αναφορά που παραδίδεται μετά τη διεκδίκηση απορρίπτεται με INSTALLATION_CLAIMED.
Στην κονσόλα, μια εκτέλεση με αποτυχίες εμφανίζεται ως «Το preflight δεν μπορεί να συνεχίσει»: οι μετρήσεις των αποτυχιών, των προειδοποιήσεων και των επιτυχιών, και έπειτα κάθε έλεγχος ομαδοποιημένος κάτω από τα «Πρέπει να περάσει» και «Καλό είναι να περάσει», με αυτούς που δεν πέρασαν πρώτους και τις λέξεις του τι βρέθηκε δίπλα στον καθένα. Μια εκτέλεση χωρίς αποτυχίες δεν εμφανίζει αυτή τη σελίδα· η κονσόλα προχωρά κατευθείαν στη διεκδίκηση (κεφάλαιο 2.12, Η πρώτη εκτέλεση).
Πρόσβαση που απαιτεί η εκτέλεση
Το preflight εκτελείται ως εσείς, με το kubeconfig σας. Ο λογαριασμός χρειάζεται δικαιώματα ανάγνωσης για:
- τους κόμβους (nodes), για τους ελέγχους έκδοσης, ετοιμότητας, πόρων και γραφικών·
- τις κλάσεις αποθήκευσης (storage classes) και τις κλάσεις ingress (ingress classes)·
- τα Services στο namespace του ingress·
- το TLS Secret στο namespace εγκατάστασης, όταν εκτελείται ο έλεγχος πιστοποιητικού.
Όταν απορρίπτεται μια ανάγνωση, η γραμμή αναφέρει could not read <what> (the cluster refused), και η λύση αναφέρει ποια πρόσβαση ανάγνωσης πρέπει να εκχωρηθεί. Οι λέξεις δεν περιλαμβάνουν ποτέ τη διεύθυνση του διακομιστή ή το δικό του κείμενο σφάλματος, επειδή η αναφορά μπορεί να εμφανιστεί πριν από τη σύνδεση. Η παράδοση χρειάζεται επίσης pods/exec στα pods nexus-keys· χωρίς αυτό, το auto αποθηκεύει τα αρχεία και εμφανίζει μια προειδοποίηση, ενώ το always τερματίζει με 2.
Όταν ο ίδιος ο προέλεγχος δεν μπορεί να εκτελεστεί
Ο κωδικός εξόδου 2 σημαίνει ότι δεν δημιουργήθηκε αναφορά. Το μήνυμα στην τυπική έξοδο σφάλματος (standard error) αναφέρει τον λόγο:
| Μήνυμα | Τι πρέπει να κάνετε |
|---|---|
--context is required: the kube context to check |
Προσθέστε --context |
--values is required: the values file the install will use |
Προσθέστε --values |
could not read the values file harrow-values.yaml |
Ελέγξτε τη διαδρομή και τα δικαιώματα του αρχείου |
preflight takes flags only |
Αφαιρέστε το περιττό όρισμα |
the report breaks its contract and was not printed, saved or handed over |
Ένα πεδίο θα μετέφερε κάτι ιδιωτικό· αναφέρετέ το στην Adverant μαζί με τις παραμέτρους της εκτέλεσης |
--record always: there is no nexus-keys Deployment in the namespace nexus to hand the report to |
Κάντε πρώτα εγκατάσταση, ή χρησιμοποιήστε --record auto |
could not hand the report to this installation |
Ελέγξτε την πρόσβασή σας για εκτέλεση (exec) μέσα στο nexus-keys |
Ένα cluster του οποίου το API δεν είναι προσβάσιμο τερματίζει επίσης με 2. Διορθώστε το kubeconfig ή το δίκτυο, και εκτελέστε το ξανά.
Μόλις το preflight ολοκληρωθεί με 0 failed, προχωρήστε στο κεφάλαιο 2.6, Εγκατάσταση του Community στο Kubernetes, για να εγκαταστήσετε το Community, ή στο κεφάλαιο 2.7, Εγκατάσταση του Enterprise και εφαρμογή άδειας χρήσης, για το Enterprise.

