Registrierung eines Clusters aufheben

Auf dieser Seite wird beschrieben, wie Sie die Registrierung eines Clusters manuell von einer Google Cloud-Flotte aufheben. Wenn Sie die Registrierung eines Clusters manuell aufheben, wird die Verbindung zur Gruppe entfernt, der Cluster bleibt jedoch bestehen. Beim Löschen eines registrierten GKE-Clusters in Google Cloud mithilfe der Google Cloud Console oder der gcloud CLI wird auch die Flottenmitgliedschaft des Clusters gelöscht.

Sie können die Registrierung von GKE-Clustern in Google Cloud und von angehängten Drittanbieterclustern aufheben. Andere Clustertypen können nicht abgemeldet werden.

Das Verschieben registrierter Cluster zwischen Flotten (Abmeldung und Neuregistrierung) wird derzeit nicht empfohlen, da dies zu unerwartetem oder unerwünschtem Verhalten führen kann. So könnte sich beispielsweise die Workload Identity Ihrer Arbeitslasten ändern, was zur Blockierung von Anfragen oder Ausfällen führen kann. Der empfohlene Ansatz besteht darin, einen neuen Cluster in der Flotte zu erstellen, in dem sich Ihre Arbeitslasten befinden sollen, und dann Ihre Arbeitslasten aus dem alten Cluster in den neuen Cluster verschieben.

Cluster abmelden

gcloud

Registrierung eines GKE-Clusters aufheben

Dieser Befehl kann nur verwendet werden, um die Registrierung von GKE-Clustern aufzuheben, die mit gcloud container clusters update oder gcloud container clusters create registriert wurden.

Führen Sie dazu diesen Befehl aus:

gcloud container clusters update CLUSTER_NAME --clear-fleet-project

Ersetzen Sie CLUSTER_NAME durch den Namen des Clusters, den Sie löschen möchten.

Registrierung eines GKE-Clusters aufheben (Legacy-Befehl)

Wenn Sie einen Cluster mit dem älteren Befehl register registriert haben, führen Sie einen der folgenden Befehle aus, um die Registrierung aufzuheben:

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-uri=[GKE_URI]

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-cluster=[GKE_CLUSTER]

Dabei gilt:

[PROJECT_ID] ist Ihre Google Cloud-Projekt-ID. Informationen zum Ermitteln dieses Werts
[MEMBERSHIP_NAME] ist der Mitgliedschaftsname, der dem Namen Ihres Clusters entspricht. Zum Auflisten aller Mitgliedschaften auf dem Hub, führen Sie gcloud container fleet memberships list aus.
[GKE_URI] ist der URI des GKE-Clusters. Beispiel: "https://container.googleapis.com/projects/my-project/locations/us-central1-a/clusters/my-cluster". Sie können den URI durch Ausführen von gcloud container clusters list --uri abrufen. Der angegebene URI wird validiert, um zu bestätigen, dass er dem gültigen GKE-Cluster zugeordnet wird.
[GKE_CLUSTER] ist der location/name des GKE-Clusters. Der Speicherort kann eine Zone oder Region sein, z. B. us-central1-a/my-cluster.

Registrierung eines angehängten Clusters aufheben

Diese Anleitung gilt für Cluster, die mit der aktuellen Version unseres Features für angehängte Cluster registriert wurden. Cluster, die mit der verworfenen vorherigen Generation dieses Features angehängt wurden, sollten den Legacy-Befehl im nächsten Abschnitt verwenden.

Registrierung eines angehängten Clusters aufheben (Legacy-Befehl)

Wenn Sie einen Cluster mit der vorherigen Generation von angehängten Clustern registriert haben, führen Sie folgenden Befehl aus, um die Registrierung aufzuheben:

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --context=[KUBECONFIG_CONTEXT] \
   --kubeconfig=[KUBECONFIG_PATH]

Dabei gilt:

