Nutzercluster löschen

Auf dieser Seite wird beschrieben, wie Sie einen Google Distributed Cloud-Nutzercluster 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 ist bei 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, wodurch der Cluster automatisch in der GKE On-Prem API registriert wird. 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 bei 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 bei 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 ermitteln, die in der GKE On-Prem API in einem bestimmten Projekt 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 für --location eine bestimmte Region festlegen.

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

Zustandsorientierte Arbeitslasten löschen

Löschen Sie vor dem Löschen des Clusters die zustandsorientierten Arbeitslasten, PVCs und PVs, indem Sie kubectl delete ausführen.

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 es Traffic erlauben, gkeonprem.googleapis.com und gkeonprem.mtls.googleapis.com (die Dienstnamen für die GKE On-Prem API) zu erreichen, 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 der Löschvorgang fehlschlägt, wird eine Meldung wie diese angezeigt:

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 halben Fehler 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 ihn zu löschen:

  1. Rufen Sie in der Console die Übersichtsseite für 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 und nicht bei 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, führen Sie die Schritte auf dem Tab „gcloud CLI“ aus, 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 oben im Fenster 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 auf einem Computer, auf dem die gcloud CLI installiert ist, die folgenden Schritte aus:

  1. Aktualisieren Sie die Komponenten:

    gcloud components update
    
  2. Rufen Sie eine Liste der Cluster ab, um sicherzustellen, dass 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.29.100-gke.248    example-admin-cluster-1   RUNNING
    
  3. Verwenden Sie den folgenden Befehl, um den Cluster zu löschen:

    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 Nutzerclusters, der gelöscht werden soll.

    • 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 löschen, der Knotenpools hat. 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 hinzufügen, gibt der Befehl 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 Administratorcluster, dem Connect-Agent oder der lokalen Umgebung hin.

    • Wenn Sie den Eindruck haben, dass das Verbindungsproblem vorübergehend ist, z. B. aufgrund von Netzwerkproblemen, warten Sie und wiederholen Sie den Befehl.

    • Wenn das Wiederholen des Befehls weiterhin fehlschlägt, lesen Sie Connect-Agent-Logs erfassen, um Probleme mit dem Connect-Agent zu beheben.

    • Wenn Sie wissen, dass der Administratorcluster gelöscht wurde, oder wenn die VMs für den Administrator oder den Nutzercluster heruntergefahren wurden oder anderweitig nicht zugänglich sind, fügen Sie das Flag --ignore-errors hinzu 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 Namen Ihres Nutzerclusters. Dies sind die Knoten der Steuerungsebene für Ihren Nutzercluster. Es gibt eine oder drei davon, 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 Ihrer Nutzercluster-Konfigurationsdatei kein Ressourcenpool angegeben ist, wird sie vom Administratorcluster übernommen.

  5. Suchen Sie unter dem Ressourcenpool nach VMs mit dem Namen 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-Datei des Nutzerclusters löschen.