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. Si borras un clúster de GKE registrado en Google Cloud a través la consola de Google Cloud o gcloud CLI también se 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 pueden cancelar el registro de otros tipos de clústeres.

Ten en cuenta que 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

Estas instrucciones se aplican a los clústeres 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 obsoleta de esta función deben usar el comando heredado en la siguiente sección.

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

Si registraste un clúster con la generación anterior de clústeres conectados, ejecuta el siguiente comando para cancelar el registro:

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

Cancela el registro un clúster de GKE en Google Cloud

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

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

Ve a la página Clústeres de GKE
Haz clic en Acciones junto al clúster de la lista del que deseas cancelar el registro.
En el menú de acciones, selecciona Cancelar registro.
En el cuadro de diálogo que se muestra, escribe el nombre del clúster y haz clic en Cancelar registro para confirmar la acción.

Cancela el registro de un clúster de terceros conectado

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

En la consola de Google Cloud, ve a la página Descripción general de los clústeres de Google Kubernetes Engine.

Ir a los clústeres de GKE
Selecciona el proyecto de Google Cloud en el que se encuentra el clúster.
Haz clic en el nombre del clúster que deseas desconectar y, luego, selecciona View more details en el panel lateral.
Cerca de la parte superior de la ventana, haz clic en Borrar.
Cuando se te solicite confirmación, ingresa el nombre del clúster y haz clic en Confirmar.

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.