AnmeldenBriefing buchen

Kapitel 2.5

Vorabprüfung mit nexusctl

Jede Prüfung, die `nexusctl preflight` durchführt, was dabei jeweils ausgelesen wird und wann sie fehlschlägt, der Bericht, der ausgegeben und gespeichert wird, wie dieser Bericht auf die Preflight-Seite der Konsole gelangt, sowie alle Flags.

Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

16 Minuten Lesezeit

Unsere erste Vorabprüfung (Preflight) bei der Harrow Port Authority fiel bei vier Prüfungen durch, und zwei davon hätten uns weit mehr als nur einen Nachmittag gekostet. Wir hatten die Werte-Datei erstellt, indem wir das Beispiel des Charts kopierten, und die Vorabprüfung lehnte sowohl den Beispiel-Installationsnamen als auch den Beispiel-Treuhänder (Custodian) ab. Niemand besitzt den privaten Schlüssel dieses Treuhänders. Eine damit versiegelte Installation kann nach einem Node-Neustart niemals entsiegelt werden. Die Vorabprüfung hat das in wenigen Sekunden abgefangen, noch bevor irgendetwas existierte, das hätte verloren gehen können.

nexusctl preflight liest Ihren Cluster und Ihre Werte-Datei, gibt die Ergebnisse aus, speichert einen Bericht und verändert nichts am Cluster. Führen Sie es vor jeder Installation und jedem Upgrade aus. Dieses Kapitel behandelt jede einzelne Prüfung, das Berichtsformat, den Speicherort des Berichts und die Flags.

Betrieb

Die Vorabprüfung benötigt zwei Dinge: den Kube-Kontext des Clusters, auf dem Sie installieren werden, und die Werte-Datei, die bei der Installation verwendet wird. Schreiben Sie zuerst die Werte-Datei; Kapitel 2.6, Installation von Community auf Kubernetes, geht jeden Schlüssel einzeln durch. Danach:

nexusctl preflight --context harrow-prod --values harrow-values.yaml

Es liest den Cluster über client-go ausschließlich mit get- und list-Aufrufen aus. Wenn Ihr tls.mode auf existing gesetzt ist, erstellen Sie den Namespace nexus und das Transport Layer Security (TLS)-Secret, bevor Sie es ausführen (Kapitel 2.6, Installation von Community auf Kubernetes, Schritt 3), andernfalls meldet die Zertifikatsprüfung das Secret als fehlend.

Flag Aufgabe Standardwert
--context <name> Der zu prüfende Kube-Kontext. Erforderlich keiner
--values <file> Die Werte-Datei, die bei der Installation verwendet wird. Erforderlich keiner
--namespace <name> Wo Nexus installiert wird nexus
--release <version> Das geprüfte Release die eigene Version des mitgelieferten Charts
--report-dir <dir> Wo die beiden Berichtsdateien gespeichert werden der aktuelle Ordner
--record <mode> auto, always oder never: ob der Bericht an den Schlüsseldienst dieser Installation übergeben werden soll, damit dessen Installationsseite ihn anzeigt auto
--kubeconfig <file> Die zu lesende kubeconfig KUBECONFIG, dann ~/.kube/config
--ca-bundle <file> Ihre eigenen Zertifizierungsstellen (CA)-Zertifikate für eine Kette, der die Prüfungen vertrauen sollen keiner
--single-node Prüft einen einzelnen Rechner für eine Einzelrechner-Installation (Kapitel 2.8, Einzelrechner-Installationen) aus

Die Mindestversion des Releases für Kubernetes ist nicht fest in nexusctl einprogrammiert. Es liest die Untergrenze von kubeVersion direkt aus dem mitgeführten Chart aus, sodass die Prüfung und helm install sich niemals widersprechen können.

Was ein Durchlauf ausgibt

Hier ist der erste Durchlauf bei Harrow, genau so, wie er ausgegeben wurde:

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

