Supprimer un cluster d'utilisateur

Cette page explique comment supprimer un cluster utilisateur Google Distributed Cloud. La suppression du cluster d'utilisateur désinscrit le cluster du parc et supprime les charges de travail, les pools de nœuds, les nœuds du plan de contrôle et les ressources correspondantes, telles que les VM, les partitions F5 et les disques de données.

Choisir un outil pour supprimer un cluster

Si vous avez créé le cluster avec enableAdvancedCluster défini sur true (ce qui est nécessaire pour configurer des domaines de topologie), vous devez utiliser gkectl pour le supprimer.

Sinon, la méthode de suppression d'un cluster d'utilisateurs dépend de son enregistrement dans l'API GKE On-Prem. Un cluster d'utilisateur est enregistré dans l'API GKE On-Prem si l'une des conditions suivantes est remplie:

  • Le cluster a été créé à l'aide de la console Google Cloud, de Google Cloud CLI (gcloud CLI) ou de Terraform, l'enregistrant automatiquement dans l'API GKE On-Prem. Collectivement, ces outils sont appelés clients de l'API GKE On-Prem.

  • Le cluster a été créé à l'aide de gkectl, mais il a été inscrit dans l'API GKE On-Prem.

Si le cluster est inscrit dans l'API GKE On-Prem, utilisez un client de l'API GKE On-Prem pour le supprimer. Si le cluster n'est pas inscrit dans l'API GKE On-Prem, utilisez gkectl sur le poste de travail administrateur pour le supprimer.

Pour rechercher tous les clusters d'utilisateurs enregistrés dans l'API GKE On-Prem dans un projet spécifique, exécutez la commande suivante:

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

Le résultat ressemble à ce qui suit :

NAME                      LOCATION    VERSION             ADMIN_CLUSTER.            STATE
example-user-cluster-1a   us-west1    1.31.200-gke.58    example-admin-cluster-1   RUNNING

Lorsque vous définissez --location=-, cela signifie que vous souhaitez lister tous les clusters de toutes les régions. Si vous devez limiter la liste, vous pouvez définir --location sur une région spécifique.

Si le cluster est listé, il est enregistré dans l'API GKE On-Prem. Si vous n'êtes pas propriétaire du projet, vous devez disposer au minimum du rôle Identity and Access Management roles/gkeonprem.admin pour le projet afin de supprimer les clusters inscrits. Pour en savoir plus sur les autorisations incluses dans ce rôle, consultez la section Rôles de l'API GKE On-Prem dans la documentation IAM.

Si vous utilisez gkectl pour supprimer un cluster, assurez-vous que votre poste de travail administrateur dispose de la version requise de gkectl. En règle générale, vous utilisez la même version de gkectl que celle du cluster que vous supprimez. Les règles de version suivantes sont appliquées lors de la suppression:

  • La version mineure gkectl ne peut pas être inférieure à celle du cluster. Par exemple, la suppression d'un cluster 1.30 à l'aide de gkectl version 1.29 n'est pas autorisée. Les versions de correctif n'ont pas d'importance. Par exemple, vous pouvez utiliser la version gkectl 1.29.0-gke.1456 pour supprimer un cluster avec une version de correctif supérieure, telle que 1.29.1000-gke.94.

  • La version mineure gkectl ne peut pas être supérieure de plus de deux versions mineures à la version du cluster. Par exemple, si vous supprimez un cluster 1.28, la version gkectl peut être 1.29 ou 1.30. Toutefois, vous ne pouvez pas utiliser la version 1.31 de gkectl, car elle est trois versions mineures plus récente que la version du cluster.

Si nécessaire, consultez Télécharger gkectl pour obtenir une version compatible de gkectl.

Supprimer les charges de travail avec état

Avant de supprimer votre cluster, supprimez vos charges de travail avec état, vos PVC et vos PV en exécutant kubectl delete.

Supprimer un cluster d'utilisateur

gkectl

Vous pouvez utiliser gkectl pour supprimer les clusters qui ne sont pas inscrits dans l'API GKE On-Prem. Si les règles de proxy et de pare-feu de votre organisation autorisent le trafic à atteindre gkeonprem.googleapis.com et gkeonprem.mtls.googleapis.com (noms de service de l'API GKE On-Prem), gkectl pourra supprimer les clusters enregistrés.

Pour supprimer le cluster, exécutez la commande suivante sur le poste de travail administrateur:

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

Où :

  • ADMIN_CLUSTER_KUBECONFIG est le chemin d'accès au fichier kubeconfig du cluster d'administrateur.
  • CLUSTER_NAME est le nom du cluster utilisateur que vous souhaitez supprimer.

Si la suppression échoue et affiche un message semblable à celui-ci:

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

Cela signifie que le cluster est enregistré, mais que gkectl n'a pas pu atteindre l'API GKE On-Prem. Dans ce cas, le moyen le plus simple de supprimer le cluster consiste à utiliser un client de l'API GKE On-Prem.

Si la suppression du cluster d'utilisateur échoue à mi-chemin, vous pouvez exécuter gkectl avec l'option --force pour ignorer l'erreur à mi-chemin et poursuivre la suppression.

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

Si vous avez supprimé un cluster qui utilisait l'équilibreur de charge Seesaw, supprimez les VM Seesaw. Pour ce faire, supprimez les VM Seesaw dans l'interface utilisateur vSphere.

Console

