Borrar un clúster de usuarios

En esta página, se describe cómo borrar un clúster de usuario de GKE on VMware. La eliminación del clúster de usuario cancela el registro del clúster de la flota y borra las cargas de trabajo, los grupos de nodos, los nodos del plano de control y los recursos correspondientes, como las VMs, las particiones F5 y los discos de datos.

Elegir una herramienta para borrar un clúster

La forma de borrar 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 se inscribe en la API de GKE On-Prem si se cumple una de las siguientes condiciones:

El clúster se creó con la consola de Google Cloud, Google Cloud CLI (gcloud CLI) o Terraform, que inscribe automáticamente el clúster en la API de GKE On-Prem. En conjunto, estas aplicaciones estándar 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 borrarlo. 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 borrarlo.

Para encontrar todos los clústeres de usuario que están 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=-

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

Si el clúster aparece en la lista, está inscrito en la API de GKE On-Prem. Si no eres propietario de un proyecto, como mínimo, debes tener la función de Identity and Access Management roles/gkeonprem.admin en el proyecto para borrar los clústeres inscritos. Para obtener detalles sobre los permisos incluidos en esta función, consulta Funciones de la API de GKE On-Prem en la documentación de IAM.

Borra cargas de trabajo con estado

Antes de borrar el clúster, ejecuta kubectl delete para borrar las cargas de trabajo, los PVC y los PV con estado.

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 firewall y proxy de tu organización permiten que el tráfico llegue a gkeonprem.googleapis.com y gkeonprem.mtls.googleapis.com (los nombres de los servicios para 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 con un mensaje similar al siguiente:

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

Eso 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 fácil es usar un cliente de la API de GKE On-Prem para borrar el clúster.

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

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

Si usas el balanceador de cargas en paquetes de Seesaw, borra el balanceador de cargas.

Console

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

En la consola, ve a la página de 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 de usuario.
En la lista de clústeres, ubica 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 que se indican en la pestaña gkectl para borrar el clúster.

Si el ícono en la columna Estado indica un problema, sigue los pasos en la pestaña degcloud CLId para borrar el clúster. Deberás agregar la marca --ignore-errors al comando de eliminación.
Haz clic en el nombre del clúster que deseas borrar.
En el panel Details, cerca de la parte superior de la ventana, haz clic en Delete.
Cuando se te solicite confirmación, 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:

Actualiza los componentes, como se indica a continuación:
```
gcloud components update
```
Obtén una lista de clústeres para asegurarte de especificar el nombre correcto del clúster en el comando de eliminación:
```
gcloud container vmware clusters list \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION
```
Reemplaza lo siguiente:
- FLEET_HOST_PROJECT_ID: El ID del proyecto en el que está registrado el clúster.
- LOCATION: Es la ubicación de Google Cloud asociada con el clúster de usuario.
El resultado es similar al siguiente:
```
NAME                      LOCATION    VERSION          ADMIN_CLUSTER.            STATE
example-user-cluster-1a   us-west1    1.28.300-gke.123    example-admin-cluster-1   RUNNING
```
Usa el siguiente comando para borrar el clúster:
```
gcloud container vmware clusters delete USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION \
  --force \
  --allow-missing
```
Reemplaza lo siguiente:
- USER_CLUSTER_NAME: Es el nombre del clúster de usuario que se borrará.
- FLEET_HOST_PROJECT_ID: El ID del proyecto en el que está registrado el clúster.
- LOCATION: Es la ubicación de Google Cloud asociada con el clúster de usuario.
La marca --force te permite borrar un clúster que tenga 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 el resultado correcto si no se encuentra el clúster.

Si el comando muestra 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 ejecutar el comando.
- Si reintentar el comando sigue fallando, consulta Recopila registros del agente de Connect para solucionar problemas del agente de Connect.
- Si sabes que se borró el clúster de administrador, o si las VM del administrador o del clúster de usuario se cerraron o no se puede acceder por algún otro motivo, incluye la marca --ignore-errors y vuelve a ejecutar el comando.
Precaución: Cuando no se puede acceder a los clústeres de administrador y de usuario y, además, incluyes --ignore-errors, el comando delete solo quita los recursos de Google Cloud. Es posible que queden algunos recursos de F5 o vSphere. Consulta la sección Limpia recursos para obtener información sobre cómo limpiar los recursos restantes.

Para obtener más 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:

En el menú Navigator izquierdo del cliente web de vSphere, haz clic en el menú Hosts and Clusters.
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.
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.
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.
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.
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:

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.
Selecciona Local Traffic > Virtual Servers > Virtual Server List.
En el menú Virtual Servers, quita todas las IP virtuales.
Selecciona Pools y, luego, bórralos a todos.
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.