Dar de baja un clúster

En esta página se describe cómo dar de baja manualmente un clúster de una flota. Google Cloud Cuando das de baja manualmente un clúster, se elimina su conexión con la flota, pero el clúster permanece. Si eliminas un clúster de GKE registrado en Google Cloud mediante la Google Cloud consola o gcloud CLI, también se eliminará la pertenencia a la flota del clúster.

Solo puedes dar de baja clústeres de GKE en Google Cloud y clústeres de terceros adjuntos. No se pueden anular el registro de otros tipos de clústeres.

Ten en cuenta que no se recomienda mover clústeres registrados entre flotas (es decir, anular el registro y volver a registrarlo), ya que puede provocar un comportamiento inesperado o no deseado. Por ejemplo, la identidad de carga de trabajo de la flota de tus cargas de trabajo cambiará, lo que puede provocar que se bloqueen solicitudes y se produzcan interrupciones. Lo recomendable es crear un clúster en la flota en la que quieras que residan tus cargas de trabajo y, a continuación, moverlas del clúster antiguo al nuevo.

Dar de baja un clúster

gcloud

Dar de baja un clúster de GKE

Este comando solo se puede usar para anular 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

Sustituye CLUSTER_NAME por el nombre del clúster que quieras eliminar.

Dar de baja un clúster de GKE (comando antiguo)

Si has registrado un clúster con el comando register anterior, ejecuta uno de los siguientes comandos para anular 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 el ID de tu proyecto Google Cloud . Consulta cómo encontrar este valor.
  • [MEMBERSHIP_NAME] es el nombre de la suscripción que corresponde a tu clúster. Para ver todas las suscripciones en el centro, ejecuta el siguiente comando: 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.

Dar de baja un clúster adjunto

Estas instrucciones se aplican a los clústeres registrados con la versión más reciente de nuestra función de clústeres adjuntos. Los clústeres adjuntos que usen la generación anterior obsoleta de esta función deben usar el comando antiguo de la siguiente sección.

Dar de baja un clúster adjunto (comando antiguo)

Si has registrado un clúster con la generación anterior de clústeres adjuntos, ejecuta el siguiente comando para anular su registro:

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

donde:

  • [PROJECT_ID] es el ID de tu proyecto Google Cloud . Consulta cómo encontrar este valor.
  • [MEMBERSHIP_NAME] es el nombre de la suscripción que corresponde a tu clúster. Para obtener una lista de todas las suscripciones del centro de control, ejecuta el siguiente comando: gcloud container fleet memberships list.
  • [KUBECONFIG_PATH] es la ruta local en la que se almacena tu archivo kubeconfig que contiene una entrada para el archivo del clúster. El valor predeterminado es $KUBECONFIG si se ha definido esa variable de entorno. De lo contrario, será $HOME/.kube/config.
  • [KUBECONFIG_CONTEXT] es el contexto del clúster tal y como aparece en el archivo kubeconfig. Para obtener este valor desde la línea de comandos, ejecuta kubectl config current-context.

Consola

Dar de baja un clúster de GKE en Google Cloud

Para dar de baja un clúster de GKE, sigue estos pasos:

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

    Ir a la página Clústeres de GKE

  2. Haga clic en Acciones junto al clúster de la lista que quiera anular el registro.

  3. En el menú Acciones, selecciona Anular registro.

  4. En el cuadro de diálogo que aparece, escribe el nombre del clúster y haz clic en Anular registro para confirmar la acción.

Dar de baja un clúster de terceros adjunto

Para dar de baja un clúster adjunto, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Resumen de clústeres de Google Kubernetes Engine.

    Ir a clústeres de GKE

  2. Selecciona el Google Cloud proyecto en el que se encuentra el clúster.

  3. Haz clic en el nombre del clúster que quieras separar y, a continuación, selecciona Ver más detalles en el panel lateral.

  4. En la parte superior de la ventana, haz clic en Eliminar.

  5. Cuando se te pida que confirmes la acción, introduce el nombre del clúster y haz clic en Confirm (Confirmar).

Terraform

Para anular el registro de un clúster de GKE que hayas registrado con Terraform, sigue estos pasos:

Elimina el siguiente bloque de la configuración del recurso google_container_cluster del clúster:

fleet {
      project = "FLEET_HOST_PROJECT""
    }

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

Gestionar el agente de Connect

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

Opcional: Comprueba que se haya eliminado el espacio de nombres del agente de Connect

Después de anular el registro de un clúster, puedes verificar que se ha eliminado el espacio de nombres que usa el agente de Connect. Esto se aplica a los registros que solo instalan el agente de Connect. Para ello, ejecuta el siguiente comando:

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

Si este comando no devuelve ningún resultado, significa que el espacio de nombres ya se ha eliminado.

Eliminar la cuenta de servicio del agente de Connect

Si has creado una cuenta de servicio para el agente de Connect, puedes eliminarla de la siguiente manera:

gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]

Dar de baja un clúster no disponible

Si quieres anular el registro de un clúster al que ya no puedes acceder, sigue estos pasos:

  1. Lista los clústeres (también conocidos como membresías) que están registrados actualmente:

    gcloud container fleet memberships list

    En la salida del comando, la columna Name muestra los nombres de los miembros de los clústeres registrados y la columna EXTERNAL_ID muestra los UIDs de los clústeres del espacio de nombres kube-system.

  2. Para anular el registro de un clúster no disponible, ejecuta el siguiente comando:

    gcloud container fleet memberships delete [MEMBERSHIP_NAME]

    donde [MEMBERSHIP_NAME] es el nombre del grupo de miembros que corresponde a tu clúster.