Wenn etwas fehlschlägt, stehen die Fehler zuerst, dann die Warnungen und schließlich die bestandenen Prüfungen. Jede Zeile zeigt das Ergebnis, den Namen der Prüfung, was gefunden wurde und was benötigt wird; unter jeder nicht bestandenen Zeile steht eine fix-Zeile. Die letzten beiden Zeilen sind die Zusammenfassung und die Berichtsdatei.

Wir haben die Werte korrigiert, die beiden Domain Name System (DNS)-Einträge hinzugefügt, das Secret erstellt und den Vorgang erneut ausgeführt:

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

Ein Durchlauf ohne Fehler listet die Prüfungen unter ihren drei Überschriften auf: Cluster, Netzwerk sowie Zeit und Schlüssel. Warnungen blockieren niemals. Wir haben die Grafikwarnung absichtlich belassen: Auf diesem verbundenen Pilot-Cluster nutzte der Assistent von Harrow ein gehostetes Modell mit dem eigenen Schlüssel des Hafens.

Vor der Installation
Vor der Installation
Die Vorabprüfung im Terminal des Operators, mit den Zählwerten daneben. Beachten Sie, dass unter jeder Warnung die entsprechende Korrektur ausgegeben wird und dass der Durchlauf klar angibt, dass am Cluster nichts verändert wurde.

Exit-Codes

Code Bedeutung
0 Die Installation kann fortgesetzt werden. Warnungen blockieren nicht
1 Die Installation ist blockiert: Mindestens eine Prüfung ist fehlgeschlagen
2 Die Vorabprüfung konnte nicht ausgeführt werden: Die kubeconfig, der Kontext, die Werte-Datei oder die Anwendungsprogrammierschnittstelle (API) des Clusters konnten nicht gelesen werden, oder ein Flag war falsch

Skripte sollten den Exit-Code auslesen, nicht den Text. Unseres führt die Vorabprüfung als ersten Schritt bei jedem Upgrade aus und bricht bei allem außer 0 ab.

Führen Sie das nexusctl des Releases aus, auf das Sie wechseln, nicht dasjenige, mit dem Sie installiert haben. Die Anforderungen stammen aus dem mitgeführten Chart; ein neueres Release kann also die Mindestversion für Kubernetes anheben oder mehr Arbeitsspeicher verlangen, und das weiß nur dessen eigenes nexusctl. --release ändert die Version, die im Bericht genannt wird; es ändert nicht, von welchem Chart die Regeln angewendet werden. Bei Harrow bewahren wir das nexusctl jedes Releases zusammen mit seinem Chart im Änderungsprotokoll auf, sodass ein Rollback mit dem dazu passenden Tool geprüft wird.

Jede einzelne Prüfung

Es gibt elf Prüfungen. Zehn davon erzeugen jeweils eine Zeile; die Adressprüfung erzeugt eine Zeile pro Host, sodass ein vollständiger Durchlauf dreizehn Zeilen umfasst. Neun Prüfungen müssen bestanden werden, ein Nichtbestehen gilt als Fehler. Zwei – die Grafik-Nodes und das Zertifikat – sollten bestanden werden, ein Nichtbestehen gilt als Warnung. Die letzte Spalte enthält den Anforderungstext, den jede Zeile in den Bericht übernimmt; CPU steht darin für den Hauptprozessor (Central Processing Unit).

Prüf-ID Abschnitt Muss bestehen Ausgegebene Anforderung
kubernetes-version cluster ja Kubernetes 1.33 oder höher
nodes-ready cluster ja Jeder Node bereit
storage-class cluster ja Eine Speicherklasse für die Daten
resources cluster ja Ausreichend CPU und Arbeitsspeicher für das Release
graphics-nodes cluster nein Grafikknoten
ingress-class network ja Eine Ingress-Klasse für die drei Adressen
ingress-ports network ja Der Ingress-Controller ist auf den Ports 80 und 443 geöffnet
address-console, address-api, address-auth network ja Die Adresse für console, api oder auth wird im DNS aufgelöst
certificate network nein Zertifikat noch 30 Tage gültig
custodians time-and-keys ja Die Personen, die die Wiederherstellungsschlüssel dieser Installation halten
installation-name time-and-keys ja Der eigene dauerhafte Name dieser Installation

