**Ajudar a melhorar esta página** 

Para contribuir com este guia de usuário, escolha o link **Editar esta página no GitHub**, disponível no painel direito de cada página.

# Cancelar o registro de um cluster do Kubernetes no console do Amazon EKS
<a name="deregister-connected-cluster"></a>

Se você terminou de usar um cluster conectado, pode cancelar seu registro. Depois que o registro for cancelado, o cluster não ficará mais visível no console do Amazon EKS.

É necessário ter estas permissões para chamar a API deregisterCluster:
+  `eks:DeregisterCluster` 
+  `ssm:DeleteActivation` 
+  `ssm:DeregisterManagedInstance` 

Esse processo envolve duas etapas: cancelar o registro do cluster no Amazon EKS e desinstalar o agente do eks-connector do cluster.

## Cancelar o registro de clusters do Kubernetes
<a name="deregister-connected-cluster-eks"></a>

Para cancelar o registro de um cluster do conector Amazon EKS, é possível usar uma destas ferramentas:
+  [AWS CLI](#awscli_deregister_cluster_connect) 
+  [Console de gerenciamento da AWS](#console_deregister_cluster_connect) 
+  [`eksctl`](#eksctl_deregister_cluster_connect) 

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

1.  AWS A CLI deve estar instalada. Para instalá-lo ou atualizá-lo, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html).

1. Certifique-se de que o perfil do agente do Amazon EKS Connector foi criado.

1. Cancele o registro do cluster conectado.

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

### Console de gerenciamento da AWS
<a name="console_deregister_cluster_connect"></a>

1. Abra o [console do Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).

1. Escolha **Clusters**.

1. Na página **Clusters**, selecione o cluster conectado e selecione **Deregister (Cancelar registro)**.

1. Confirme que você deseja cancelar o registro do cluster.

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

1. Instale a versão `eksctl` `0.68` ou posterior. Para obter informações sobre instalação ou upgrade, consulte [Conceitos básicos do Amazon EKS: `eksctl`](getting-started-eksctl.md).

1. Certifique-se de que o perfil do agente do Amazon EKS Connector foi criado.

1. Cancele o registro do cluster conectado:

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

## Limpar os recursos no cluster do Kubernetes
<a name="deregister-connected-cluster-k8s"></a>

Para desinstalar o agente `eks-connector`, use uma das seguintes ferramentas:
+  [helm](#helm_agent_cluster_deregister) 
+  [yaml](#yaml_agent_cluster_deregister) 

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

Execute o comando a seguir para desinstalar o agente.

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

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

1. Exclua o arquivo YAML do Amazon EKS Connector do cluster do Kubernetes.

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

1. Se você criou um `clusterrole` ou `clusterrolebindings` para outras [entidades principais do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal) visando fornecer acesso ao cluster, exclua-o do cluster do Kubernetes.