Borrar un clúster de usuarios

En esta página, se describe cómo borrar un clúster de usuarios de Google Distributed Cloud. 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.

Elige una herramienta para borrar un clúster

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

De lo contrario, la forma en que borres 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 consola de Google Cloud, la CLI de Google Cloud (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 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 usuarios 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.31.100-gke.136    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, debes tener 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 de administrador tenga la versión necesaria de gkectl. Por lo general, usas la misma versión de gkectl que la versión del clúster que borras. Las siguientes reglas de versión se aplican durante la eliminación:

• La versión secundaria de 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 gkectl de la versión 1.29. No importa la versión del parche. Por ejemplo, puedes usar gkectl versión 1.29.0-gke.1456 para borrar un clúster con una versión de parche más alta, 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 de la versión 1.28, la versión de gkectl puede ser 1.29 o 1.30. Sin embargo, no puedes usar gkectl versión 1.31 porque es tres versiones secundarias más alta que 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, ejecuta kubectl delete para borrar las cargas de trabajo con estado, los PVC y los PV.

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 con un mensaje similar al siguiente, haz lo 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 conectarse 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 usuarios falla a mitad de camino, puedes ejecutar gkectl con la marca --force para ignorar el error y continuar con la eliminación.

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

Precaución: Cuando borras de forma forzosa un clúster, es posible que queden algunos recursos de F5 o vSphere debido a que se ignoran los errores a mitad de camino. Consulta la sección Cómo limpiar 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 VM 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 borrarlo:

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 de Google Cloud en el que se encuentra el clúster de usuario.

3. En la lista de clústeres, busca el que quieres 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 de la columna Estado indica un problema, sigue los pasos de la pestaña de gcloud CLI para borrar el clúster. Deberás añadir la marca --ignore-errors al comando borrar.

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 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:

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 Google Cloud ubicación asociada al 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, 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 estado de éxito 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 intentar el comando.

   • Si el 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 cerraron o no se puede acceder a ellas, incluye la marca --ignore-errors y vuelve a intentar 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 borrar solo quita los recursos Google Cloud . Es posible que queden algunos recursos de F5 o vSphere. Consulta la sección Cómo limpiar 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 realizar una limpieza de 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.