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.

Fehlgeschlagenen Knoten in GKE on Bare Metal zurücksetzen

Wenn Knoten in GKE on Bare Metal ausfallen, z. B. aufgrund einer Fehlkonfiguration des Speichers, Netzwerks oder Betriebssystems, sollten Sie den Clusterzustand effizient wiederherstellen. Nachdem Sie den Clusterzustand wiederhergestellt haben, können Sie den Knotenfehler beheben.

In diesem Dokument erfahren Sie, wie Sie nach einem Knotenfehler wiederherstellen, indem Sie einen Knoten zurücksetzen und den Knoten bei Bedarf zwangsweise entfernen.

Wenn Sie Knoten zu einem Cluster unter normalen Umständen hinzufügen oder daraus entfernen möchten, wenn ein Knoten nicht ausgefallen ist, lesen Sie Cluster aktualisieren.

Überblick

Bei einem Knotenfehler können Sie manchmal keine Befehle zum Zurücksetzen auf den Knoten ausführen, da der Knoten möglicherweise nicht erreichbar ist. Möglicherweise müssen Sie das Entfernen des Knotens aus dem Cluster erzwingen.

Wenn Sie einen Knoten sauber zurücksetzen und den Cluster aktualisieren, werden die folgenden Aktionen ausgeführt:

Der Knoten wird ähnlich wie kubeadm reset zurückgesetzt und die Maschine wird in den vorinstallierten Zustand zurückgesetzt.
Die zugehörigen Verweise auf den Knoten werden aus dem Knotenpool und den benutzerdefinierten Clusterressourcen entfernt.

Worker-Knoten

Wenn Sie einen Knoten aus einem Cluster entfernen möchten, versuchen Sie zuerst, ihn ordnungsgemäß zu entfernen:

Versuchen Sie, den Knoten ordnungsgemäß zurückzusetzen. Nachdem der Knoten zurückgesetzt wurde, wird er aus dem Cluster entfernt:
```
bmctl reset nodes \
  --addresses COMMA_SEPARATED_IPS \
  --cluster CLUSTER_NAME \
  --kubeconfig ADMIN_KUBECONFIG
```
Ersetzen Sie die folgenden Werte:
- COMMA_SEPARATED_IP: die IP-Adressen der zurückzusetzenden Knoten, z. B. 10.200.0.8,10.200.0.9.
- CLUSTER_NAME: der Name des Zielclusters, der die fehlgeschlagenen Knoten enthält.
- ADMIN_KUBECONFIG: der Pfad zur kubeconfig-Datei des Administratorclusters.
Sie können jetzt den Knoten diagnostizieren und alle Fehlkonfigurationen beheben, die den anfänglichen Fehler verursacht haben. Überspringen Sie die restlichen Schritte in diesem Abschnitt.
Wenn der vorherige Schritt zum Zurücksetzen des Knotens fehlschlägt, können Sie den Knoten zwangsweise aus dem Cluster entfernen. Durch diese erzwungene Entfernung wird der vorherige Schritt übersprungen, der die Befehle zum Zurücksetzen ausführt. Es wird nur der Schritt ausgeführt, um die zugehörigen Verweise auf den Knoten aus dem Knotenpool und den benutzerdefinierten Clusterressourcen zu entfernen:
```
bmctl reset nodes \
 --addresses COMMA_SEPARATED_IPS \
 --cluster CLUSTER_NAME \
 --kubeconfig ADMIN_KUBECONFIG \
 --force
```
Sie können jetzt den Knoten diagnostizieren und alle Fehlkonfigurationen beheben, die den anfänglichen Fehler verursacht haben.
Wenn Sie das Entfernen des Knotens im vorherigen Schritt erzwungen haben, führen Sie den Befehl bmctl reset noch einmal aus, um die Knoten zurückzusetzen:
```
bmctl reset nodes \
  --addresses COMMA_SEPARATED_IPS \
  --cluster CLUSTER_NAME \
  --kubeconfig ADMIN_KUBECONFIG
```

Ausfall eines einzelnen Knotens der Steuerungsebene

Der Prozess ist derselbe wie bei Worker-Knoten. Bei Knoten der Steuerungsebene bereinigt bmctl auch die Mitgliedschaft etcd.

Wenn Sie einen Knoten aus einem Cluster entfernen möchten, versuchen Sie zuerst, ihn ordnungsgemäß zu entfernen:

