Borrar un clúster de administrador

En esta página, se describe cómo borrar un clúster de administrador creado con Google Distributed Cloud (solo software) para VMware.

Antes de comenzar

Antes de borrar un clúster de administrador, completa los siguientes pasos:

  • Borra los clústeres de usuarios. Consulta la página Borra un clúster de usuario.
  • Borra cualquier carga de trabajo que use PodDisruptionBudgets (PDB) del clúster de administrador.
  • Borra todos los objetos externos, como PersistentVolumes, del clúster de administrador.

  • Configura una variable de entorno KUBECONFIG que apunte al kubeconfig del clúster de administrador que deseas borrar:

    export KUBECONFIG=ADMIN_CLUSTER_KUBECONFIG

    En el comando anterior, ADMIN_CLUSTER_KUBECONFIG es la ruta del archivo kubeconfig del clúster de administrador.

  • Anota el nombre del clúster de administrador:

    kubectl get onpremadmincluster

Cancela la inscripción del clúster de administrador

Si el clúster de administrador está inscrito en la API de GKE On-Prem, primero debes dar de baja la inscripción desde la API. Un clúster de administrador se inscribe en la API cuando lo inscribes de forma explícita o cuando actualizas un clúster de usuario con Google Cloud CLI.

  1. Enumera todos los clústeres de administrador inscritos en tu proyecto:

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

    Reemplaza PROJECT_ID por el ID del proyecto host de flota.

    El comando muestra el nombre de cada clúster de administrador que está inscrito en la API de GKE On-Prem en el proyecto, junto con la región de Google Cloud.

    Cuando configuras --location=-, significa que se deben enumerar todos los clústeres en todas las regiones. Si necesitas reducir el alcance de la lista, configura --location en la región que especificaste cuando inscribiste el clúster.

  2. Da de baja la inscripción del clúster desde la API de GKE On-Prem:

    gcloud container vmware admin-clusters unenroll  ADMIN_CLUSTER_NAME \
    --project=PROJECT_ID \
    --location=REGION

    Reemplaza lo siguiente:

    • ADMIN_CLUSTER_NAME: Es el nombre del clúster de administrador.
    • PROJECT_ID el ID del proyecto host de la flota.
    • REGION: la región de Google Cloud

    Este comando quita los recursos de la API de GKE On-Prem de Google Cloud.

Borra el registro y la supervisión

Los Pods de registro y supervisión de Google Distributed Cloud, que se implementaron desde StatefulSets, usan PDB que pueden evitar que los nodos se desvíen de forma correcta. Para borrar de forma correcta un clúster de administrador, debes borrar estos Pods.

Para borrar Pods de registro y supervisión, ejecuta los siguientes comandos:

kubectl delete monitoring --all -n kube-system
kubectl delete stackdriver --all -n kube-system

Borrar la supervisión limpia los PersistentVolumes (PV) asociados con los StatefulSets, pero el PersistentVolume para Stackdriver debe borrarse por separado.

La eliminación del PV de Stackdriver es opcional. Si decides no borrar el PV, registra la ubicación y el nombre del PV asociado en una ubicación externa fuera del clúster de usuario.

La eliminación del PV se propaga mediante la eliminación de la Reclamación de volúmenes persistentes (PVC).

Para encontrar la PVC de Stackdriver, ejecuta el siguiente comando:

kubectl get pvc -n kube-system

Para borrar la PVC, ejecuta el siguiente comando:

kubectl delete pvc -n kube-system PVC_NAME

Verifica que se hayan quitado el registro y la supervisión

Para verificar que se hayan quitado el registro y la supervisión, ejecuta los siguientes comandos:

kubectl get pvc -n kube-system
kubectl get statefulsets -n kube-system

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

Borrar el espacio de nombres gke-system del clúster de administrador garantiza la limpieza adecuada de la partición F5, lo que te permite volver a usar la partición para otro clúster de administrador.

Para borrar el espacio de nombres gke-system, ejecuta el siguiente comando:

kubectl delete ns gke-system

Luego, borra los servicios restantes de tipo LoadBalancer. Para mostrar en una lista todos los servicios, ejecuta el siguiente comando:

kubectl get services --all-namespaces

Por cada servicio de tipo LoadBalancer, ejecuta el siguiente comando para borrarlo:

