Supprimer un cluster d'administrateur

Cette page explique comment supprimer un cluster d'administrateur Google Distributed Cloud.

Avant de commencer

Avant de supprimer un cluster d'administrateur, procédez comme suit :

  • Supprimez ses clusters d'utilisateur. Consultez la page Supprimer un cluster d'utilisateur.
  • Supprimez toutes les charges de travail qui utilisent des PodDisruptionBudgets du cluster d'administrateur.
  • Supprimez tous les objets externes, tels que PersistentVolumes, du cluster d'administrateur.
  • Définissez une variable d'environnement KUBECONFIG pointant vers le fichier kubeconfig du cluster d'administrateur que vous souhaitez supprimer :

    export KUBECONFIG=ADMIN_CLUSTER_KUBECONFIG
    

    ADMIN_CLUSTER_KUBECONFIG est le chemin d'accès au fichier kubeconfig du cluster d'administrateur.

Désinscrire le cluster d'administrateur

Si le cluster d'administrateur est enregistré dans l'API GKE On-Prem, vous devez d'abord le désinscrire de l'API. Un cluster d'administrateur est enregistré dans l'API lorsque vous enregistrez explicitement le cluster ou lorsque vous mettez à niveau un cluster d'utilisateur à l'aide d'un client API GKE On-Prem.

  1. Répertoriez tous les clusters d'administrateur enregistrés dans votre projet:

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

    Remplacez PROJECT_ID par l'ID du projet hôte de parc.

    La commande génère le nom de chaque cluster d'administrateur enregistré dans l'API GKE On-Prem du projet, ainsi que la région Google Cloud.

    Lorsque vous définissez --location=-, cela signifie que tous les clusters de toutes les régions sont listés. Si vous devez limiter le champ d'application de la liste, définissez --location sur la région que vous avez spécifiée lors de l'enregistrement du cluster.

  2. Désinscrivez le cluster de l'API GKE On-Prem:

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

    Remplacez les éléments suivants :

    • ADMIN_CLUSTER_NAME: nom du cluster d'administrateur.
    • PROJECT_ID: ID du projet hôte du parc.
    • REGION: région Google Cloud.

    Cette commande supprime les ressources de l'API GKE On-Prem de Google Cloud.

Annuler l'enregistrement du cluster d'administrateur

Lorsque vous créez un cluster d'administrateur, vous register le cluster dans un parc Google Cloud. Exécutez la commande suivante pour supprimer l'adresse IP membre du parc, ce qui annule l'enregistrement du cluster:

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

Cette commande supprime les ressources d'appartenance au parc de Google Cloud.

Supprimer la journalisation et la surveillance

Les pods de journalisation et de surveillance de GKE sur VMware, déployés à partir de StatefulSets, utilisent des PDB qui peuvent empêcher les nœuds de se drainer correctement. Pour supprimer correctement un cluster d'administrateur, vous devez supprimer ces pods.

Pour supprimer les pods de journalisation et de surveillance, exécutez les commandes suivantes :

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

La suppression de la surveillance nettoie les PersistentVolumes (VP) associés aux StatefulSets, mais le PersistentVolume de Stackdriver doit être supprimé séparément.

La suppression du PV de Stackdriver est facultative. Si vous choisissez de ne pas supprimer le volume persistant, enregistrez l'emplacement et le nom du volume persistant associé dans un emplacement externe situé en dehors du cluster d'utilisateur.

La suppression du volume persistant sera propagée par la suppression de la revendication de volume persistant (PVC).

Pour trouver la revendication de volume persistant de Stackdriver, exécutez la commande suivante :

kubectl get pvc -n kube-system

Pour supprimer la revendication de volume persistant, exécutez la commande suivante :

kubectl delete pvc -n kube-system PVC_NAME

Vérifier que la journalisation et la surveillance sont supprimées

Pour vérifier que la journalisation et la surveillance ont été supprimées, exécutez les commandes suivantes :

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

Nettoyer la partition F5 d'un cluster d'administrateur

La suppression de l'espace de noms gke-system du cluster d'administrateur garantit un nettoyage correct de la partition F5, ce qui vous permet de la réutiliser pour un autre cluster d'administrateur.

Pour supprimer l'espace de noms gke-system, exécutez la commande suivante :

kubectl delete ns gke-system

Supprimez ensuite tous les autres services de type LoadBalancer restants. Pour répertorier tous les services, exécutez la commande suivante :

