Nutzercluster löschen

Auf dieser Seite wird beschrieben, wie Sie einen Google Distributed Cloud-Nutzercluster löschen. Wenn Sie einen Nutzercluster löschen, wird er von der Flotte abgemeldet und die Arbeitslasten, Knotenpools, Steuerungsebenenknoten und die entsprechenden Ressourcen wie VMs, F5-Partitionen und Datenlaufwerke werden gelöscht.

Tool zum Löschen eines Clusters auswählen

Wie Sie einen Nutzercluster löschen, hängt davon ab, ob der Cluster in der GKE On-Prem API registriert ist. Ein Nutzercluster ist in der GKE On-Prem API registriert, wenn eine der folgenden Bedingungen zutrifft:

  • Der Cluster wurde mit der Google Cloud Console, der Google Cloud CLI (gcloud CLI) oder Terraform erstellt. Dadurch wird der Cluster automatisch in der GKE On-Prem API registriert. Diese Standardanwendungen werden zusammen als GKE On-Prem API-Clients bezeichnet.

  • Der Cluster wurde mit gkectl erstellt, aber er wurde in der GKE On-Prem API registriert.

Wenn der Cluster in der GKE On-Prem API registriert ist, verwenden Sie einen GKE On-Prem API-Client, um den Cluster zu löschen. Wenn der Cluster nicht in der GKE On-Prem API registriert ist, verwenden Sie gkectl auf der Administrator-Workstation, um den Cluster zu löschen.

Wenn Sie alle Nutzercluster ermitteln möchten, die in einem bestimmten Projekt in der GKE On-Prem API registriert sind, führen Sie den folgenden Befehl aus:

gcloud container vmware clusters list \
    --project=PROJECT_ID \
    --location=-

Die Ausgabe sieht in etwa so aus:

NAME                      LOCATION    VERSION             ADMIN_CLUSTER.            STATE
example-user-cluster-1a   us-west1    1.30.0-gke.1930    example-admin-cluster-1   RUNNING

Wenn Sie --location=- festlegen, bedeutet dies, dass alle Cluster in allen Regionen aufgelistet werden. Wenn Sie den Bereich in der Liste verkleinern möchten, können Sie --location auf eine bestimmte Region festlegen.

Wenn der Cluster aufgeführt ist, ist er in der GKE On-Prem API registriert. Wenn Sie kein Projektinhaber sind, benötigen Sie mindestens die IAM-Rolle roles/gkeonprem.admin für das Projekt, um registrierte Cluster zu löschen. Weitere Informationen zu den in dieser Rolle enthaltenen Berechtigungen finden Sie in der IAM-Dokumentation unter GKE On-Prem-Rollen.

Zustandsorientierte Arbeitslasten löschen

Bevor Sie Ihren Cluster löschen, müssen Sie Ihre zustandsorientierten Arbeitslasten, PVCs und PVs löschen. Führen Sie dazu kubectl delete aus.

Nutzercluster löschen

gkectl

Mit gkectl können Sie Cluster löschen, die nicht bei der GKE On-Prem API registriert sind. Wenn die Proxy- und Firewallregeln Ihrer Organisation den Traffic zu gkeonprem.googleapis.com und gkeonprem.mtls.googleapis.com (die Dienstnamen für die GKE On-Prem API) zulassen, kann gkectl registrierte Cluster löschen.

Führen Sie den folgenden Befehl auf der Administrator-Workstation aus, um den Cluster zu löschen:

gkectl delete cluster \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
  --cluster CLUSTER_NAME

Dabei gilt:

  • ADMIN_CLUSTER_KUBECONFIG ist der Pfad zur kubeconfig-Datei des Administratorclusters.
  • CLUSTER_NAME ist der Name des Nutzerclusters, den Sie löschen möchten.

Wenn das Löschen fehlschlägt und eine Meldung wie die folgende angezeigt wird:

Exit with error:
...
failed to unenroll user cluster CLUSTER_NAME
failed to create GKE On-Prem API client

Das bedeutet, dass der Cluster registriert ist, gkectl aber die GKE On-Prem API nicht erreichen konnte. In diesem Fall ist es am einfachsten, einen GKE On-Prem API-Client zu verwenden, um den Cluster zu löschen.

Wenn das Löschen des Nutzerclusters nicht vollständig abgeschlossen werden kann, können Sie gkectl mit dem Flag --force ausführen, um den Fehler bei 50 % zu ignorieren und mit dem Löschen fortzufahren.

gkectl delete cluster \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG \
--cluster CLUSTER_NAME \
--force

Wenn Sie den gebündelten Seesaw-Load-Balancer verwenden, löschen Sie den Load-Balancer.

Console

Wenn der Nutzercluster von der GKE On-Prem API verwaltet wird, führen Sie die folgenden Schritte aus, um den Cluster zu löschen:

  1. Rufen Sie in der Console die Seite Google Kubernetes Engine-Cluster – Übersicht auf.

    Zu GKE-Clustern

  2. Wählen Sie das Google Cloud-Projekt aus, in dem sich der Nutzercluster befindet.

  3. Suchen Sie in der Liste der Cluster den Cluster, den Sie löschen möchten. Wenn der Typ auf extern eingestellt ist, bedeutet dies, dass der Cluster mit gkectl erstellt und nicht in der GKE On-Prem API registriert wurde. Führen Sie in diesem Fall die Schritte auf dem Tab gkectl aus, um den Cluster zu löschen.

    Wenn das Symbol in der Spalte Status auf ein Problem hinweist, folgen Sie der Anleitung auf dem Tab „gcloud CLI“, um den Cluster zu löschen. Sie müssen dem Befehl zum Löschen das Flag --ignore-errors hinzufügen.

  4. Klicken Sie auf den Namen des Clusters, den Sie löschen möchten.

  5. Klicken Sie oben im Fenster im Bereich Details auf Löschen.

  6. Wenn Sie zur Bestätigung aufgefordert werden, geben Sie den Namen des Clusters ein und klicken Sie auf Entfernen.

