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 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 (Abmelden, Anmelden 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 zu blockierten Anfragen und 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 mit EKS oder AKS angehängten Clusters aufheben

Diese Anleitung gilt für Amazon EKS- und Azure AKS-Cluster, die mit der neuesten Version unseres Features für angehängte Cluster registriert sind. Cluster, die mit der vorherigen Generation dieses Features angehängt wurden, sollten der Anleitung im nächsten Abschnitt folgen.

Registrierung anderer angehängter Clustertypen aufheben

Führen Sie dazu diesen Befehl aus:

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

wobei

[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

Sie können die Registrierung von Clustern in der Google Cloud Console nur über die Legacy GKE Enterprise Console aufheben. Das Aufheben der Registrierung von der GKE-Konsole wird nicht unterstützt.

Registrierung eines GKE-Clusters aufheben

So heben Sie die Registrierung eines GKE-Clusters auf:

Rufen Sie die Seite GKE Enterprise-Cluster auf. Auf dieser Seite werden alle registrierten Cluster angezeigt.

Zur GKE Enterprise-Clusterseite
Wählen Sie den Cluster aus, von dem Sie die Registrierung aufheben möchten. Ein Detailbereich wird angezeigt.
Klicken Sie im Detailbereich auf Registrierung aufheben.
Klicken Sie im angezeigten Dialogfeld noch einmal auf Registrierung aufheben, um die Aktion zu bestätigen.

Registrierung anderer Clustertypen aufheben

So heben Sie die Registrierung eines anderen Flottenclusters auf:

Öffnen Sie in der Google Cloud Console die Seite zu den GKE-Clustern.

Zu GKE-Clustern
Klicken Sie in der Liste der Cluster neben dem registrierten Cluster auf Aktionen und dann auf Anmelden.
Klicken Sie im angezeigten Dialogfeld noch einmal auf Registrierung aufheben, um die Aktion zu 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.