kubectl get services --all-namespaces

Pour chaque service de type LoadBalancer, supprimez le service en exécutant la commande suivante :

kubectl delete service SERVICE_NAME -n SERVICE_NAMESPACE

Ensuite, à partir de la console F5 BIG-IP, effectuez les actions suivantes :

  1. Dans l'angle supérieur droit de la console, basculez vers la partition à nettoyer.
  2. Sélectionnez Trafic local, puis Serveurs virtuels > Liste des serveurs virtuels.
  3. Dans le menu Virtual Servers (Serveurs virtuels), supprimez toutes les adresses IP virtuelles.
  4. Sélectionnez Pools, puis supprimez tous les pools.
  5. Sélectionnez Nœuds, puis supprimez tous les nœuds.

Vérifier que la partition F5 est propre

CLI

Vérifiez que l'adresse IP virtuelle est indisponible en exécutant la commande suivante :

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

qui renvoie 1 si l'adresse IP virtuelle n'est pas opérationnelle.

Interface utilisateur F5

Pour vérifier que la partition a été nettoyée de l'interface utilisateur F5, procédez comme suit :

  1. Dans l'angle supérieur droit, cliquez sur le menu déroulant Partition. Sélectionnez la partition de votre cluster d'administrateur.
  2. Dans le menu Principal de gauche, sélectionnez Trafic local > Carte du réseau. Aucun élément ne doit figurer sous la carte de trafic local du réseau.
  3. Dans Trafic local > Serveurs virtuels, sélectionnez Nœuds, puis Liste de nœuds. Aucun élément ne doit figurer ici non plus.

S'il reste des entrées, supprimez-les manuellement dans l'interface utilisateur.

Mettre hors tension les machines de nœud d'administrateur

Tout d'abord, exécutez cette commande pour obtenir les noms des machines avant de les éteindre.

kubectl get machines -o wide

Le résultat donne la liste des noms des machines. Vous les trouverez désormais dans l'interface utilisateur vSphere.

Pour supprimer les machines de nœud du plan de contrôle d'administrateur, vous devez éteindre chacune des VM d'administrateur restantes dans votre pool de ressources vSphere.

Interface utilisateur vSphere

Procédez comme suit :

  1. Dans le menu vSphere, sélectionnez la VM dans le pool de ressources Vsphere.
  2. En haut du menu de la VM, cliquez sur Actions.
  3. Sélectionnez Alimentation > Arrêt. L'arrêt de la VM peut prendre quelques minutes.

Supprimer des machines de nœud d'administrateur

Une fois la VM éteinte, vous pouvez la supprimer.

Interface utilisateur vSphere

Procédez comme suit :

  1. Dans le menu vSphere, sélectionnez la VM dans le pool de ressources Vsphere.
  2. En haut du menu de la VM, cliquez sur Actions.
  3. Cliquez sur Supprimer du disque.

Supprimer le disque de données

Après avoir supprimé les VM, vous pouvez supprimer le disque de données. La procédure diffère légèrement selon que vous disposez d'un cluster d'administrateur à disponibilité élevée ou standard.

Procédez comme suit dans l'interface utilisateur vSphere:

standard

  1. Dans le menu vSphere, sélectionnez le disque de données du datastore, comme spécifié dans le champ vCenter.dataDisk du fichier de configuration du cluster d'administrateur.
  2. Au milieu du menu du datastore, cliquez sur Supprimer.

haute disponibilité

Les chemins d'accès aux disques de données pour les trois machines du plan de contrôle administrateur sont générés automatiquement sous /anthos/ADMIN_CLUSTER/default/, par exemple:

/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

Pour supprimer chaque disque de données, procédez comme suit:

  1. Dans le menu vSphere, sélectionnez le disque de données dans le datastore.
  2. Au milieu du menu du datastore, cliquez sur Supprimer.

Supprimer le fichier checkpoint.yaml

Si vous supprimez un cluster d'administrateur haute disponibilité, ignorez cette étape, car les clusters d'administrateur haute disponibilité ne sont pas compatibles avec le fichier de point de contrôle.

Le fichier DATA_DISK_NAME-checkpoint.yaml, où DATA_DISK_NAME est le nom du disque de données, se trouve dans le même dossier que le disque de données. Supprimez ce fichier.

Une fois terminé

Une fois la suppression du cluster d'administrateur terminée, supprimez son fichier kubeconfig.