Borrar un clúster de usuarios

En esta página, se describe cómo borrar un clúster de usuarios de Google Distributed Cloud. Cuando se borra un clúster de usuario, se anula su registro en la flota y se borran las cargas de trabajo, los grupos de nodos, los nodos del plano de control y los recursos correspondientes, como las VMs, las particiones de F5 y los discos de datos.

Elige una herramienta para borrar un clúster

Si creaste el clúster con enableAdvancedCluster establecido en true (lo que se requiere para configurar dominios de topología), debes usar gkectl para borrar el clúster.

De lo contrario, la forma en que borras un clúster de usuario depende de si el clúster está inscrito en la API de GKE On-Prem. Un clúster de usuario está inscrito en la API de GKE On-Prem si se cumple una de las siguientes condiciones:

• El clúster se creó con la Google Cloud consola, Google Cloud CLI (gcloud CLI) o Terraform, que inscribe automáticamente el clúster en la API de GKE On-Prem. En conjunto, estas herramientas se denominan clientes de la API de GKE On-Prem.

• El clúster se creó con gkectl, pero se inscribió en la API de GKE On-Prem.

Si el clúster está inscrito en la API de GKE On-Prem, usa un cliente de la API de GKE On-Prem para borrar el clúster. Si el clúster no está inscrito en la API de GKE On-Prem, usa gkectl en la estación de trabajo de administrador para borrar el clúster.

Para encontrar todos los clústeres de usuario inscritos en la API de GKE On-Prem en un proyecto específico, ejecuta el siguiente comando:

gcloud container vmware clusters list \
    --project=PROJECT_ID \
    --location=-

El resultado es similar a este:

NAME                      LOCATION    VERSION             ADMIN_CLUSTER.            STATE
example-user-cluster-1a   us-west1    1.33.100-gke.89    example-admin-cluster-1   RUNNING

Cuando configuras --location=-, significa que se deben enumerar todos los clústeres en todas las regiones. Si necesitas reducir el alcance de la lista, puedes configurar --location en una región específica.

Si el clúster aparece en la lista, significa que está inscrito en la API de GKE On-Prem. Si no eres propietario de un proyecto, como mínimo, se te debe otorgar el rol de Identity and Access Management roles/gkeonprem.admin en el proyecto para borrar los clústeres inscritos. Para obtener más detalles sobre los permisos incluidos en este rol, consulta Roles de la API de GKE On-Prem en la documentación de IAM.

Si usas gkectl para borrar un clúster, asegúrate de que tu estación de trabajo del administrador tenga la versión necesaria de gkectl. Por lo general, se usa la misma versión de gkectl que la del clúster que se borrará. Durante el borrado, se aplican las siguientes reglas de versiones:

• La versión secundaria gkectl no puede ser inferior a la versión secundaria del clúster. Por ejemplo, no se permite borrar un clúster de la versión 1.30 con la versión 1.29 de gkectl. Las versiones de parche no son importantes. Por ejemplo, puedes usar la versión 1.29.0-gke.1456 de gkectl para borrar un clúster con una versión de parche superior, como 1.29.1000-gke.94.

• La versión secundaria gkectl no puede ser más de dos versiones secundarias superior a la versión del clúster. Por ejemplo, si borras un clúster 1.28, la versión de gkectl puede ser 1.29 o 1.30. Sin embargo, no puedes usar la versión 1.31 de gkectl porque es tres versiones secundarias superior a la versión del clúster.

Si es necesario, consulta Descarga gkectl para obtener una versión compatible de gkectl.

Borra cargas de trabajo con estado

Antes de borrar el clúster, borra tus cargas de trabajo con estado, PVC y PV ejecutando kubectl delete.

Borrar un clúster de usuario

gkectl

Puedes usar gkectl para borrar clústeres que no estén inscritos en la API de GKE On-Prem. Si las reglas de proxy y firewall de tu organización permiten que el tráfico llegue a gkeonprem.googleapis.com y gkeonprem.mtls.googleapis.com (los nombres de servicio de la API de GKE On-Prem), gkectl podrá borrar los clústeres inscritos.

Ejecuta el siguiente comando en la estación de trabajo de administrador para borrar el clúster:

gkectl delete cluster \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
  --cluster CLUSTER_NAME 

donde

• ADMIN_CLUSTER_KUBECONFIG es la ruta de acceso al archivo kubeconfig del clúster de administrador.
• CLUSTER_NAME es el nombre del clúster de usuario que deseas borrar.

Si la eliminación falla y aparece un mensaje similar al siguiente:

Exit with error:
...
failed to unenroll user cluster CLUSTER_NAME
failed to create GKE On-Prem API client

Esto significa que el clúster está inscrito, pero gkectl no pudo acceder a la API de GKE On-Prem. En este caso, lo más sencillo es usar un cliente de la API de GKE On-Prem para borrar el clúster.

Si la eliminación del clúster de usuario falla a mitad del proceso, puedes ejecutar gkectl con la marca --force para ignorar el error a mitad del proceso y continuar con la eliminación.

gkectl delete cluster \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG \
--cluster CLUSTER_NAME \
--force

Precaución: Cuando fuerzas la eliminación de un clúster, es posible que queden algunos recursos de F5 o vSphere debido a que se ignoraron los errores a mitad del proceso. Consulta la sección Limpia los recursos para obtener información sobre cómo limpiar los recursos restantes.

