Cancelar el registro de un clúster

En esta página se describe cómo cancelar el registro de un clúster en una flota de Google Cloud de forma manual. Cuando cancelas el registro de un clúster de forma manual, se quita su conexión con la flota, pero el clúster permanece. Borrar un clúster de GKE registrado con la consola de Google Cloud o gcloud CLI también borra la membresía de la flota del clúster.

Puedes cancelar el registro de clústeres de GKE en Google Cloud y en clústeres de terceros conectados únicamente. No se puede anular el registro de otros tipos de clústeres.

Ten en cuenta que, por el momento, no se recomienda mover clústeres registrados entre flotas (anular el registro y, luego, volver a registrarlo), ya que puede dar como resultado un comportamiento inesperado o no deseado, por ejemplo, Workload Identity de la flota de tus cargas de trabajo cambiará, lo que podría provocar interrupciones y solicitudes bloqueadas. El enfoque recomendado es crear un clúster nuevo en la flota, en el que deseas que residan las cargas de trabajo y, luego, mover las cargas de trabajo del clúster anterior al nuevo.

Cancela el registro de un clúster

gcloud

Cancela el registro de un clúster de GKE

Este comando solo se puede usar para cancelar el registro de clústeres de GKE registrados con gcloud container clusters update o gcloud container clusters create.

Ejecuta el siguiente comando:

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

Reemplaza CLUSTER_NAME por el nombre del clúster que deseas borrar.

Cancela el registro de un clúster de GKE (comando heredado)

Si registraste un clúster con el comando register anterior, ejecuta cualquiera de los siguientes comandos para cancelar el registro:

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]

Donde:

[PROJECT_ID] es tu ID del proyecto de Google Cloud. Obtén más información para encontrar este valor.
[MEMBERSHIP_NAME] es el nombre de la membresía que corresponde a tu clúster. Para enumerar todas las membresías del concentrador, ejecuta: gcloud container fleet memberships list.
[GKE_URI] es el URI del clúster de GKE, por ejemplo: “https://container.googleapis.com/projects/my-project/locations/us-central1-a/clusters/my-cluster”. Para obtener el URI, ejecuta gcloud container clusters list --uri. El URI proporcionado se validará para confirmar que se asigna al clúster de GKE válido.
[GKE_CLUSTER] es el location/name del clúster de GKE. La ubicación puede ser una zona o una región, por ejemplo: us-central1-a/my-cluster.

Cancela el registro de un clúster conectado de EKS o AKS

Estas instrucciones se aplican a los clústeres de Amazon EKS y Azure AKS registrados con la versión más reciente de nuestra función de clústeres conectados. Los clústeres conectados con la generación anterior de esta función deben seguir las instrucciones de la siguiente sección.

Cancela el registro de cualquier otro tipo de clúster conectado

Ejecuta el siguiente comando:

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

Donde:

[PROJECT_ID] es tu ID del proyecto de Google Cloud. Obtén más información para encontrar este valor.
[MEMBERSHIP_NAME] es el nombre de la membresía que corresponde a tu clúster. Para obtener una lista de todas las membresías en el concentrador, ejecuta gcloud container fleet memberships list.
[KUBECONFIG_PATH] es la ruta local en la que se almacena el kubeconfig que contiene una entrada para el archivo del clúster. El valor predeterminado es $KUBECONFIG si esa variable de entorno está configurada, de lo contrario, el valor predeterminado será $HOME/.kube/config.
[KUBECONFIG_CONTEXT] es el contexto del clúster tal como aparece en el archivo de kubeconfig. Puedes obtener este valor desde la línea de comandos si ejecutas kubectl config current-context.

Console

Puedes cancelar el registro de clústeres en la consola de Google Cloud solo con la consola heredada de GKE Enterprise. No se admite la cancelación del registro desde la consola de GKE.

Cancela el registro de un clúster de GKE

Para cancelar el registro de un clúster de GKE, haz lo siguiente:

Ve a la página Clústeres de GKE Enterprise En esta página, se muestran todos los clústeres registrados.

Ve a la página de clústeres de GKE Enterprise
Selecciona el clúster cuyo registro deseas cancelar en la lista. Aparecerá un panel de detalles.
En el panel de detalles, haz clic en Cancelar registro.
En el cuadro de diálogo que se muestra, vuelve a hacer clic en Cancelar registro para confirmar la acción.

Cancela el registro de cualquier otro tipo de clúster

Para cancelar el registro de cualquier otro clúster de flota, sigue estos pasos:

En la consola de Google Cloud, ve a la página de clústeres de GKE.

Ir a los clústeres de GKE
En la lista de clústeres, haz clic en Acciones junto al clúster registrado y, luego, en Acceder.
En el cuadro de diálogo que se muestra, vuelve a hacer clic en Cancelar el registro para confirmar la acción.

Terraform

Para cancelar el registro de un clúster de GKE que registraste con Terraform, ejecuta el siguiente comando:

Borra el siguiente bloque de la configuración de recursos google_container_cluster del clúster:

fleet {
      project = "FLEET_HOST_PROJECT""
    }

FLEET_HOST_PROJECT es el ID del proyecto de Google Cloud en el que está registrado tu clúster.

Cómo administrar Connect Agent

Los siguientes pasos se aplican solo a la cancelación del registro de clústeres conectados, en los que Connect Agent se instala en el clúster como parte del registro.

Verifica que se borre el espacio de nombres de Connect Agent (opcional)

Después de cancelar el registro de un clúster, puedes verificar que se haya borrado el espacio de nombres que usa el agente de Connect. Esto se aplica solo a los registros que instalan el agente de Connect. Para realizar esta acción debes ejecutar lo siguiente:

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

Si este comando no muestra ningún resultado, el espacio de nombres ya se borró.

Borra la cuenta de servicio de Connect Agent

Si creaste una cuenta de servicio para el agente de Connect, puedes borrarla de la siguiente manera:

gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]

Cancela el registro de un clúster no disponible

Si deseas cancelar el registro de un clúster al que ya no tienes acceso, sigue estos pasos:

Enumera los clústeres (es decir, las membresías) que estén registrados actualmente:
```
gcloud container fleet memberships list
```
En el resultado del comando, la columna Name enumera los nombres de la membresía de los clústeres registrados y la columna EXTERNAL_ID enumera los UID de los clústeres del espacio de nombres de kube-system.
Para cancelar el registro de un clúster no disponible, ejecuta el siguiente comando:
```
gcloud container fleet memberships delete [MEMBERSHIP_NAME]
```
En el ejemplo anterior, [MEMBERSHIP_NAME] es el nombre de la membresía que corresponde a tu clúster.