Si le cluster d'utilisateurs est géré par l'API GKE On-Prem, procédez comme suit pour le supprimer :

  1. Dans la console, accédez à la page Vue d'ensemble des clusters Google Kubernetes Engine.

    Accéder aux clusters GKE

  2. Sélectionnez le projet Google Cloud dans lequel se trouve le cluster d'utilisateur.

  3. Dans la liste des clusters, localisez le cluster que vous souhaitez modifier. Si le Type est externe, cela signifie que le cluster a été créé à l'aide de gkectl et n'a pas été inscrit dans l'API GKE On-Prem. Dans ce cas, suivez les étapes décrites dans l'onglet gkectl pour supprimer le cluster.

    Si l'icône de la colonne État indique un problème, suivez la procédure de l'onglet gcloud CLI pour supprimer le cluster. Vous devrez ajouter l'option --ignore-errors à la commande de suppression.

  4. Cliquez sur le nom du cluster que vous souhaitez supprimer.

  5. Dans le panneau Détails, en haut de la fenêtre, cliquez sur Supprimer.

  6. Lorsque vous êtes invité à confirmer l'opération, saisissez le nom du cluster, puis cliquez sur Supprimer.

CLI gcloud

Si le cluster d'utilisateurs est géré par l'API GKE On-Prem, procédez comme suit sur un ordinateur sur lequel gcloud CLI est installé:

  1. Mettez à jour les composants :

    gcloud components update

  2. Utilisez la commande suivante pour supprimer le cluster:

    gcloud container vmware clusters delete USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --force \
  --allow-missing

    Remplacez les éléments suivants :

    • USER_CLUSTER_NAME : nom du cluster d'utilisateur à supprimer.

    • PROJECT_ID : ID du projet auquel le cluster d'administrateur est enregistré.

    • LOCATION: emplacement Google Cloud associé au cluster d'utilisateurs.

    L'option --force vous permet de supprimer un cluster qui comporte des pools de nœuds. Sans l'option --force, vous devez d'abord supprimer les pools de nœuds, puis le cluster.

    L'option --allow-missing est une option d'API Google standard. Lorsque vous incluez cette option, la commande renvoie un résultat positif si le cluster n'est pas trouvé.

    Si la commande renvoie une erreur contenant le texte failed connecting to the cluster's control plane, cela indique des problèmes de connectivité avec le cluster d'administration, l'agent Connect ou l'environnement sur site.

    • Si vous pensez que le problème de connectivité est temporaire, par exemple en raison de problèmes de réseau, attendez et réessayez la commande.

    • Si la commande échoue toujours, consultez la section Collecter les journaux de l'agent Connect pour résoudre les problèmes liés à l'agent Connect.

    • Si vous savez que le cluster d'administrateur a été supprimé, ou si les VM du cluster d'administrateur ou d'utilisateur ont été arrêtées ou sont autrement inaccessibles, incluez l'option --ignore-errors et réessayez la commande.

Pour en savoir plus sur les autres options, consultez la documentation de référence de gcloud CLI.

Effectuer un nettoyage des ressources

Si des problèmes sont survenus lorsque vous avez supprimé le cluster, certaines ressources F5 ou vSphere peuvent persister. Les sections suivantes expliquent comment nettoyer ces ressources restantes.

Nettoyer des VM d'un cluster d'utilisateur dans vSphere

Pour vérifier que les VM du cluster d'utilisateur sont supprimées, procédez comme suit :

  1. Dans le menu Navigator (Navigateur) situé à gauche du client Web vSphere, cliquez sur le menu Hôtes et clusters (Hosts and Clusters).

  2. Recherchez le pool de ressources pour votre cluster d'administrateur. Il s'agit de la valeur de vCenter.resourcePool dans votre fichier de configuration de cluster d'administrateur.

  3. Sous le pool de ressources, localisez les VM précédées du nom de votre cluster d'utilisateur. Il s'agit des nœuds du plan de contrôle de votre cluster d'utilisateur. Vous en verrez une ou trois selon que votre cluster d'utilisateur dispose d'un plan de contrôle à haute disponibilité ou non.

  4. Recherchez le pool de ressources pour votre cluster d'utilisateur. Il s'agit de la valeur de vCenter.resourcePool dans le fichier de configuration de votre cluster d'utilisateur. Si le fichier de configuration du cluster d'utilisateur ne spécifie pas de pool de ressources, il est hérité du cluster d'administrateur.

  5. Sous le pool de ressources, localisez les VM précédées du nom d'un pool de nœuds dans votre cluster d'utilisateur. Il s'agit des nœuds de calcul de votre cluster d'utilisateur.

  6. Pour chaque nœud du plan de contrôle et chaque nœud de calcul :

    1. Dans le client Web vSphere, effectuez un clic droit sur la VM, puis sélectionnez Alimentation > Mettre hors tension.

    2. Une fois la VM éteinte, faites un clic droit sur la VM, puis sélectionnez Supprimer du disque.

Nettoyer la partition F5 d'un cluster d'utilisateur

S'il reste des entrées dans la partition du cluster d'utilisateur, procédez comme suit :

  1. Dans l'angle supérieur droit de la console F5 BIG-IP, basculez vers la partition du cluster d'utilisateur que vous souhaitez nettoyer.
  2. Sélectionnez Local Traffic (Trafic local), puis Virtual Servers > Virtual Server List (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 Nodes (Nœuds), puis supprimez tous les nœuds.

Une fois terminé

Une fois le cluster supprimé, vous pouvez supprimer le fichier kubeconfig du cluster utilisateur.