Erweiterte Cluster mit gkectl sichern und wiederherstellen

In diesem Dokument wird beschrieben, wie Sie Administrator- und Nutzercluster der Google Distributed Cloud-Version 1.32 und höher sichern und wiederherstellen, für die erweiterte Cluster aktiviert sind. Die Funktion zum Sichern und Wiederherstellen ist in Version 1.32 als Vorabversion und in Version 1.33 und höher als GA verfügbar.

Der Sicherungs- und Wiederherstellungsprozess von gkectl umfasst keine nichtflüchtigen Volumes. Alle Volumes, die vom lokalen Volume-Bereitsteller (Local Volume Provisioner, LVP) erstellt werden, bleiben unverändert.

Cluster sichern

Mit dem Befehl gkectl backup cluster werden die Clusterinformationen aus dem etcd-Speicher und die PKI-Zertifikate für den angegebenen Cluster einer TAR-Datei hinzugefügt. Der etcd-Speicher ist der Kubernetes-Sicherungsspeicher für alle Clusterdaten. Er enthält alle Kubernetes-Objekte und benutzerdefinierten Objekte, die zur Verwaltung des Clusterstatus erforderlich sind. Die PKI-Zertifikate werden für die Authentifizierung über Transport Layer Security (TLS) verwendet. Diese Daten werden von der Steuerungsebene des Clusters oder von einer der Steuerungsebenen für eine Hochverfügbarkeitsbereitstellung gesichert.

Die TAR-Datei für die Sicherung enthält vertrauliche Anmeldedaten, einschließlich der Dienstkontoschlüssel und des SSH-Schlüssels. Speichern Sie Sicherungsdateien an einem sicheren Ort. Um eine unbeabsichtigte Dateisichtbarkeit zu verhindern, verwendet der Sicherungsprozess nur speicherinterne Dateien.

Sichern Sie Ihre Cluster regelmäßig, um dafür zu sorgen, dass die Snapshot-Daten relativ aktuell sind. Passen Sie die Sicherungsrate entsprechend der Häufigkeit signifikanter Änderungen an Ihren Clustern an.

Prüfen Sie vorab, ob der Cluster ordnungsgemäß funktioniert und ob die Anmeldedaten und die SSH-Verbindung zu allen Knoten funktionieren. Der Sicherungsprozess dient dazu, Ihren Cluster in einem als funktionierend bekannten Zustand zu erfassen, damit Sie den Betrieb im Falle eines Totalausfalls wiederherstellen können.

So sichern Sie einen Cluster:

  1. Prüfen Sie den Cluster mit dem folgenden Befehl:

    gkectl diagnose cluster --cluster-name CLUSTER_NAME \
        --kubeconfig ADMIN_KUBECONFIG
    

    Ersetzen Sie Folgendes:

    • CLUSTER_NAME: der Name des Clusters, den Sie sichern möchten.

    • Ersetzen Sie dabei ADMIN_KUBECONFIG durch den Pfad der kubeconfig-Datei für den Administratorcluster.

  2. Führen Sie den entsprechenden Befehl aus, um den Cluster zu sichern:

    Administratorcluster

    gkectl backup admin --kubeconfig ADMIN_KUBECONFIG
    

    Nutzercluster

    gkectl backup cluster --cluster-name CLUSTER_NAME \
        --kubeconfig ADMIN_KUBECONFIG
    

Standardmäßig wird die TAR-Sicherungsdatei im Verzeichnis gkectl-workspace/backups auf Ihrer Administrator-Workstation gespeichert. Die TAR-Datei hat den Namen CLUSTER_NAME_backup_TIMESTAMP.tar.gz, wobei CLUSTER_NAME der Name des Clusters ist, der gesichert wird, und TIMESTAMP das Datum und die Uhrzeit der Sicherung ist. Wenn der Clustername beispielsweise testuser lautet, hat die Sicherungsdatei einen Namen wie testuser_backup_2025-08-23T150405Z0700.tar.gz.

Optional können Sie mit dem Flag --backup-file einen anderen Namen und Speicherort für Ihre Sicherungsdatei angeben, z. B.:

gkectl backup cluster testuser \
    --kubeconfig admin-cluster/kubeconfig \
    --backup-file cluster-backups/testuser-backup-aug-23-2025.tar.gz

Die Sicherungsdatei läuft nach einem Jahr ab und der Clusterwiederherstellungsprozess funktioniert nicht mit abgelaufenen Sicherungsdateien.

Sicherung in vSphere

