Remover um complemento do Amazon EKS de um cluster - Amazon EKS
Pré-requisitosProcedimento

Ajudar a melhorar esta página

Quer contribuir para este guia do usuário? Role até o final desta página e selecione Editar esta página no GitHub. Suas contribuições ajudarão a tornar nosso guia do usuário melhor para todos.

Remover um complemento do Amazon EKS de um cluster

É possível remover o complemento do Amazon EKS do cluster via eksctl, AWS Management Console 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 para a 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.

  • Verifique se o complemento exige um perfil do IAM. Para obter mais informações, consulte

  • Versão 0.191.0 ou posterior da ferramenta da linha de comando do eksctl instalada no dispositivo ou no AWS CloudShell. Para instalar ou atualizar o eksctl, consulte Instalação na documentação do eksctl.

Procedimento

É possível remover um complemento do Amazon EKS via eksctl, AWS Management Console ou AWS CLI. Se o complemento exigir um perfil do IAM, consulte os detalhes do complemento específico em Complementos do Amazon EKS disponíveis da AWS para obter detalhes sobre como criar o perfil.

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.

eksctl
Para remover um complemento do Amazon EKS usando eksctl

  1. Determine quais são os complementos instalados atualmente no cluster. Substitua o my-cluster pelo nome do cluster.

    eksctl get addon --cluster my-cluster

    Veja um exemplo de saída abaixo.

    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.

  2. Remova o complemento. Substitua my-cluster pelo nome do cluster e name-of-add-on pelo nome do complemento que você deseja remover, retornado na saída da etapa anterior. Se você remover a opção --preserve, além de o Amazon EKS deixar de gerenciar o complemento, o software complementar 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 na documentação do eksctl.

AWS Management Console
Para remover o complemento do Amazon EKS via AWS Management Console

  1. Abra o console do Amazon EKS em https://console.aws.amazon.com/eks/home#/clusters.

  2. No painel de navegação à esquerda, escolha Clusters.

  3. Escolha o nome do cluster para o qual você deseja remover o complemento do Amazon EKS.

  4. Escolha a guia Add-ons (Complementos).

  5. Escolha o complemento que deseja remover.

  6. Escolha Remover.

  7. Na caixa de diálogo de confirmação Remover: nome do complemento, 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.

    2. Insira o nome do complemento.

    3. Escolha Remover.

AWS CLI
Pré-requisito

Versão 0.191.0 ou posterior da ferramenta da linha de comando do eksctl instalada no dispositivo ou no AWS CloudShell. Para instalar ou atualizar o eksctl, consulte Instalação na documentação do eksctl.

Para remover o complemento do Amazon EKS via AWS CLI

  1. Veja uma lista de complementos instalados. Substitua o my-cluster pelo nome do cluster.

    aws eks list-addons --cluster-name my-cluster

    Veja um exemplo de saída abaixo.

    {
    "addons": [
        "coredns",
        "kube-proxy",
        "vpc-cni",
        "name-of-addon"
    ]
}

  2. Remova o complemento instalado. Substitua my-cluster pelo nome do cluster e name-of-add-on pelo nome do complemento que você deseja remover. A remoção de --preserve remove o software do complemento do 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",
[...]

  3. Verifique o status da remoção. Substitua my-cluster pelo nome do cluster e name-of-addon 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