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

Remover um complemento do Amazon EKS de um cluster

Você pode remover um complemento do Amazon EKS do seu cluster usando 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 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.

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

  • Versão 0.194.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 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, AWS Management Console 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 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 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 na documentação do eksctl.

Remover o complemento (Console do AWS)

  1. Abra o console do Amazon EKS.

  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 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.

    2. Insira o nome do complemento.

    3. Escolha Remover.

Remover o complemento (AWS CLI)

  1. Você precisa da versão 0.194.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 na documentação do eksctl.

  2. Veja uma lista de complementos instalados. Substitua 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"
    ]
}

  3. 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",
    }
}

  4. 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