So konfigurieren Sie Sicherungen, damit die Sicherungsdatei für Administrator- und Nutzercluster zusätzlich zum Speichern auf Ihrer Administrator-Workstation in vSphere hochgeladen wird:

  1. Fügen Sie der Konfigurationsdatei für den Administratorcluster das Feld clusterBackup.datastore hinzu:

    clusterBackup:
        datastore: DATASTORE
    

    Ersetzen Sie DATASTORE durch den Datastore, in dem Sie die Sicherung speichern möchten. Der Datenspeicher muss sich im selben Rechenzentrum wie der Administratorcluster befinden. Die Sicherungen befinden sich im Verzeichnis anthos/CLUSTER_NAME/backup des angegebenen Datenspeichers.

  2. Aktualisieren Sie den Administratorcluster:

    gkectl update admin --kubeconfig ADMIN_KUBECONFIG \
        --config ADMIN_CONFIG
    

    Ersetzen Sie Folgendes:

    • Ersetzen Sie dabei ADMIN_KUBECONFIG durch den Pfad der kubeconfig-Datei für den Administratorcluster.

    • ADMIN_CONFIG: der Pfad Ihrer Administratorcluster-Konfigurationsdatei.

Standardmäßig werden mit dem Befehl gkectl backup die drei neuesten Sicherungsdateien in vSphere gespeichert und ältere Sicherungsdateien gelöscht. Wenn Sie die älteren Sicherungsdateien behalten möchten, fügen Sie das Flag --keep-all-backups hinzu, das in Version 1.32.100 und höher verfügbar ist.

Cluster wiederherstellen

Die Wiederherstellung eines Clusters aus einer Sicherung ist ein letztes Mittel und sollte nur verwendet werden, wenn ein Cluster katastrophal ausgefallen ist und nicht auf andere Weise wieder in Betrieb genommen werden kann. Dies kann beispielsweise der Fall sein, wenn die etcd-Daten beschädigt sind oder wenn sich der etcd-Pod in einer Absturzschleife befindet.

Verwenden Sie den Befehl gkectl restore nur, wenn alle drei Knoten der Steuerungsebene ausgefallen sind.

  • Wenn nur ein Knoten ausgefallen ist und autoRepair.enabled in der Konfigurationsdatei des Administratorclusters auf true gesetzt ist, wird der ausgefallene Knoten automatisch repariert. Wenn autoRepair.enabled nicht konfiguriert ist, fügen Sie es der Konfigurationsdatei des Administratorclusters hinzu und führen Sie gkectl update admin aus. Nach dem Update wird der Knoten automatisch neu erstellt.

  • Wenn zwei Knoten der Steuerungsebene fehlgeschlagen sind, lesen Sie den Abschnitt Quorum wiederherstellen auf dieser Seite.

Die TAR-Datei für die Sicherung enthält vertrauliche Anmeldedaten, einschließlich der Dienstkontoschlüssel und des SSH-Schlüssels. Um eine unbeabsichtigte Dateisichtbarkeit zu verhindern, verwendet der Wiederherstellungsprozess von Google Distributed Cloud nur speicherinterne Dateien.

Bevor Sie einen Cluster wiederherstellen, müssen die folgenden Bedingungen erfüllt sein:

  • Alle Maschinen der Steuerungsebene, die zum Zeitpunkt der Sicherung für den Cluster verfügbar waren, funktionieren ordnungsgemäß und sind erreichbar.
  • Die SSH-Verbindung zwischen Knoten funktioniert mit den SSH-Schlüsseln, die zum Zeitpunkt der Sicherung verwendet wurden. Diese SSH-Schlüssel werden im Rahmen des Wiederherstellungsprozesses reaktiviert.
  • Die Dienstkontoschlüssel, die zum Zeitpunkt der Sicherung verwendet wurden, sind noch aktiv. Diese Dienstkontoschlüssel werden für den wiederhergestellten Cluster reaktiviert.

So stellen Sie einen Cluster wieder her:

  1. Führen Sie den entsprechenden Befehl aus, um den Cluster wiederherzustellen:

    Administratorcluster

    gkectl restore admin --backup-file BACKUP_FILE \
        --config ADMIN_CONFIG
    

    Ersetzen Sie Folgendes:

    • BACKUP_FILE: der Pfad und der Name der Sicherungsdatei, die Sie verwenden.

    • ADMIN_CONFIG: der Pfad zur Konfigurationsdatei des Administratorclusters.

    Nutzercluster

    gkectl restore cluster --cluster-name CLUSTER_NAME \
        --backup-file BACKUP_FILE \
        --kubeconfig ADMIN_KUBECONFIG
    

    Ersetzen Sie Folgendes:

    • CLUSTER_NAME: der Name des Clusters, den Sie wiederherstellen.

    • BACKUP_FILE: der Pfad und der Name der Sicherungsdatei, die Sie verwenden.

    • ADMIN_KUBECONFIG: der Pfad zur kubeconfig-Datei des Administratorclusters.

    Am Ende des Wiederherstellungsprozesses wird eine neue kubeconfig-Datei für den wiederhergestellten Cluster im Arbeitsbereichsverzeichnis gkectl-workspace generiert.

  2. Führen Sie nach Abschluss der Wiederherstellung den folgenden Befehl aus, um zu prüfen, ob sie erfolgreich war:

    gkectl diagnose cluster --cluster-name CLUSTER_NAME \
        --kubeconfig GENERATED_KUBECONFIG
    

    Ersetzen Sie GENERATED_KUBECONFIG durch die generierte kubeconfig-Datei.

