ΣύνδεσηΚλείστε μια ενημέρωση

Κεφάλαιο 2.5

Προέλεγχος (preflight) με το nexusctl

Κάθε έλεγχος που εκτελεί η εντολή `nexusctl preflight`, τι διαβάζει ο καθένας και πώς αποτυγχάνει, η αναφορά που εκτυπώνει και αποθηκεύει, πώς αυτή η αναφορά φτάνει στη σελίδα προελέγχου της κονσόλας, καθώς και κάθε παράμετρος (flag).

Αυτή η σελίδα μεταφράστηκε με AI από το αγγλικό πρωτότυπο. Εάν οτιδήποτε είναι ασαφές, η αγγλική σελίδα αποτελεί το σημείο αναφοράς. Διαβάστε αυτή τη σελίδα στα αγγλικά

16 λεπτά ανάγνωσης

Ο πρώτος μας έλεγχος 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 χρησιμοποιούσε ένα φιλοξενούμενο μοντέλο με το δικό της κλειδί του λιμανιού.

Πριν την εγκατάσταση
Πριν την εγκατάσταση
Το preflight στο τερματικό του χειριστή, με τις μετρήσεις δίπλα του. Παρατηρήστε ότι κάτω από κάθε προειδοποίηση εμφανίζεται η λύση της, και ότι η εκτέλεση αναφέρει ξεκάθαρα πως δεν άλλαξε τίποτα στο cluster.

Κωδικοί εξόδου

Κωδικός Σημασία
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 δεν μπορεί να συνεχίσει
Το preflight δεν μπορεί να συνεχίσει
Η σελίδα της κονσόλας για μια εκτέλεση preflight που δεν μπορεί να συνεχίσει. Οι αποτυχημένοι έλεγχοι εμφανίζονται πρώτοι, καθένας ονομασμένος ολογράφως μαζί με ό,τι βρέθηκε, και η εγκατάσταση παραμένει μπλοκαρισμένη μέχρι να περάσουν επιτυχώς.
Τρεις στήλες. Αριστερά, «Σταθμός εργασίας χειριστή»: ένα πλαίσιο «nexusctl preflight --context --values» με δύο εξόδους από κάτω του, «preflight-<time>.txt» και «preflight-<time>.json». Μέση, «Η εγκατάσταση, μη διεκδικημένη»: ένα πλαίσιο «nexus-keys» με την ετικέτα «preflight-record, μόνο η τελευταία αναφορά». Ένα βέλος από το αριστερό πλαίσιο προς το nexus-keys έχει την ετικέτα «εκτέλεση pod (pod exec) με τη δική σας πρόσβαση στο cluster (--record auto ή always)». Δεξιά, «Πρόγραμμα περιήγησης, πριν από τη σύνδεση»: ένα πλαίσιο «Πρόγραμμα εγκατάστασης κονσόλας, Το preflight δεν μπορεί να συνεχίσει». Ένα βέλος από το nexus-keys προς αυτό έχει την ετικέτα «GET /v1/installation/preflight». Κάτω από το μεσαίο πλαίσιο, μια μικρή σημείωση γράφει «μετά τη διεκδίκηση: ROUTE_NOT_FOUND».
Πού πηγαίνει μια αναφορά preflight, από τον σταθμό εργασίας του χειριστή έως το πρόγραμμα περιήγησης.

Πρόσβαση που απαιτεί η εκτέλεση

Το 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.