**Aidez à améliorer cette page** 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien **Modifier cette page sur** qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Désenregistrer un cluster Kubernetes depuis la console Amazon EKS
<a name="deregister-connected-cluster"></a>

Si vous n'utilisez plus un cluster, vous pouvez annuler son enregistrement. Après l’annulation de son enregistrement, le cluster n’est plus visible dans la console Amazon EKS.

Vous devez disposer des autorisations suivantes pour appeler l'API deregisterCluster :
+  `eks:DeregisterCluster` 
+  `ssm:DeleteActivation` 
+  `ssm:DeregisterManagedInstance` 

Ce processus comporte deux étapes : annulation de l'enregistrement du cluster auprès d'Amazon EKS et désinstallation de l'agent eks-connector dans le cluster.

## Désenregistrer le cluster Kubernetes
<a name="deregister-connected-cluster-eks"></a>

Pour désenregistrer un cluster du connecteur Amazon EKS, vous pouvez utiliser l’un des outils suivants :
+  [AWS CLI](#awscli_deregister_cluster_connect) 
+  [AWS Management Console](#console_deregister_cluster_connect) 
+  [`eksctl`](#eksctl_deregister_cluster_connect) 

### AWS CLI
<a name="awscli_deregister_cluster_connect"></a>

1.  La CLI AWS doit être installé. Pour l’installer ou la mettre à niveau, consultez [Installation de la CLI AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html).

1. Assurez-vous que le rôle d'agent Amazon EKS Connector est créé.

1. Annulez l'enregistrement du cluster connecté.

   ```
   aws eks deregister-cluster \
       --name my-cluster \
       --region region-code
   ```

### AWS Management Console
<a name="console_deregister_cluster_connect"></a>

1. Ouvrez la [console Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).

1. Choisissez **Clusters**.

1. Sur la page **Clusters**, sélectionnez le cluster connecté et sélectionnez **Deregister (Annuler l'enregistrer)**.

1. Confirmez que vous voulez annuler l'enregistrement du cluster.

### `eksctl`
<a name="eksctl_deregister_cluster_connect"></a>

1. Installez la `eksctl` version `0.68` ou une version ultérieure. Pour l'installer ou la mettre à niveau, veuillez consulter la rubrique [Démarrage avec Amazon EKS – `eksctl`](getting-started-eksctl.md).

1. Assurez-vous que le rôle d'agent Amazon EKS Connector est créé.

1. Annulez l’enregistrement du cluster connecté :

   ```
   eksctl deregister cluster --name my-cluster
   ```

## Nettoyez les ressources de votre cluster Kubernetes
<a name="deregister-connected-cluster-k8s"></a>

Pour désinstaller l’agent `eks-connector`, utilisez l’un des outils suivants :
+  [helm](#helm_agent_cluster_deregister) 
+  [yaml](#yaml_agent_cluster_deregister) 

### helm
<a name="helm_agent_cluster_deregister"></a>

Exécutez la commande suivante pour désinstaller l'agent.

```
helm -n eks-connector uninstall eks-connector
```

### yaml
<a name="yaml_agent_cluster_deregister"></a>

1. Supprimez le fichier YAML Amazon EKS Connector de votre cluster Kubernetes.

   ```
   kubectl delete -f eks-connector.yaml
   ```

1. Si vous avez créé `clusterrole` ou `clusterrolebindings` pour ajouter des [principaux IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal) supplémentaires pour accéder au cluster, supprimez-les de votre cluster Kubernetes.