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.

Knoten in den Wartungsmodus versetzen

Wenn Sie Knoten reparieren oder warten müssen, sollten Sie zuerst die Knoten in den Wartungsmodus versetzen. Durch das Versetzen von Knoten in den Wartungsmodus werden ihnen die Pods/Arbeitslasten sicher entzogen und die Knoten werden von der Pod-Planung ausgeschlossen. Im Wartungsmodus können Sie auf Ihren Knoten arbeiten, ohne den Pod-Traffic möglicherweise zu beeinträchtigen.

Funktionsweise

GKE on Bare Metal bietet eine Möglichkeit, Knoten in den Wartungsmodus zu versetzen. Dadurch wissen andere Clusterkomponenten, dass sich der Knoten im Wartungsmodus befindet. Wenn Sie einen Knoten in den Wartungsmodus versetzen, können keine weiteren Pods auf dem Knoten geplant werden und vorhandene Pods werden gestoppt.

Anstatt den Wartungsmodus zu verwenden, können Sie auch manuell Kubernetes-Befehle wie kubectl cordon und kubectl drain auf einem bestimmten Knoten verwenden. Wenn Sie GKE on Bare Metal Version 1.12.0 (anthosBareMetalVersion: 1.12.0) oder niedriger ausführen, lesen Sie das bekannte Problem zu Nicht gesperrte Knoten, wenn Sie das Verfahren für den Wartungsmodus nicht verwenden.

Wenn Sie den Wartungsmodus verwenden, führt GKE on Bare Metal folgende Schritte aus:

Knotenmarkierungen

werden den angegebenen Knoten hinzugefügt, um anzuzeigen, dass auf den Knoten keine Pods geplant oder ausgeführt werden können.
Damit Knoten beim Beenden von Pods nicht im Wartezustand verbleiben, wird ein Zeitlimit von 20 Minuten erzwungen. Pods werden möglicherweise nicht beendet, wenn sie so konfiguriert sind, dass sie alle Markierungen tolerieren oder Finalizer haben. GKE on Bare Metal versucht, alle Pods zu beenden. Wenn das Zeitlimit überschritten wird, wird der Knoten in den Wartungsmodus versetzt. Dieses Zeitlimit verhindert, dass Upgrades von Pods durch Ausführung von Pods blockiert werden.

Knoten in den Wartungsmodus versetzen

Wählen Sie in Ihrer Cluster-Konfigurationsdatei für die unter maintenanceBlocks ausgewählten Knoten die IP-Bereiche aus, die Sie in den Wartungsmodus versetzen möchten. Die Knoten, die Sie auswählen, müssen bereit sein und im Cluster funktionieren.

So versetzen Sie Knoten in den Wartungsmodus:

Bearbeiten Sie die Cluster-Konfigurationsdatei, um die Knoten auszuwählen, die Sie in den Wartungsmodus versetzen möchten.

Sie können die Konfigurationsdatei mit einem Editor Ihrer Wahl bearbeiten oder die benutzerdefinierte Clusterressource direkt mit folgendem Befehl bearbeiten:
```
kubectl -n CLUSTER_NAMESPACE edit cluster CLUSTER_NAME
```
Ersetzen Sie Folgendes:
- CLUSTER_NAMESPACE: den Namespace des Clusters.
- CLUSTER_NAME ist der Name des Clusters.
Fügen Sie der Cluster-Konfigurationsdatei den maintenanceBlocks-Abschnitt hinzu, um entweder eine einzelne IP-Adresse oder einen Adressbereich für die Knoten anzugeben, die Sie in den Wartungsmodus versetzen möchten.

Im folgenden Beispiel wird gezeigt, wie Sie durch die Angabe eines IP-Adressbereichs mehrere Knoten auswählen:
```
metadata:
  name: my-cluster
  namespace: cluster-my-cluster
spec:
  maintenanceBlocks:
    cidrBlocks:
    - 172.16.128.1-172.16.128.64
```
Speichern Sie die aktualisierte Cluster-Konfiguration und wenden Sie sie an.

GKE on Bare Metal versetzt die Knoten in den Wartungsmodus.

Führen Sie folgenden Befehl aus, um den Status der Knoten in Ihrem Cluster abzurufen:

kubectl get nodes --kubeconfig=KUBECONFIG

Die Ausgabe sollte in etwa so aussehen:

NAME                       STATUS   ROLES           AGE     VERSION
user-anthos-baremetal-01   Ready    control-plane   2d22h   v1.25.10-gke.2100
user-anthos-baremetal-04   Ready    worker          2d22h   v1.25.10-gke.2100
user-anthos-baremetal-05   Ready    worker          2d22h   v1.25.10-gke.2100
user-anthos-baremetal-06   Ready    worker          2d22h   v1.25.10-gke.2100

Die Knoten sind weiterhin planbar, aber Markierungen verhindern, dass Pods (ohne entsprechende Toleranz) auf dem Knoten geplant werden.

Führen Sie folgenden Befehl aus, um die Anzahl der Knoten im Wartungsmodus abzurufen:
```
kubectl get nodepools
```
Die Antwort sollte in etwa so aussehen:
```
NAME   READY   RECONCILING   STALLED   UNDERMAINTENANCE   UNKNOWN
np1    3       0             0         1                  0
```
Die Spalte UNDERMAINTENANCE in diesem Beispiel zeigt, dass sich ein Knoten im Wartungsmodus befindet.

GKE on Bare Metal fügt Knoten außerdem die folgenden Markierungen hinzu, wenn sie in den Wartungsmodus versetzt werden:
- baremetal.cluster.gke.io/maintenance:NoExecute
- baremetal.cluster.gke.io/maintenance:NoSchedule

Knoten aus dem Wartungsmodus entfernen

So holen Sie Knoten aus dem Wartungsmodus:

Bearbeiten Sie die Cluster-Konfigurationsdatei, um die Knoten zu löschen, die Sie aus dem Wartungsmodus holen möchten.

Sie können die Konfigurationsdatei mit einem Editor Ihrer Wahl bearbeiten oder die benutzerdefinierte Clusterressource direkt mit folgendem Befehl bearbeiten:
```
kubectl -n CLUSTER_NAMESPACE edit cluster CLUSTER_NAME
```
Ersetzen Sie Folgendes:
- CLUSTER_NAMESPACE: den Namespace des Clusters.
- CLUSTER_NAME ist der Name des Clusters.
Bearbeiten Sie entweder die IP-Adressen, um bestimmte Knoten aus dem Wartungsmodus zu holen, oder entfernen Sie den maintenanceBlocks-Abschnitt, um alle Knoten aus dem Wartungsmodus zu holen.
Speichern Sie die aktualisierte Cluster-Konfiguration und wenden Sie sie an.
Mit kubectl-Befehlen können Sie den Status Ihrer Knoten prüfen.