kubernetes-version

Liest die Version des API-Servers aus und vergleicht sie mit der Mindestversion des Charts. Sie findet beispielsweise 1.33.6+k3s1. Unterhalb von 1.33 schlägt sie mit dem Korrekturhinweis upgrade the cluster to 1.33 or later fehl. Wenn die Versionszeichenfolge von nexusctl nicht gelesen werden kann, schlägt die Prüfung fehl, anstatt zu raten.

nodes-ready

Listet die Nodes auf und zählt diejenigen, deren Bedingung Ready wahr ist, als 3 of 3. Jeder Node, der nicht bereit ist, wird namentlich genannt, und der Korrekturhinweis weist Sie an, ihn wieder in den Zustand Ready zu bringen und seine Bedingungen zu prüfen. Ein Cluster ganz ohne Nodes schlägt mit dem Hinweis fehl, dass der Kontext möglicherweise auf den falschen Cluster verweist.

storage-class

Wenn in Ihren Werten storage.className festgelegt ist, sucht die Prüfung nach dieser Klasse und schlägt mit <name> does not exist fehl, wenn sie nicht vorhanden ist. Ist nichts festgelegt, sucht sie nach einer als Standard markierten Klasse und meldet diese als local-path (default). Ohne Standardklasse schlägt sie mit none marked default fehl, und die Anforderungsspalte erklärt, warum das wichtig ist: the database cannot claim a disk. Wenn zwei Klassen als Standard markiert sind, weist der Cluster einer neuen Anforderung (Claim) die neueste zu, weshalb diese gemeldet wird.

resources

Ermittelt anhand des Charts und Ihrer Werte, was das Release anfordert, und addiert dann die zuweisbaren Hauptprozessor (CPU)-Kerne und den Arbeitsspeicher jedes Nodes, der den Status Ready hat, nicht gesperrt (cordoned) ist und keinen NoSchedule- oder NoExecute-Taint aufweist. Die Pods des Charts haben keine Tolerations, sodass ein mit Taint versehener Node sie nicht ausführen kann und nicht mitgezählt wird. Ein zu kleiner Cluster schlägt mit dem genauen Fehlbetrag fehl, wie etwa add nodes with 1 more core and 2.5 GiB more memory, or lower the sizes under components and dataTier in harrow-values.yaml. Anforderungen werden aufgerundet und das Angebot abgerundet, sodass die Prüfung nichts beschönigt.

graphics-nodes

Sucht nach einem Node im Status Ready mit einem Grafikprozessor (GPU), den er zuweisen kann, nvidia.com/gpu. Wird keiner gefunden, gibt die Prüfung eine Warnung aus: the assistant will need a hosted model. Die Vorabprüfung behandelt dies als Empfehlung und blockiert deswegen nie, da der Assistent stattdessen über ein gehostetes Modell für künstliche Intelligenz (KI) antworten kann. Kapitel 2.14, KI-Anbieter und -Modelle, behandelt beide Wege.

ingress-class

Wenn ingress.className gesetzt ist, sucht die Prüfung nach dieser Klasse. Andernfalls sucht sie nach genau einer als Standard markierten Klasse. Sind zwei Klassen als Standard markiert, schlägt die Prüfung ebenfalls fehl, da der API-Server dann einen Ingress ohne Klasse ablehnt. Die Prüfung wird übersprungen und ihre Zeile weggelassen, wenn ingress.enabled auf false gesetzt ist.

ingress-ports

