Restablece o borra los clústeres existentes

Restablece clústeres con bmctl reset cluster

Cuando un clúster no se instala de forma correcta, puedes intentar restablecer los nodos a un estado limpio si restableces el clúster. Si restableces un clúster, se borra. Una vez borrados, puedes volver a instalar el clúster después de realizar los cambios de configuración necesarios.

En el contexto de este documento, el restablecimiento y la eliminación se usan de manera intercambiable.

Restablece clústeres autoadministrados

Para restablecer un clúster que se administre por sí mismo, como un clúster de administrador, ejecuta el siguiente comando:

bmctl reset --cluster CLUSTER_NAME

Reemplaza CLUSTER_NAME por el nombre del clúster que deseas restablecer.

Restablece clústeres de usuario

Hay dos formas de borrar o restablecer clústeres de usuario, respectivamente, mediante bmctl o kubectl. El uso de bmctl es la forma recomendada de restablecer los clústeres de usuarios.

Usa bmctl para restablecer un clúster de usuario

Ejecuta el siguiente comando para restablecer un clúster de usuario con bmctl:

bmctl reset --cluster CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH

Reemplaza lo siguiente:

  • CLUSTER_NAME: Es el nombre del clúster de usuario que deseas restablecer.

  • ADMIN_KUBECONFIG_PATH: Es la ruta de acceso al archivo kubeconfig del clúster de administrador asociado. bmctl admite el uso de --kubeconfig como un alias para la marca --admin-kubeconfig.

Usa kubectl para borrar un clúster de usuario

Para usar kubectl a fin de borrar un clúster de usuario, primero debes borrar el objeto de clúster y, luego, su espacio de nombres. De lo contrario, los trabajos para restablecer las máquinas no se pueden crear, y el proceso de eliminación se puede detener de forma indefinida.

Para borrar un clúster de usuario con kubectl, haz lo siguiente:

  1. Ejecuta el siguiente comando para borrar el objeto del clúster:

    kubectl delete cluster CLUSTER_NAME -n CLUSTER_NAMESPACE \
        --kubeconfig ADMIN_KUBECONFIG_PATH

    Reemplaza lo siguiente:

    • CLUSTER_NAME: Es el nombre del clúster de usuario que deseas borrar.

    • CLUSTER_NAMESPACE: es el espacio de nombres para el clúster. De forma predeterminada, los espacios de nombres de los clústeres de Anthos en equipos físicos son el nombre del clúster precedido por cluster-. Por ejemplo, si le asignas el nombre test al clúster, el espacio de nombres tiene un nombre como cluster-test.

    • ADMIN_KUBECONFIG_PATH: Es la ruta de acceso al archivo kubeconfig del clúster de administrador asociado.

  2. Después de que el clúster se borre de forma correcta, ejecuta el siguiente comando para borrar el espacio de nombres:

    kubectl delete namespace CLUSTER_NAMESPACE --kubeconfig ADMIN_KUBECONFIG_PATH

Restablece los detalles del clúster

Sin importar el tipo de clúster, el comando de restablecimiento se aplica a todo el clúster. No hay opción para especificar un subconjunto de nodos en un clúster.

El resultado del comando bmctl cluster reset es similar al siguiente ejemplo:

bmctl reset --cluster cluster1
Creating bootstrap cluster... OK
Deleting GKE Hub member admin in project my-gcp-project...
Successfully deleted GKE Hub member admin in project my-gcp-project
Loading images... OK
Starting reset jobs...
Resetting: 1    Completed: 0    Failed: 0
...
Resetting: 0    Completed: 1    Failed: 0
Flushing logs... OK

Durante la operación de restablecimiento, bmctl primero intenta borrar el registro de la membresía de GKE Hub y, luego, limpia los nodos afectados. Durante el restablecimiento, también se borran los datos y las activaciones de almacenamiento de anthos-system StorageClass.

Para todos los nodos, bmctl ejecuta kubeadm reset, quita las interfaces de túnel que se usan para las redes del clúster y borra los siguientes directorios:

  • /etc/kubernetes
  • /etc/cni/net.d
  • /root/.kube
  • /var/lib/kubelet

En los nodos del balanceador de cargas, bmctl también realiza las siguientes acciones:

  • Inhabilita los servicios keepalived y haproxy.
  • Borra los archivos de configuración de keepalived y haproxy.

El comando bmctl reset espera que el archivo de configuración del clúster esté en el directorio de trabajo actual. De forma predeterminada, la ruta de acceso es como la siguiente: bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME.yaml

Si usaste la marca --workspacel-dir para especificar un directorio diferente durante la creación del clúster, debes usar la marca a fin de especificar el directorio de trabajo durante el restablecimiento del clúster.