Informationen zu Preflight-Prüfungen

In Anthos-Cluster on Bare Metal können Sie Preflight-Prüfungen für verschiedene Situationen ausführen:

  • Anthos-Cluster on Bare Metal führt Preflight-Prüfungen durch, wenn Sie Administrator-, Hybrid- oder Standalone-Cluster und Knotenpools mit bmctl erstellen oder aktualisieren. Wenn die Prüfungen fehlschlagen, werden keine Änderungen vorgenommen. Sie können diese Prüfungen auch umgehen.
  • Außerdem führt Anthos-Cluster on Bare Metal interne Preflight-Prüfungen durch, wenn Sie Kubernetes-Ressourcen von einem Administrator- oder Hybridcluster auf Nutzercluster anwenden. Die Diagnosen werden ausgeführt, bevor die Änderungen tatsächlich auf die betroffenen Nutzercluster angewendet werden. Wenn die Prüfungen fehlschlagen, werden keine Änderungen vorgenommen. Sie können diese Prüfungen auch umgehen oder explizit ausführen.

Preflight-Prüfungen für die Clustererstellung mit bmctl

Wenn Sie Administrator-, Hybrid-, Standalone oder Nutzer-Cluster mit dem Befehl bmctl erstellen, führt Anthos-Cluster on Bare Metal automatisch Preflight-Prüfungen aus, bevor Änderungen vorgenommen werden.

Wenn die Prüfungen bestanden wurden, erstellt Anthos-Cluster on Bare Metal die Cluster.

Ergebnisse der automatisierten Preflight-Prüfungen ignorieren

Wenn Sie diese automatisierten Preflight-Prüfungen umgehen möchten, können Sie das optionale Flag --force im Befehl verwenden.

Preflight-Prüfungen unabhängig ausführen

Sie können Preflight-Prüfungen auch selbst ausführen, bevor Sie einen Cluster erstellen. Auf diese Weise können Sie Zeit sparen, indem Sie dafür sorgen, dass Ihre Rechner- und Knotenressourcen Prüfungen erfolgreich bestehen.

  • Der folgende Befehl validiert die angegebene Cluster-Konfigurationsdatei, versucht jedoch nicht, den Cluster selbst zu erstellen:

    bmctl check config --cluster CLUSTER_NAME
    

    Ersetzen Sie CLUSTER_NAME durch den Namen des Clusters, dessen Konfigurationsdatei Sie prüfen.

  • Dieser Befehl prüft, ob die Maschinen und das Netzwerk für die Clustererstellung bereit sind:

    bmctl check preflight --cluster CLUSTER_NAME
    

    Ersetzen Sie CLUSTER_NAME durch den Namen des Clusters, den Sie prüfen.

Preflight-Prüfungen für die Erstellung von Nutzerclustern

Nutzercluster werden von einem vorhandenen Administrator- oder Hybridcluster erstellt. Bei Anthos-Clustern auf Bare-Metal werden vor der Durchführung von Änderungen automatisch Preflight-Prüfungen durchgeführt. Sie können Preflight-Prüfungen auch mit bmctl ausführen, bevor Sie einen Cluster erstellen.

  • Der folgende Befehl validiert die angegebene Cluster-Konfigurationsdatei, versucht jedoch nicht, den Cluster selbst zu erstellen:

    bmctl check config --cluster CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH
    

    Ersetzen Sie CLUSTER_NAME durch den Namen des zu prüfenden Nutzerclusters und ersetzen Sie ADMIN_KUBECONFIG_PATH durch den Pfad zur kubeconfig-Datei des zugehörigen Administratorclusters.

  • Dieser Befehl prüft, ob die Maschinen und das Netzwerk für die Clustererstellung bereit sind:

    bmctl check preflight --cluster CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH
    

bmctl unterstützt die Verwendung von --kubeconfig als Alias für das Flag --admin-kubeconfig.

Interne Preflight-Prüfungen für vorhandene Cluster

Anthos-Cluster on Bare Metal führt auch interne Preflight-Prüfungen durch, wenn Sie Kubernetes-Ressourcen auf einen vorhandenen Cluster anwenden. Wenn eine Prüfung fehlschlägt, nimmt Anthos-Cluster on Bare Metal keine Änderungen an den zugehörigen Knoten vor, es sei denn, Sie haben die Prüfungen bestanden.

Preflight-Prüfungen beim Anwenden von Kubernetes-Ressourcen umgehen

Wenn Sie die internen Preflight-Prüfungen beim Anwenden von Ressourcen auf vorhandene Cluster ignorieren möchten, legen Sie in der YAML-Datei des Clusters das Feld BypassPreflightCheck auf true fest.

Hier ist ein Fragment einer YAML-Datei für die Clusterkonfiguration, in der das Feld bypassPreflightCheck auf true gesetzt ist.

# Sample cluster config to bypass preflight check errors:

apiVersion: v1
kind: Namespace
metadata:
  name: cluster-user1
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: user1
  namespace: cluster-user1
spec:
  type: user
  bypassPreflightCheck: true
  # Anthos cluster version.
  anthosBareMetalVersion: 1.11.8
....

Details zur Installation der Preflight-Prüfung

Anthos-Cluster on Bare Metal prüft verschiedene Betriebssystem-, Software- und Computervoraussetzungen, wenn Preflight-Prüfungen ausgeführt werden.

Weitere Informationen finden Sie im Hilfeartikel Installationsvoraussetzungen.