Sucht in dem durch networkPolicy.ingressNamespace benannten Namespace (standardmäßig kube-system, wo k3s Traefik ausführt) nach einem LoadBalancer- oder NodePort-Service, der sowohl Port 80 als auch 443 bereitstellt. Die Netzwerkrichtlinie des Charts erlaubt nur diesem Namespace den Zugriff auf die drei öffentlichen Services, sodass ein Ingress-Controller an einem anderen Ort Nexus selbst dann nicht bedienen könnte, wenn er lauschen würde. Der Korrekturhinweis nennt beide Lösungswege: Stellen Sie den Controller dort bereit oder setzen Sie networkPolicy.ingressNamespace auf den Ort, an dem er ausgeführt wird. Wird übersprungen, wenn ingress.enabled auf false gesetzt ist.

address

Fragt hosts.console, hosts.api und hosts.auth von Ihrer Workstation aus ab – jeweils fünf Sekunden lang – und gibt eine Zeile pro Host aus. Ein Host ohne Eintrag schlägt mit <host> → no record fehl. Ein nicht gesetzter Host schlägt mit hosts.<key> is not set fehl. Wenn ein Name mehrere Adressen hat, zeigt die Zeile die erste an (IPv4 vor IPv6) sowie die Anzahl der weiteren Adressen.

certificate

Wird nur ausgeführt, wenn tls.mode auf existing gesetzt ist und tls.existingSecret ein Secret benennt; bei cert-manager oder none gibt es kein eigenes Zertifikat zu lesen, und die Zeile wird weggelassen. Es liest tls.crt aus dem Secret im Installations-Namespace und nichts anderes. Ein Zertifikat, das noch 30 Tage oder länger gültig ist, besteht die Prüfung als ends 3 Nov 2027. Eines, das früher abläuft, warnt mit ends in 9 days; ein bereits abgelaufenes warnt mit ended 4 days ago. Ein fehlendes Secret oder eines ohne Zertifikat gibt eine Warnung samt Korrekturhinweis aus.

custodians

Liest keys.custody.recipients. Ist keiner vorhanden, schlägt die Prüfung mit dem Code KEYS_CUSTODIAN_MISSING fehl. Wenn ein Empfänger der Beispiel-Treuhänder aus den eigenen Werte-Dateien des Charts ist, schlägt sie mit KEYS_CUSTODIAN_EXAMPLE fehl, da niemand diesen Schlüssel besitzt und die Wiederherstellungsschlüssel der Installation für niemanden versiegelt würden. Bei Bestehen wird die Anzahl ausgegeben, zum Beispiel 3 custodians.

installation-name

Liest keys.installationName. Ist er nicht gesetzt, schlägt die Prüfung mit INSTALLATION_NAME_MISSING fehl. Ist er auf den Beispielnamen aus den Werte-Dateien des Charts gesetzt, schlägt sie mit INSTALLATION_NAME_EXAMPLE fehl. Bei Bestehen wird der Name ausgegeben. Die Anforderungsspalte erklärt, warum dieser Wert wichtiger ist als die meisten anderen: the first key-store bootstrap mints the installation identity under it, permanently.

Die letzten beiden Prüfungen melden exakt die Codes, mit denen auch das Chart selbst eine Installation verweigert. Die Vorabprüfung teilt es Ihnen lediglich schon vorher mit, noch bevor Helm irgendetwas erstellt hat.

Die Berichtsdateien

Jeder Durchlauf speichert zwei Dateien in --report-dir, benannt nach dem Zeitpunkt der Ausführung: preflight-2026-11-12-0902.txt, die ausgegebenen Zeilen ohne Farbcodes, und preflight-2026-11-12-0902.json, derselbe Durchlauf in einem festen, maschinenlesbaren Format. Die Terminalausgabe und die gespeicherten Zeilen stammen aus derselben Liste und unterscheiden sich daher nie.

Der JSON-Bericht folgt dem Schema nexus.preflight/v1:

