Supprimer l'enregistrement d'un cluster

Cette page explique comment annuler manuellement l'enregistrement d'un cluster d'un parc Google Cloud. Lorsque vous annulez manuellement l'enregistrement d'un cluster, sa connexion au parc est supprimée, mais le cluster reste disponible. La suppression d'un cluster GKE enregistré sur Google Cloud à l'aide de la console Google Cloud ou de gcloud CLI supprime également l'appartenance au parc du cluster.

Vous pouvez annuler l'enregistrement des clusters GKE sur Google Cloud et l'enregistrement des clusters tiers associés uniquement. L'enregistrement des autres types de clusters ne peut pas être annulé.

Notez qu'à l'heure actuelle, il n'est pas recommandé de déplacer des clusters enregistrés entre des parcs (d'annuler l'enregistrement, puis de procéder au réenregistrement), car cela peut entraîner un comportement inattendu ou indésirable. Par exemple, l'identité de charge de travail du parc correspondant à votre charge de travail peut changer, ce qui peut entraîner des blocages de requêtes et des interruptions. L'approche recommandée consiste à créer un cluster dans le parc contenant vos charges de travail, puis à déplacer vos charges de travail de l'ancien cluster vers le nouveau.

Annuler l'enregistrement d'un cluster

gcloud

Annuler l'enregistrement d'un cluster GKE

Cette commande ne peut être utilisée que pour annuler l'enregistrement des clusters GKE enregistrés à l'aide de gcloud container clusters update ou gcloud container clusters create.

Exécutez la commande ci-dessous.

gcloud container clusters update CLUSTER_NAME --clear-fleet-project

Remplacez CLUSTER_NAME par le nom du cluster que vous souhaitez supprimer.

Annuler l'enregistrement d'un cluster GKE (ancienne commande)

Si vous avez enregistré un cluster à l'aide de l'ancienne commande register, exécutez l'une des commandes suivantes pour l'annuler :

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-uri=[GKE_URI]

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-cluster=[GKE_CLUSTER]

où :

[PROJECT_ID] correspond à votre ID de projet Google Cloud. Découvrez comment identifier cette valeur.
[MEMBERSHIP_NAME] est le nom de l'abonnement correspondant au cluster. Pour répertorier tous les abonnements sur le Hub, exécutez la commande suivante : gcloud container fleet memberships list.
[GKE_URI] est l'URI du cluster GKE (par exemple, "https://container.googleapis.com/projects/my-project/locations/us-central1-a/clusters/my-cluster"). Vous pouvez obtenir l'URI en exécutant la commande gcloud container clusters list --uri. L'URI fourni sera validé afin de confirmer qu'il est mappé au cluster GKE valide.
[GKE_CLUSTER] est l'emplacement (location/name) du cluster GKE. L'emplacement peut être une zone ou une région (par exemple, us-central1-a/my-cluster).

Annuler l'enregistrement d'un cluster associé

Ces instructions s'appliquent aux clusters enregistrés à l'aide de la dernière version de la fonctionnalité de clusters associés. Les clusters associés à l'aide de la génération précédente (obsolète) de cette fonctionnalité doivent utiliser l'ancienne commande présentée dans la section suivante.

Annuler l'enregistrement d'un cluster associé (ancienne commande)

Si vous avez enregistré un cluster à l'aide de la génération précédente de clusters associés, exécutez la commande suivante pour le désinscrire :

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --context=[KUBECONFIG_CONTEXT] \
   --kubeconfig=[KUBECONFIG_PATH]

où :

[PROJECT_ID] correspond à votre ID de projet Google Cloud. Découvrez comment identifier cette valeur.
[MEMBERSHIP_NAME] est le nom de l'abonnement correspondant au cluster. Pour obtenir la liste de tous les abonnements sur le Hub, exécutez la commande suivante : gcloud container fleet memberships list.
[KUBECONFIG_PATH] est le chemin d'accès à l'emplacement local du fichier kubeconfig contenant une entrée pour le fichier du cluster. La valeur par défaut est $KUBECONFIG si cette variable d'environnement est définie, ou $HOME/.kube/config par défaut.
[KUBECONFIG_CONTEXT] correspond au contexte du cluster tel qu'il apparaît dans le fichier "kubeconfig". Vous pouvez obtenir cette valeur depuis la ligne de commande en exécutant kubectl config current-context.

Console

Annuler l'enregistrement d'un cluster GKE sur Google Cloud

Pour annuler l'enregistrement d'un cluster GKE, procédez comme suit :

Accédez à la page Clusters GKE. Cette page affiche tous vos clusters.

Accédez à la page Clusters GKE.
Cliquez sur Actions à côté du cluster dont vous souhaitez annuler l'enregistrement dans la liste.
Dans le menu d'actions, sélectionnez Annuler l'enregistrement.
Dans la boîte de dialogue qui s'affiche, saisissez le nom du cluster, puis cliquez sur Annuler l'enregistrement pour confirmer l'action.

Annuler l'enregistrement d'un cluster tiers associé

Pour annuler l'enregistrement d'un cluster associé :

Dans la console Google Cloud, accédez à la page Présentation des clusters Google Kubernetes Engine.

Accéder aux clusters GKE
Sélectionnez le projet Google Cloud dans lequel se trouve le cluster.
Cliquez sur le nom du cluster que vous souhaitez dissocier, puis sélectionnez Afficher plus de détails dans le panneau latéral.
En haut de la fenêtre, cliquez sur Supprimer.
Lorsque vous êtes invité à confirmer l'opération, saisissez le nom du cluster, puis cliquez sur Confirmer.

Terraform

Pour annuler l'enregistrement d'un cluster GKE que vous avez enregistré à l'aide de Terraform, procédez comme suit :

Supprimez le bloc suivant de la configuration de la ressource google_container_cluster du cluster :

fleet {
      project = "FLEET_HOST_PROJECT""
    }

FLEET_HOST_PROJECT est l'ID du projet Google Cloud dans lequel votre cluster est enregistré.

Gérer l'agent Connect

Les étapes suivantes s'appliquent uniquement à l'annulation de l'enregistrement des clusters associés, où l'agent Connect est installé sur le cluster dans le cadre de l'enregistrement.

Facultatif : Vérifier que l'espace de noms de l'agent Connect est supprimé

Après avoir supprimé l'enregistrement d'un cluster, vous pouvez vérifier que l'espace de noms utilisé par Connect Agent a bien été supprimé. Cela s'applique uniquement aux enregistrements qui installent l'agent Connect. Pour cela, saisissez la commande :

kubectl get ns -l hub.gke.io/project

Si cette commande ne renvoie aucun résultat, l'espace de noms a déjà été supprimé.

Supprimer le compte de service de l'agent Connect

Si vous avez créé un compte de service pour l'agent Connect, vous pouvez le supprimer comme suit :

gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]

Annuler l'enregistrement d'un cluster non disponible

Pour annuler l'enregistrement d'un cluster auquel vous n'avez plus accès, procédez comme suit :

Répertoriez les clusters (appelés abonnements) actuellement enregistrés :
```
gcloud container fleet memberships list
```
Dans le résultat de la commande, la colonne Name répertorie le nom des abonnements des clusters enregistrés, tandis que la colonne EXTERNAL_ID répertorie les identifiants uniques des clusters de l'espace de noms kube-system.
Pour annuler l'enregistrement d'un cluster indisponible, exécutez la commande suivante :
```
gcloud container fleet memberships delete [MEMBERSHIP_NAME]
```
où [MEMBERSHIP_NAME] est le nom de l'abonnement correspondant au cluster.