Quorum wiederherstellen

Wenn zwei Knoten der Steuerungsebene in einem Cluster ausgefallen sind, können Sie den Befehl gkectl restore verwenden, um das Quorum wiederherzustellen. Wenn Sie das Quorum wiederherstellen, geben Sie anstelle der Sicherungsdatei für den Befehl gkectl restore die IP-Adresse des funktionierenden Knotens der Steuerungsebene an.

Bevor Sie den Befehl ausführen, müssen die folgenden Bedingungen erfüllt sein:

Führen Sie den entsprechenden Befehl für Ihren Clustertyp aus, um das Quorum wiederherzustellen:

Administratorcluster

gkectl restore admin --kubeconfig ADMIN_KUBECONFIG \
    --config ADMIN_CONFIG \
    --control-plane-node WORKING_NODE_IP \
    --ssh-key ADMIN_SSH_KEY_PATH

Ersetzen Sie Folgendes:

  • Ersetzen Sie dabei ADMIN_KUBECONFIG durch den Pfad der kubeconfig-Datei für den Administratorcluster.

  • ADMIN_CONFIG: der Pfad Ihrer Administratorcluster-Konfigurationsdatei.

  • WORKING_NODE_IP: die IP-Adresse des funktionierenden Knotens der Steuerungsebene.

  • ADMIN_SSH_KEY_PATH: der SSH-Schlüsselpfad des Administratorclusters.

Nutzercluster

gkectl restore cluster --cluster-name CLUSTER_NAME \
    --kubeconfig ADMIN_KUBECONFIG \
    --control-plane-node WORKING_NODE_IP \
    --ssh-key USER_SSH_KEY_PATH

Ersetzen Sie Folgendes:

  • CLUSTER_NAME: der Name des Clusters, den Sie wiederherstellen.

  • ADMIN_KUBECONFIG: der Pfad zur kubeconfig-Datei des Administratorclusters.

  • WORKING_NODE_IP: die IP-Adresse des funktionierenden Knotens der Steuerungsebene.

  • USER_SSH_KEY_PATH: der SSH-Schlüsselpfad des Nutzerclusters.

Fehlerbehebung

Wenn Sie Probleme mit dem Sichern oder Wiederherstellen haben, können Ihnen die folgenden Abschnitte bei der Fehlerbehebung helfen.

Wenn Sie weitere Unterstützung benötigen, wenden Sie sich an das Cloud Customer Care-Team.

Nicht genügend Arbeitsspeicher während einer Sicherung oder Wiederherstellung

Wenn die Workstation, auf der Sie den Befehl gkectl ausführen, nicht viel RAM hat, ist möglicherweise nicht genügend Arbeitsspeicher für die Sicherung oder Wiederherstellung verfügbar. Erstellen und verwenden Sie bei Bedarf eine temporäre Scratch Disk, um die Sicherungs- oder Wiederherstellungsvorgänge mit dem Parameter --use-disk im Sicherungsbefehl zu verarbeiten. Um die Dateiberechtigungen beizubehalten, werden mit diesem Parameter die Berechtigungen der Dateien geändert. Daher müssen Sie den Befehl als Root-Nutzer ausführen (oder sudo verwenden).

Aktualisierung des SSH-Schlüssels nach einer Sicherung bricht den Wiederherstellungsprozess ab

SSH-bezogene Vorgänge während der Wiederherstellung können fehlschlagen, wenn der SSH-Schlüssel nach der Sicherung aktualisiert wird. In diesem Fall ist der neue SSH-Schlüssel für die Wiederherstellung ungültig. Um dieses Problem zu beheben, können Sie den ursprünglichen SSH-Schlüssel vorübergehend wieder hinzufügen und dann die Wiederherstellung ausführen. Nach Abschluss der Wiederherstellung können Sie den SSH-Schlüssel rotieren.