Feld Inhalt
schema Genau nexus.preflight/v1
tool Ein Objekt: name (nexusctl) und version
release Das geprüfte Release
ran_at Wann er ausgeführt wurde, in koordinierter Weltzeit (UTC)
context Der Name des Kube-Kontexts
values Nur der Basisname der Werte-Datei
read_only Immer true
checks Ein Eintrag pro Zeile: id, section, name, requirement, must_pass, outcome (pass, warn oder fail), found, needs, fix und bei einem Nichtbestehen mit maschinenlesbarer Ursache code
counts passed, warnings und failed
can_install true, wenn nichts fehlgeschlagen ist
report_file Der Name der .txt-Datei
transcript Ein Objekt: title (nexusctl preflight) und lines, jede Zeile mit ihrer kind (prompt, ok, warn, bad, note, out oder blank), ihrem text und at sowie manchmal marks

Der Bericht ist so konzipiert, dass er angezeigt werden kann, bevor sich jemand anmeldet; daher enthält er keinen Benutzernamen, keinen Hostnamen der Workstation, keinen Dateipfad, kein Token und nichts aus Ihrer kubeconfig. values ist ein Basisname und context ist der Name des Kontexts. Würde der Bericht eines Durchlaufs gegen eine dieser Regeln verstoßen, weigert sich nexusctl, ihn auszugeben, zu speichern oder zu übergeben, und teilt dies auch mit. Ein Bericht ist höchstens 256 KiB groß, mit maximal 64 Prüfungen und 512 Zeichen in jedem einzelnen Textfeld.

Wie der Bericht in die Konsole gelangt

Der einzige Schreibvorgang der Vorabprüfung ist der fertige Bericht, der an den Schlüsseldienst der Installation, nexus-keys, übergeben wird, damit das Installationsprogramm der Konsole ihn auf seiner Vorabprüfungs-Seite anzeigen kann, bevor jemand die Installation beansprucht hat. --record entscheidet, ob dies versucht werden soll:

--record Was geschieht
auto Übergibt den Bericht nur, wenn der Namespace ein nexus-keys-Deployment aufweist
always Besteht darauf; die Vorabprüfung beendet sich mit 2, wenn nichts vorhanden ist, woran er übergeben werden könnte
never Übergibt ihn nicht

Ein Durchlauf vor der ersten Installation hat also kein Ziel für die Übergabe und behält den Bericht auf Ihrer Workstation. Ein Durchlauf nach der Installation und vor der Beanspruchung zeichnet ihn auf.

Die Übergabe nutzt Ihren eigenen Cluster-Zugang. nexusctl führt /app/nexus-keys preflight-record im Container keys eines bereiten nexus-keys-Pods aus und übergibt den Bericht über die Standardeingabe. Das entspricht:

kubectl exec -i -n nexus -c keys deploy/nexus-keys -- /app/nexus-keys preflight-record < preflight-2026-11-12-0902.json

Der Schlüsseldienst prüft den Bericht anhand derselben Regeln, die auch nexusctl anwendet, und behält nur den jeweils neuesten. Wenn er übergeben wurde, gibt nexusctl eine zusätzliche Zeile aus, die dies bestätigt, und das gespeicherte JSON erhält ein note, das die Übergabe protokolliert.

Das Installationsprogramm der Konsole liest ihn über die öffentliche Route GET /v1/installation/preflight des Schlüsseldienstes aus. Diese Route antwortet nur, solange die Installation noch nicht beansprucht wurde: Bevor ein Bericht aufgezeichnet wurde, antwortet sie mit 404 RECORD_NOT_FOUND, und sobald jemand die Installation beansprucht, antwortet sie dauerhaft mit ROUTE_NOT_FOUND, genau wie die Route für die Beanspruchung. Ein Bericht, der nach der Beanspruchung übergeben wird, wird mit INSTALLATION_CLAIMED abgelehnt.

In der Konsole erscheint ein Durchlauf mit Fehlern als „Preflight cannot continue“ (Vorabprüfung kann nicht fortgesetzt werden): die Anzahl der fehlgeschlagenen, gewarnten und bestandenen Prüfungen, gefolgt von jeder Prüfung gruppiert unter „Must pass“ (Muss bestehen) und „Should pass“ (Sollte bestehen), wobei die nicht bestandenen zuerst aufgeführt werden und daneben jeweils steht, was gefunden wurde. Ein Durchlauf ohne Fehler erhält diese Seite nicht; die Konsole geht direkt zur Beanspruchung über (Kapitel 2.12, Der erste Start).

