Nutzercluster löschen

Auf dieser Seite wird beschrieben, wie Sie einen Nutzercluster von GKE on VMware löschen. Durch das Löschen von Nutzerclustern wird der Cluster von der Flotte abgemeldet und die Arbeitslasten, Knotenpools, Knoten der Steuerungsebene 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 bei der GKE On-Prem API registriert ist. Ein Nutzercluster wird 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, die den Cluster automatisch in der GKE On-Prem API registriert. Zusammen werden diese Standardanwendungen als GKE On-Prem API-Clients bezeichnet.

  • Der Cluster wurde mit gkectl erstellt, aber 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 Administratorworkstation, um den Cluster zu löschen.

Führen Sie den folgenden Befehl aus, um alle Nutzercluster zu finden, die in einem bestimmten Projekt in der GKE On-Prem API registriert sind:

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

Wenn Sie --location=- festlegen, werden alle Cluster in allen Regionen aufgelistet. Wenn Sie die Liste eingrenzen müssen, können Sie --location auf eine bestimmte Region festlegen.

Wenn der Cluster aufgeführt ist, ist er bei der GKE On-Prem API registriert. Wenn Sie kein Projektinhaber sind, benötigen Sie zum Löschen registrierter Cluster mindestens die Rolle roles/gkeonprem.admin für Identity and Access Management für das Projekt. Ausführliche Informationen zu den Berechtigungen, die in dieser Rolle enthalten sind, finden Sie in der IAM-Dokumentation unter GKE On-Prem API-Rollen.

Zustandsorientierte Arbeitslasten löschen

Löschen Sie vor dem Löschen des Clusters die zustandsorientierten Arbeitslasten, PVCs und PVs mit dem Befehl kubectl delete.

Nutzercluster löschen

gkectl

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

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

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

Wobei Folgendes 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 beim Löschen ein Fehler mit einer Meldung wie der folgenden 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, aber gkectl die GKE On-Prem API nicht erreichen konnte. In diesem Fall ist es am einfachsten, den Cluster mit einem GKE On-Prem API-Client zu löschen.

Wenn das Löschen des Nutzerclusters zur Hälfte fehlschlägt, können Sie gkectl mit dem Flag --force ausführen, um den Fehler bis zur Hälfte 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 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 external ist, bedeutet dies, dass der Cluster mit gkectl erstellt wurde und nicht in der GKE On-Prem API registriert war. 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 der gcloud CLI, um den Cluster zu löschen. Sie müssen dem Löschbefehl das Flag --ignore-errors hinzufügen.

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

  5. Klicken Sie im Feld Details oben im Fenster 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 auf einem Computer, auf dem die gcloud CLI installiert ist, folgende Schritte aus:

  1. Aktualisieren Sie die Komponenten:

    gcloud components update
    
  2. Rufen Sie eine Liste der Cluster ab, damit Sie im Löschbefehl den richtigen Clusternamen angeben:

    gcloud container vmware clusters list \
      --project=FLEET_HOST_PROJECT_ID \
      --location=LOCATION
    

    Ersetzen Sie Folgendes:

    • FLEET_HOST_PROJECT_ID: Die ID des Projekts, für das der Cluster registriert ist.

    • LOCATION: Der Google Cloud-Standort, der dem Nutzercluster zugeordnet ist.

    Die Ausgabe sieht in etwa so aus:

    NAME                      LOCATION    VERSION          ADMIN_CLUSTER.            STATE
    example-user-cluster-1a   us-west1    1.28.300-gke.123    example-admin-cluster-1   RUNNING
    
  3. Löschen Sie den Cluster mit dem folgenden Befehl:

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

    Ersetzen Sie Folgendes:

    • USER_CLUSTER_NAME: Der Name des zu löschenden Nutzerclusters.

    • FLEET_HOST_PROJECT_ID: Die ID des Projekts, für das der Cluster registriert ist.

    • LOCATION: Der Google Cloud-Standort, der dem Nutzercluster zugeordnet ist.

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

    Das Flag --allow-missing ist ein Google API-Standard-Flag. Wenn Sie dieses Flag einfügen, gibt der Befehl einen Erfolg zurück, wenn der Cluster nicht gefunden wurde.

    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 Administratorcluster, 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 wiederholen Sie den Befehl.

    • Wenn die Wiederholung des Befehls weiterhin fehlschlägt, finden Sie unter Connect-Agent-Logs erfassen weitere Informationen zur Fehlerbehebung.

    • Wenn Sie wissen, dass der Administratorcluster gelöscht wurde, oder wenn die VMs für den Administrator oder den Nutzercluster heruntergefahren wurden oder aus anderen Gründen nicht zugänglich sind, fügen Sie das Flag --ignore-errors ein und wiederholen Sie den Befehl.

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 mit dem Präfix des Namens Ihres Nutzerclusters. Dies sind die Knoten der Steuerungsebene für Ihren Nutzercluster. Es wird ein oder drei dieser Optionen angezeigt, je nachdem, ob Ihr Nutzercluster eine Steuerungsebene mit Hochverfügbarkeit 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 mit dem Präfix des Namens eines Knotenpools in Ihrem Nutzercluster. Dies sind die Worker-Knoten in Ihrem Nutzercluster.

  6. Für jeden Knoten der Steuerungsebene und jeden Worker-Knoten:

    1. Klicken Sie im vSphere-Webclient mit der rechten Maustaste auf die VM und wählen Sie Power > Power Off 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.