kubectl delete service SERVICE_NAME -n SERVICE_NAMESPACE

Luego, desde la consola BIG-IP de F5, haz lo siguiente:

  1. En la esquina superior derecha de la consola, cambia a la partición para limpiarla.
  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.

Verifica que la partición F5 esté limpia

CLI

Ejecuta el siguiente comando para verificar que el VIP esté inactivo:

ping -c 1 -W 1 F5_LOAD_BALANCER_IP; echo $?

En el comando anterior, se mostrará 1 si el VIP está inactivo.

IU de F5

Para verificar que la partición se haya limpiado de la interfaz de usuario de F5, sigue estos pasos:

  1. En la esquina superior derecha, haz clic en el menú desplegable Partition. Selecciona la partición de tu clúster de administrador.
  2. En el menú de la izquierda Main, selecciona Local Traffic > Network Map. No debe aparecer nada debajo del mapa de la red de tráfico local.
  3. En Local Traffic > Virtual Servers, selecciona Nodes y, luego, Nodes List. Aquí tampoco debería haber nada.

Si quedan entradas, bórralas de forma manual desde la IU.

Apaga las máquinas del nodo de administrador

Primero, ejecuta este comando para obtener los nombres de las máquinas antes de apagarlas.

kubectl get machines -o wide

El resultado muestra los nombres de las máquinas. Ahora puedes encontrarlos en la IU de vSphere.

Para borrar las máquinas del nodo del plano de control de administrador, debes apagar todas las VM de administrador restantes en tu grupo de recursos de vSphere.

IU de vSphere

Sigue los siguientes pasos:

  1. En el menú de vSphere, selecciona la VM del grupo de recursos de vSphere.
  2. En la parte superior del menú de VM, haz clic en Actions.
  3. Selecciona Power > Power Off. Es posible que la VM tarde unos minutos en apagarse.

Borra las máquinas del nodo de administrador

Cuando la VM se haya apagado, puedes borrarla.

IU de vSphere

Sigue los siguientes pasos:

  1. En el menú de vSphere, selecciona la VM del grupo de recursos de vSphere.
  2. En la parte superior del menú de VM, haz clic en Actions.
  3. Haz clic en Delete from Disk.

Borra el disco de datos

Después de borrar todas las VM, puedes borrar el disco de datos. Los pasos difieren ligeramente según si tienes un clúster de administración con alta disponibilidad (HA) o sin HA.

Sigue estos pasos en la IU de vSphere:

Sin HA

  1. En el menú de vSphere, selecciona el disco de datos del almacén de datos como se especifica en el campo vCenter.dataDisk del archivo de configuración del clúster de administrador.
  2. En el medio del menú del almacén de datos, haz clic en Borrar.

HA

Las rutas de acceso de los discos de datos de las 3 máquinas del plano de control de administrador se generan automáticamente en /anthos/ADMIN_CLUSTER/default/, por ejemplo:

/anthos/ADMIN_CLUSTER_NAME/default/MACHINE_NAME-0-data.vmdk
/anthos/ADMIN_CLUSTER_NAME/default/MACHINE_NAME-1-data.vmdk
/anthos/ADMIN_CLUSTER_NAME/default/MACHINE_NAME-2-data.vmdk

Sigue estos pasos para borrar cada disco de datos:

  1. En el menú de vSphere, selecciona el disco de datos del almacén de datos.
  2. En el medio del menú del almacén de datos, haz clic en Borrar.

Borra el archivo checkpoint.yaml

Si borras un clúster de administrador de alta disponibilidad, omite este paso, ya que los clústeres de administrador de alta disponibilidad no admiten el archivo de punto de control.

El archivo DATA_DISK_NAME-checkpoint.yaml, en el que DATA_DISK_NAME es el nombre del disco de datos, se encuentra en la misma carpeta que el disco de datos. Borra este archivo.

Cancela el registro del clúster de administrador

Cuando creas un clúster de administrador, lo registras en una flota de Google Cloud. Ejecuta el siguiente comando para borrar la membresía de la flota, lo que cancelará el registro del clúster:

gcloud container fleet memberships delete ADMIN_CLUSTER_NAME \
    --project=PROJECT_ID \
    --location=global

Este comando quita los recursos de membresía de la flota de Google Cloud.

Después de haber terminado

Cuando termines de borrar el clúster de administrador, borra su kubeconfig.