[PROJECT_ID] ist Ihre Google Cloud-Projekt-ID. Informationen zum Ermitteln dieses Werts
[MEMBERSHIP_NAME] ist der Mitgliedschaftsname, der dem Namen Ihres Clusters entspricht. Mit folgendem Befehl können Sie eine Liste aller Mitgliedschaften auf dem Hub abrufen: gcloud container fleet memberships list.
[KUBECONFIG_PATH] ist der lokale Pfad, in dem die Datei "kubeconfig" mit einem Eintrag für die Clusterdatei gespeichert ist. Dies ist der Standardwert $KUBECONFIG, wenn diese Umgebungsvariable gesetzt ist; andernfalls ist dies der Standardwert für $HOME/.kube/config.
[KUBECONFIG_CONTEXT] der Kontext des Clusters ist, wie er in der "kubeconfig"-Datei angezeigt wird. Sie erhalten diesen Wert über die Befehlszeile, indem Sie kubectl config current-context ausführen.

Console

Registrierung eines GKE-Clusters in Google Cloud aufheben

So heben Sie die Registrierung eines GKE-Clusters auf:

Zur GKE-Clusterseite. Auf dieser Seite werden alle Ihre Cluster angezeigt.

Zur GKE-Clusterseite.
Klicken Sie in der Liste neben dem Cluster, von dem Sie die Registrierung aufheben möchten, auf Aktionen.
Wählen Sie im Menü „Aktionen“ die Option Registrierung aufheben aus.
Geben Sie im angezeigten Dialogfeld den Namen des Clusters ein und klicken Sie auf Registrierung aufheben, um die Aktion zu bestätigen.

Registrierung eines angehängten Drittanbieterclusters aufheben

So heben Sie die Registrierung eines angehängten Clusters auf:

Rufen Sie in der Google Cloud Console die Seite Google Kubernetes Engine-Cluster auf.

Zu GKE-Clustern
Wählen Sie das Google Cloud-Projekt aus, in dem sich der Cluster befindet.
Klicken Sie auf den Namen des Clusters, den Sie trennen möchten, und wählen Sie dann in der Seitenleiste Weitere Details anzeigen aus.
Klicken Sie oben im Fenster auf Löschen.
Wenn Sie zur Bestätigung aufgefordert werden, geben Sie den Namen des Clusters ein und klicken Sie auf Bestätigen.

Terraform

So heben Sie die Registrierung eines GKE-Clusters auf, den Sie mit Terraform registriert haben:

Löschen Sie den folgenden Block aus der Ressourcenkonfiguration google_container_cluster des Clusters:

fleet {
      project = "FLEET_HOST_PROJECT""
    }

FLEET_HOST_PROJECT ist die Google Cloud-Projekt-ID, bei der Ihr Cluster registriert ist.

Connect-Agent verwalten

Die folgenden Schritte gelten nur für die Aufhebung der Registrierung angehängter Cluster, bei denen der Connect Agent als Teil der Registrierung auf dem Cluster installiert wird.

Optional: Prüfen Sie, ob der Connect Agent-Namespace gelöscht wurde.

Nachdem Sie die Registrierung eines Clusters aufgehoben haben, können Sie überprüfen, ob der vom Connect Agent verwendete Namespace gelöscht wurde. Dies gilt nur für Registrierungen, die nur den Connect-Agent installieren. Führen Sie dazu den folgenden Befehl aus:

kubectl get ns -l hub.gke.io/project

Wenn dieser Befehl keine Ausgabe zurückgibt, wurde der Namespace bereits gelöscht.

Connect-Agent-Dienstkonto löschen

Wenn Sie ein Dienstkonto für den Connect Agent erstellt haben, können Sie es so löschen:

gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]

Registrierung für Nicht verfügbaren Cluster aufheben

Wenn Sie die Registrierung eines Clusters aufheben möchten, auf den Sie nicht mehr zugreifen können, führen Sie die folgenden Schritte aus:

Listen Sie die Cluster (alias Mitgliedschaften) auf, die bereits registriert sind:
```
gcloud container fleet memberships list
```
In der Befehlsausgabe listet die Spalte Name die Mitgliedschaftsnamen registrierter Cluster auf und in der Spalte EXTERNAL_ID werden die UIDs der Cluster des Namespace kube-system aufgelistet.
Führen Sie den folgenden Befehl aus, um die Registrierung eines nicht verfügbaren Clusters aufzuheben:
```
gcloud container fleet memberships delete [MEMBERSHIP_NAME]
```
[MEMBERSHIP_NAME] ist der Mitgliedschaftsname, der dem Namen Ihres Clusters entspricht.