Versuchen Sie, den Knoten ordnungsgemäß zurückzusetzen. Nachdem der Knoten zurückgesetzt wurde, wird er aus dem Cluster entfernt:
```
bmctl reset nodes \
  --addresses COMMA_SEPARATED_IPS \
  --cluster CLUSTER_NAME \
  --kubeconfig ADMIN_KUBECONFIG
```
Ersetzen Sie die folgenden Werte:
- COMMA_SEPARATED_IP: die IP-Adressen der zurückzusetzenden Knoten, z. B. 10.200.0.8,10.200.0.9.
- CLUSTER_NAME: der Name des Zielclusters, der die fehlgeschlagenen Knoten enthält.
- ADMIN_KUBECONFIG: der Pfad zur kubeconfig-Datei des Administratorclusters.
Sie können jetzt den Knoten diagnostizieren und alle Fehlkonfigurationen beheben, die den anfänglichen Fehler verursacht haben. Überspringen Sie die restlichen Schritte in diesem Abschnitt.
Wenn der vorherige Schritt zum Zurücksetzen des Knotens fehlschlägt, können Sie den Knoten zwangsweise aus dem Cluster entfernen. Durch diese erzwungene Entfernung wird der vorherige Schritt übersprungen, der die Befehle zum Zurücksetzen ausführt. Es wird nur der Schritt ausgeführt, um die zugehörigen Verweise auf den Knoten aus dem Knotenpool und den benutzerdefinierten Clusterressourcen zu entfernen:
```
bmctl reset nodes \
  --addresses COMMA_SEPARATED_IPS \
  --cluster CLUSTER_NAME \
  --kubeconfig ADMIN_KUBECONFIG \
  --force
```
Sie können jetzt den Knoten diagnostizieren und alle Fehlkonfigurationen beheben, die den anfänglichen Fehler verursacht haben.
Wenn Sie das Entfernen des Knotens im vorherigen Schritt erzwungen haben, führen Sie den Befehl bmctl reset noch einmal aus, um die Knoten zurückzusetzen:
```
bmctl reset nodes \
  --addresses COMMA_SEPARATED_IPS \
  --cluster CLUSTER_NAME \
  --kubeconfig ADMIN_KUBECONFIG
```

In Hochverfügbarkeits-Steuerungsebene verlorenes Quorum

Wenn zu viele Knoten der Steuerungsebene in einem Hochverfügbarkeitscluster den Status „Fehlgeschlagen“ erhalten, verliert der Cluster das Quorum und ist nicht mehr verfügbar.

Führen Sie den folgenden Befehl auf einem verbleibenden fehlerfreien Knoten aus, um einen Cluster wiederherzustellen, der das Quorum verloren hat:
```
bmctl restore --control-plane-node CONTROL_PLANE_NODE \
  --cluster CLUSTER_NAME \
  [--kubeconfig KUBECONFIG_FILE]
```
Ersetzen Sie die folgenden Werte:
- CONTROL_PLANE_NODE: die IP-Adressen eines fehlerfreien Knotens, der Teil des Clusters bleibt.
- CLUSTER_NAME: der Name des Zielclusters, der die fehlgeschlagenen Knoten enthält.
- KUBECONFIG_FILE: bei der Wiederherstellung eines Nutzerclusters der Pfad zur kubeconfig-Datei des Nutzerclusters.
Nachdem Sie die fehlgeschlagenen Knoten wiederhergestellt haben, führen Sie den Befehl bmctl reset aus, um die Knoten zurückzusetzen:
```
bmctl reset nodes \
  --addresses COMMA_SEPARATED_IPS \
  --cluster CLUSTER_NAME \
  [--kubeconfig KUBECONFIG_FILE]
```
Ersetzen Sie die folgenden Werte:
- COMMA_SEPARATED_IP: die IP-Adressen der zurückzusetzenden Knoten, z. B. 10.200.0.8,10.200.0.9.
- CLUSTER_NAME: der Name des Zielclusters, der die fehlgeschlagenen Knoten enthält.
- KUBECONFIG_FILE: der Pfad zur kubeconfig-Datei des Administratorclusters.
Wenn die fehlgeschlagenen Knoten Teil der Load-Balancer-Knotenpools waren, können sie nach der Wiederherstellung der Knoten um die virtuelle IP-Adresse der Steuerungsebene konkurrieren und den neuen Cluster instabil machen. Führen Sie die Befehle zum Zurücksetzen so schnell wie möglich nach der Wiederherstellung der Knoten für die fehlgeschlagenen Knoten aus.

Nächste Schritte

Weitere Informationen zum Hinzufügen oder Entfernen von Knoten zu einem Cluster, wenn kein Fehler auftritt, und zum Prüfen des Knotenstatus finden Sie unter Cluster aktualisieren.