Si borraste un clúster que usaba el balanceador de cargas de Seesaw, borra las VMs de Seesaw. Para ello, borra las VMs de Seesaw en la interfaz de usuario de vSphere.

Console

Si la API de GKE On-Prem administra el clúster de usuario, sigue estos pasos para borrar el clúster:

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

   Ir a los clústeres de GKE

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

3. En la lista de clústeres, busca el que deseas borrar. Si el Tipo es externo, esto indica que el clúster se creó con gkectl y no se inscribió en la API de GKE On-Prem. En este caso, sigue los pasos de la pestaña gkectl para borrar el clúster.

   Si el ícono de la columna Estado indica un problema, sigue los pasos de la pestaña de gcloud CLI para borrar el clúster. Deberás agregar la marca --ignore-errors al comando de eliminación.

4. Haz clic en el nombre del clúster que deseas borrar.

5. En el panel Detalles, cerca de la parte superior de la ventana, haz clic en Borrar.

6. Cuando se te solicite confirmar, ingresa el nombre del clúster y haz clic en Quitar.

gcloud CLI

Si la API de GKE On-Prem administra el clúster de usuario, haz lo siguiente en una computadora que tenga instalada la gcloud CLI:

1. Actualiza los componentes, como se indica a continuación:

   gcloud components update
   

2. Usa el siguiente comando para borrar el clúster:

   gcloud container vmware clusters delete USER_CLUSTER_NAME \
     --project=PROJECT_ID \
     --location=LOCATION \
     --force \
     --allow-missing
   

   Reemplaza lo siguiente:

   • USER_CLUSTER_NAME: Es el nombre del clúster de usuario que se borrará.

   • PROJECT_ID: El ID del proyecto en el que está registrado el clúster.

   • LOCATION: Es la ubicación de Google Cloud asociada al clúster de usuario.

   La marca --force te permite borrar un clúster que tiene grupos de nodos. Sin la marca --force, primero debes borrar los grupos de nodos y, luego, borrar el clúster.

   La marca --allow-missing es una marca estándar de la API de Google. Cuando incluyes esta marca, el comando muestra un mensaje de éxito si no se encuentra el clúster.

   Si el comando devuelve un error que contiene el texto failed connecting to the cluster's control plane, esto indica problemas de conectividad con el clúster de administrador, el agente de Connect o el entorno local.

   • Si crees que el problema de conectividad es transitorio, por ejemplo, debido a problemas de red, espera y vuelve a intentar el comando.

   • Si el reintento del comando sigue fallando, consulta Cómo recopilar registros del agente de Connect para solucionar problemas con el agente de Connect.

   • Si sabes que se borró el clúster de administrador o si las VMs del clúster de administrador o de usuario se apagaron o no están accesibles por algún otro motivo, incluye la marca --ignore-errors y vuelve a intentar ejecutar el comando.

   Precaución: Cuando no se puede acceder a los clústeres de administrador y de usuario, y se incluye --ignore-errors, el comando de borrado quita solo los recursos de Google Cloud . Es posible que queden algunos recursos de F5 o vSphere. Consulta la sección Limpia los recursos para obtener información sobre cómo limpiar los recursos restantes.

Para obtener información sobre otras marcas, consulta la referencia de la CLI de gcloud.

Limpia los recursos

Si hubo problemas cuando borraste el clúster, es posible que queden algunos recursos de F5 o vSphere. En las siguientes secciones, se explica cómo limpiar estos recursos restantes.

Realiza una limpieza de las VM de un clúster de usuario en vSphere

Para verificar que se borren las VM del clúster de usuario, realiza los siguientes pasos:

1. En el menú Navigator izquierdo del cliente web de vSphere, haz clic en el menú Hosts and Clusters.

2. Busca el grupo de recursos del clúster de administrador. Este es el valor de vCenter.resourcePool en el archivo de configuración de tu clúster de administrador.

3. En el grupo de recursos, busca las VM con el nombre del clúster de usuario como prefijo. Estos son los nodos del plano de control para tu clúster de usuario. Habrá una o tres de estas opciones, según si tu clúster de usuario tiene un plano de control de alta disponibilidad.

4. Busca el grupo de recursos del clúster de usuario. Este es el valor de vCenter.resourcePool en el archivo de configuración del clúster de usuario. Si el archivo de configuración de tu clúster de usuario no especifica un grupo de recursos, se hereda del clúster de administrador.

5. En el grupo de recursos, ubica las VMs con el prefijo de un grupo de nodos en tu clúster de usuario. Estos son los nodos trabajadores en el clúster de usuario.

6. Para cada nodo del plano de control y cada nodo trabajador:

   1. Desde el cliente web de vSphere, haz clic con el botón derecho en la VM y selecciona Power > Power Off.

   2. Una vez que la VM esté apagada, haz clic con el botón derecho en la VM y selecciona Delete from Disk.

Realiza una limpieza de la partición F5 de un clúster de usuario

Si hay entradas restantes en la partición del clúster de usuario, sigue estos pasos:

1. Desde la consola BIG-IP de F5, en la esquina superior derecha de la consola, cambia a la partición del clúster de usuario que deseas limpiar.
2. Selecciona Local Traffic > Virtual Servers > Virtual Server List.
3. En el menú Virtual Servers, quita todas las IP virtuales.
4. Selecciona Pools y, luego, bórralos a todos.
5. Selecciona Nodes y, luego, bórralos a todos.

Después de haber terminado

Después de borrar el clúster, puedes borrar el kubeconfig del clúster de usuario.