**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.
# Remover um complemento do Amazon EKS de um cluster
Você pode remover um complemento do Amazon EKS do seu cluster usando `eksctl`, Console de gerenciamento da AWS ou AWS CLI.
Quando um complemento do Amazon EKS é removido de um cluster:
+ Não há tempo de inatividade para a funcionalidade que o complemento fornece.
+ Se estiver usando Perfis do IAM para contas de serviço (IRSA) e não houver um perfil do IAM associado ao complemento, o perfil do IAM não será removido.
+ Se você estiver usando identidades de pods, todas as associações de identidades de pods pertencentes ao complemento serão removidas. Se você especificar a opção `--preserve` na AWS CLI, as associações serão preservadas.
+ O Amazon EKS deixará de gerenciar as configurações do complemento.
+ O console deixará de notificar você quando novas versões estão disponíveis.
+ Você não poderá atualizar o complemento usando nenhuma das ferramentas ou APIs da AWS.
+ Você pode optar por deixar o software complementar no cluster para que ele seja autogerenciado ou pode remover o software complementar do cluster. Você só deverá remover o software complementar do cluster se não houver nenhum recurso no cluster que dependa da funcionalidade fornecida pelo complemento.
## Pré-requisitos
Antes de criar um complemento, faça o seguinte:
+ Um cluster existente do Amazon EKS. Para implantar, consulte [Começar a usar o Amazon EKS](getting-started.md).
+ Verifique se o complemento exige um perfil do IAM. Para obter mais informações, consulte
+ Versão `0.215.0` ou posterior da ferramenta de linha de comando da `eksctl` instalada no seu dispositivo ou AWS CloudShell. Para instalar ou atualizar o `eksctl`, consulte [Instalação](https://eksctl.io/installation) na documentação do `eksctl`.
## Procedimento
Você tem duas opções ao remover um complemento do Amazon EKS.
+ **Preserve add-on software on your cluster** (Preservar software de complemento no cluster): esta opção remove o gerenciamento do Amazon EKS de qualquer configuração. Também remove a capacidade do Amazon EKS de notificar você sobre atualizações e de atualizar automaticamente o complemento do Amazon EKS depois de iniciar uma atualização. No entanto, ele preserva o software de complemento em seu cluster. Essa opção torna o complemento em uma instalação autogerenciada, em vez de um complemento do Amazon EKS. Com essa opção, não há tempo de inatividade para o complemento.
+ **Remover completamente o software do complemento do cluster**: recomendamos remover o complemento do Amazon EKS do cluster se não houver recursos no cluster que dependam dele.
Você pode remover um complemento do Amazon EKS usando `eksctl`, Console de gerenciamento da AWS ou AWS CLI.
### Remover o complemento (eksctl)
1. Determine quais são os complementos instalados atualmente no cluster. Substitua *my-cluster* pelo nome do cluster.
```
eksctl get addon --cluster my-cluster
```
Veja abaixo um exemplo de saída.
```
NAME VERSION STATUS ISSUES IAMROLE UPDATE AVAILABLE
coredns v1.8.7-eksbuild.2 ACTIVE 0
kube-proxy v1.23.7-eksbuild.1 ACTIVE 0
vpc-cni v1.10.4-eksbuild.1 ACTIVE 0
[...]
```
Sua saída pode ser diferente, dependendo dos complementos e versões que você tiver no cluster.
1. Remova o complemento. Substitua *my-cluster* pelo nome do seu cluster e *name-of-complemento* pelo nome do complemento retornado na saída da etapa anterior que você deseja remover. Se você remover a opção *--preserve*, além de o Amazon EKS não gerenciar mais o complemento, o software do complemento será excluído do cluster.
```
eksctl delete addon --cluster my-cluster --name name-of-addon --preserve
```
Para obter mais informações sobre a remoção de complementos, consulte [Excluir complementos](https://eksctl.io/usage/addons/#deleting-addons) na documentação do `eksctl`.
### Remover o complemento (Console do AWS)
1. Abra o [console do Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).
1. No painel de navegação à esquerda, escolha **Clusters**.
1. Escolha o nome do cluster para o qual você deseja remover o complemento do Amazon EKS.
1. Escolha a guia **Add-ons** (Complementos).
1. Escolha o complemento que deseja remover.
1. Escolha **Remover**.
1. Na caixa de diálogo **Remover: *nome do complemento* de confirmação **, faça o seguinte:
1. Se quiser que o Amazon EKS pare de gerenciar as configurações do complemento, selecione **Preservar no cluster**. Faça isso se quiser manter o software de complemento em seu cluster. Isso serve para que você possa gerenciar todas as configurações do complemento por conta própria.
1. Insira o nome do complemento.
1. Escolha **Remover**.
### Remover o complemento (AWS CLI)
1. Você precisa da versão `0.215.0` ou posterior da ferramenta de linha de comando da `eksctl` instalada no seu dispositivo ou AWS CloudShell. Para instalar ou atualizar o `eksctl`, consulte [Instalação](https://eksctl.io/installation) na documentação do `eksctl`.
1. Veja uma lista de complementos instalados. Substitua *my-cluster* pelo nome do cluster.
```
aws eks list-addons --cluster-name my-cluster
```
Veja abaixo um exemplo de saída.
```
{
"addons": [
"coredns",
"kube-proxy",
"vpc-cni",
"name-of-addon"
]
}
```
1. Remova o complemento instalado. Substitua *my-cluster* pelo nome do seu cluster e *name-of-complemento* pelo nome do complemento que você deseja remover. A remoção de *--preserve* exclui o software complementar do seu cluster.
```
aws eks delete-addon --cluster-name my-cluster --addon-name name-of-addon --preserve
```
Veja o exemplo de saída abreviado abaixo.
```
{
"addon": {
"addonName": "name-of-add-on",
"clusterName": "my-cluster",
"status": "DELETING",
}
}
```
1. Verifique o status da remoção. Substitua *my-cluster* pelo nome do seu cluster e *name-of-complemento* pelo nome do complemento que você está removendo.
```
aws eks describe-addon --cluster-name my-cluster --addon-name name-of-addon
```
Após a exclusão do complemento, a saída de exemplo será semelhante a esta.
```
An error occurred (ResourceNotFoundException) when calling the DescribeAddon operation: No addon: name-of-addon found in cluster: my-cluster
```