Vorabprüfung kann nicht fortgesetzt werden
Vorabprüfung kann nicht fortgesetzt werden
Die Konsolenseite für einen Vorabprüfungs-Durchlauf, der nicht fortgesetzt werden kann. Die fehlgeschlagenen Prüfungen stehen an erster Stelle, jeweils ausformuliert mit dem, was gefunden wurde, und die Installation bleibt blockiert, bis sie bestanden werden.
Drei Spalten. Links, „Operator workstation“: ein Kasten „nexusctl preflight --context --values“ mit zwei Ausgaben darunter, „preflight-<time>.txt“ und „preflight-<time>.json“. Mitte, „The installation, unclaimed“: ein Kasten „nexus-keys“ mit der Beschriftung „preflight-record, latest report only“. Ein Pfeil vom linken Kasten zu nexus-keys ist beschriftet mit „pod exec with your own cluster access (--record auto or always)“. Rechts, „Browser, before sign-in“: ein Kasten „Console installer, Preflight cannot continue“. Ein Pfeil von nexus-keys dorthin ist beschriftet mit „GET /v1/installation/preflight“. Unter dem mittleren Kasten steht ein kleiner Hinweis: „after the claim: ROUTE_NOT_FOUND“.
Der Weg eines Vorabprüfungs-Berichts von der Workstation des Operators bis zum Browser.

Erforderliche Zugriffsrechte für den Durchlauf

Die Vorabprüfung wird unter Ihrem Benutzerkonto mit Ihrer kubeconfig ausgeführt. Das Konto benötigt Lesezugriff auf:

  • Nodes, für die Prüfungen von Version, Bereitschaft, Ressourcen und Grafik;
  • Speicherklassen und Ingress-Klassen;
  • Services im Ingress-Namespace;
  • das TLS-Secret im Installations-Namespace, wenn die Zertifikatsprüfung ausgeführt wird.

Wenn ein Lesezugriff verweigert wird, steht in der Zeile could not read <what> (the cluster refused), und der Korrekturhinweis gibt an, welcher Lesezugriff gewährt werden muss. Der Text enthält niemals die Adresse des Servers oder dessen eigenen Fehlertext, da der Bericht vor der Anmeldung angezeigt werden kann. Die Übergabe benötigt außerdem pods/exec auf den nexus-keys-Pods; ohne dies speichert auto die Dateien und gibt eine Warnung aus, und always beendet sich mit 2.

Wenn die Vorabprüfung selbst nicht ausgeführt werden kann

Exit-Code 2 bedeutet, dass kein Bericht erstellt wurde. Die Meldung auf der Standardfehlerausgabe nennt den Grund:

Meldung Vorgehensweise
--context is required: the kube context to check Fügen Sie --context hinzu
--values is required: the values file the install will use Fügen Sie --values hinzu
could not read the values file harrow-values.yaml Überprüfen Sie den Pfad und die Dateiberechtigungen
preflight takes flags only Entfernen Sie das überzählige Argument
the report breaks its contract and was not printed, saved or handed over Ein Feld hätte private Daten enthalten; melden Sie dies zusammen mit den Flags des Durchlaufs an Adverant
--record always: there is no nexus-keys Deployment in the namespace nexus to hand the report to Installieren Sie zuerst oder verwenden Sie --record auto
could not hand the report to this installation Überprüfen Sie Ihre Berechtigung für exec in nexus-keys

Ein Cluster, dessen API nicht erreichbar ist, beendet sich ebenfalls mit 2. Korrigieren Sie die kubeconfig oder das Netzwerk und führen Sie den Vorgang erneut aus.

Sobald die Vorabprüfung mit 0 failed endet, fahren Sie mit Kapitel 2.6, Installation von Community auf Kubernetes, fort, um Community zu installieren, oder mit Kapitel 2.7, Installation von Enterprise und Anwenden einer Lizenz, für Enterprise.