Version 1.14. This version is no longer supported. For information about how to upgrade to version 1.15, see Upgrading Anthos on bare metal in the 1.15 documentation. For more information about supported and unsupported versions, see the Version history page in the latest documentation.

Informationen zu Preflight-Prüfungen

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

GKE on Bare Metal führt Preflight-Prüfungen aus, wenn Sie Administrator-, Hybrid-, eigenständige oder Nutzercluster und Knotenpoolressourcen mit bmctl erstellen oder aktualisieren. Wenn die Prüfungen fehlschlagen, werden keine Änderungen vorgenommen. Sie können diese Prüfungen auch umgehen.
GKE on Bare Metal führt auch interne Preflight-Prüfungen aus, wenn Sie Kubernetes-Ressourcen auf Nutzercluster aus einem Administrator- oder Hybridcluster 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 mit dem Befehl bmctl admin, Hybrid-, eigenständige oder Nutzercluster erstellen, führt GKE on Bare Metal automatisch Preflight-Prüfungen aus, bevor Änderungen vorgenommen werden.

Wenn die Prüfungen bestanden wurden, erstellt GKE 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 Clusterkonfigurationsdatei, versucht aber 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.

Letzte Preflight-Prüfungen und Systemdiagnosen ausführen

Sie können Preflight-Prüfungen auf Ihrem System durchführen. Preflight-Prüfungen stellen sicher, dass Ihre Maschinen und Ihr Netzwerk für die Clustererstellung bereit sind. Mit dem folgenden Befehl werden Ihre Maschinen und Ihr Netzwerk anhand der neuesten Diagnoseliste geprüft, um sicherzustellen, dass sie für die Clustererstellung bereit sind:

bmctl check preflight --cluster CLUSTER_NAME --check-image-version latest

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

Sie können auch Systemdiagnosen eines Liveclusters durchführen, um festzustellen, ob der Cluster fehlerfrei ist. Führen Sie den folgenden Befehl aus, um die neuesten Systemdiagnosen für einen Live-Cluster durchzuführen:

bmctl check cluster --cluster CLUSTER_NAME --check-image-version latest

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

Preflight-Prüfungen auf Upgrades

Mit dem Befehl bmctl check preflight können Sie eine Preflight-Prüfung ausführen, bevor Sie den Cluster upgraden. Sie können prüfen, ob die Cluster für ein Upgrade bereit sind. Führen Sie dazu den folgenden Preflight-Check-Befehl aus, bevor Sie das Upgrade starten:

Aktualisieren Sie die Clusterversion (anthosBareMetalVersion) in der Clusterkonfigurationsdatei.
Mit dem folgenden Befehl können Sie prüfen, ob die Cluster für ein Upgrade bereit sind, und eine Preflight-Prüfung ausführen:
```
bmctl check preflight --kubeconfig ADMIN_CLUSTER_KUBECONFIG_PATH
 -c CLUSTER_NAME
```
Ersetzen Sie Folgendes:
- CLUSTER_NAME: der Name des Clusters, der aktualisiert werden soll.
- ADMIN_CLUSTER_KUBECONFIG_PATH: der Pfad zur kubeconfig-Datei des Administratorclusters.
Beachten Sie, dass bmctl check preflight für Upgrades funktioniert, wenn der ursprüngliche Cluster die Version 1.13.1 oder höher hat.

Wenn Sie die Preflight-Prüfung mit diesem Befehl erstellen, um das Upgrade eines Administrator- oder Nutzerclusters zu testen, wird im Administratorcluster eine benutzerdefinierte PreflightCheck-Ressource erstellt.

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

Nutzercluster werden von einem vorhandenen Administrator- oder Hybridcluster erstellt. GKE on Bare Metal führt automatisch Preflight-Prüfungen aus, bevor Änderungen vorgenommen werden. Sie können Preflight-Prüfungen auch mit bmctl ausführen, bevor Sie einen Cluster erstellen.

Der folgende Befehl validiert die angegebene Clusterkonfigurationsdatei, versucht aber 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

GKE on Bare Metal führt auch interne Preflight-Prüfungen durch, wenn Sie Kubernetes-Ressourcen auf einen vorhandenen Cluster anwenden. Wenn Prüfungen fehlschlagen, nimmt GKE on Bare Metal keine Änderungen an den zugehörigen Knoten vor, es sei denn, Sie haben die Prüfungen speziell umgangen.

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

Damit die internen Preflight-Prüfungen beim Anwenden von Ressourcen auf vorhandene Cluster ignoriert werden, müssen Sie das Feld BypassPreflightCheck in der YAML-Datei des Clusters auf true setzen.

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.14.11
....

Details zur Installation der Preflight-Prüfung

GKE on Bare Metal prüft beim Ausführen von Preflight-Prüfungen eine Vielzahl von Betriebssystem-, Software- und Maschinenanforderungen.

Weitere Informationen finden Sie im Hilfeartikel Installationsvoraussetzungen.