gcloud-CLI

Wenn der Nutzercluster von der GKE On-Prem API verwaltet wird, führen Sie die folgenden Schritte auf einem Computer aus, auf dem die gcloud CLI installiert ist:

  1. Aktualisieren Sie die Komponenten:

    gcloud components update

  2. Verwenden Sie den folgenden Befehl, um das Cluster zu löschen:

    gcloud container vmware clusters delete USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --force \
  --allow-missing

    Ersetzen Sie Folgendes:

    • USER_CLUSTER_NAME: Name des Nutzerclusters, der gelöscht werden soll.

    • PROJECT_ID: die ID des Projekts, bei dem der Cluster registriert ist.

    • LOCATION: Der Google Cloud-Standort, der mit dem Nutzercluster verknüpft ist.

    Mit dem Flag --force können Sie einen Cluster mit Knotenpools löschen. Ohne das --force-Flag müssen Sie zuerst die Knotenpools löschen und dann den Cluster.

    Das --allow-missing-Flag ist ein Standard-Google API-Flag. Wenn Sie dieses Flag angeben, gibt der Befehl den Wert „Erfolg“ zurück, wenn der Cluster nicht gefunden wird.

    Wenn der Befehl einen Fehler zurückgibt, der den Text failed connecting to the cluster's control plane enthält, weist dies auf Verbindungsprobleme mit dem Admin-Cluster, dem Connect-Agent oder der lokalen Umgebung hin.

    • Wenn Sie glauben, dass das Verbindungsproblem vorübergehend ist, z. B. aufgrund von Netzwerkproblemen, warten Sie und versuchen Sie den Befehl noch einmal.

    • Wenn der Befehl auch beim erneuten Ausführen fehlschlägt, lesen Sie den Hilfeartikel Connect-Agent-Logs erfassen, um Probleme mit dem Connect-Agent zu beheben.

    • Wenn Sie wissen, dass der Administratorcluster gelöscht wurde oder die VMs für den Administrator- oder Nutzercluster heruntergefahren wurden oder anderweitig nicht zugänglich sind, fügen Sie das Flag --ignore-errors hinzu und versuchen Sie den Befehl noch einmal.

Informationen zu anderen Flags finden Sie in der Referenz zur gcloud CLI.

Ressourcen bereinigen

Wenn beim Löschen des Clusters Probleme aufgetreten sind, sind möglicherweise einige F5- oder vSphere-Ressourcen übrig. In den folgenden Abschnitten wird erläutert, wie Sie diese verbleibenden Ressourcen bereinigen.

VMs eines Nutzerclusters in vSphere bereinigen

Führen Sie die folgenden Schritte aus, um zu prüfen, ob die VMs des Nutzerclusters gelöscht wurden:

  1. Klicken Sie im linken Navigator-Menü des vSphere-Webclients auf das Menü Hosts und Cluster.

  2. Suchen Sie den Ressourcenpool für Ihren Administratorcluster. Dies ist der Wert von vCenter.resourcePool in der Konfigurationsdatei des Administratorclusters.

  3. Suchen Sie unter dem Ressourcenpool nach VMs, denen der Name Ihres Nutzerclusters vorangestellt ist. Dies sind die Knoten der Steuerungsebene für Ihren Nutzercluster. Es gibt eine oder drei davon, je nachdem, ob Ihr Nutzercluster eine hochverfügbare Steuerungsebene hat.

  4. Suchen Sie den Ressourcenpool für Ihren Nutzercluster. Dies ist der Wert von vCenter.resourcePool in der Konfigurationsdatei des Nutzerclusters. Wenn in der Konfigurationsdatei des Nutzerclusters kein Ressourcenpool angegeben ist, wird er vom Administratorcluster übernommen.

  5. Suchen Sie unter dem Ressourcenpool nach VMs, denen der Name eines Knotenpools in Ihrem Nutzercluster vorangestellt ist. Dies sind die Worker-Knoten in Ihrem Nutzercluster.

  6. Für jeden Steuerungsebenenknoten und jeden Worker-Knoten:

    1. Klicken Sie im vSphere-Webclient mit der rechten Maustaste auf die VM und wählen Sie Einschalten > Ausschalten aus.

    2. Schalten Sie die VM aus, klicken Sie mit der rechten Maustaste auf die VM und wählen Sie Delete from Disk aus.

F5-Partition eines Nutzerclusters bereinigen

Wenn noch Einträge in der Partition des Nutzerclusters vorhanden sind, führen Sie die folgenden Schritte aus:

  1. Wechseln Sie in der F5 BIG-IP-Konsole in der oberen rechten Ecke der Konsole zur Nutzerclusterpartition, die Sie bereinigen möchten.
  2. Wählen Sie Local Traffic > Virtual Servers > Virtual Server List aus.
  3. Im Menü Virtual Servers entfernen Sie alle virtuellen IP-Adressen.
  4. Wählen Sie Pools aus und löschen Sie dann alle Pools.
  5. Wählen Sie Knoten aus und löschen Sie dann alle Knoten.

Wenn Sie fertig sind

Nachdem der Cluster gelöscht wurde, können Sie die kubeconfig des Nutzerclusters löschen.