Como faço para atualizar os complementos do Amazon EKS?

Resolução

Observação: se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Verifique as versões complementares que você pode usar

Para identificar as versões dos complementos que você pode usar para sua versão de cluster do Amazon EKS, execute o seguinte comando describe-addon-versions da AWS CLI:

aws eks describe-addon-versions --kubernetes-version=cluster-version --addon-name=addon-name --query='addons[].addonVersions[].addonVersion'

Observação: substitua cluster-version pela versão Kubernetes do seu cluster Amazon EKS. Além disso, substitua addon-name pelo nome do complemento, como vpc-cni ou coredns.

Atualize os complementos

Se seus complementos tiverem configurações personalizadas ou recursos diferentes das configurações padrão, você poderá encontrar conflitos ao atualizar. Para resolver esses problemas, use a AWS CLI e a opção --resolve-conflicts para atualizar seus complementos. É uma prática recomendada testar o processo de upgrade em um ambiente que não seja de produção antes de aplicá-lo ao cluster de produção. Para obter mais informações, consulte Como evito conflitos de configuração ao criar ou atualizar meus complementos gerenciados pelo Amazon EKS?

Para atualizar os complementos, use eksctl, o console Amazon EKS ou a AWS CLI.

Verifique a atualização

Use o comando kubectl para verificar o status das implantações complementares e garantir que os pods estejam executando a nova versão. Para complementos daemonset, como vpc-cni e kube-proxy, verifique se o número de réplicas é igual ao número de nós. Os complementos vpc-cni e kube-proxy não são executados nos nós do AWS Fargate ou do Windows.

Por exemplo, execute o comando a seguir para verificar a versão atual da implantação do CoreDNS:

kubectl describe deployment coredns -n kube-system | grep Image | cut -d ":" -f 3

Ou conclua as etapas a seguir para verificar os detalhes do complemento no console do Amazon EKS:

1. Abra o console do Amazon EKS.
2. No painel de navegação, escolha Clusters.
3. Escolha seu cluster.
4. Escolha a guia Complementos.
5. Para ver a nova versão, verifique o valor na coluna Versão do complemento.

Para verificar os logs dos pods complementares em busca de erros ou problemas que ocorreram durante o processo de atualização, execute o seguinte comando:

kubectl logs -n kube-system -l k8s-app=kube-dns

Execute testes adicionais

Para determinar se seu complemento exige testes adicionais após uma atualização, consulte a documentação dos complementos para obter as práticas recomendadas. Também é uma prática recomendada testar complementos que gerenciam os principais serviços, como redes ou resolução de DNS. Se você adicionou configurações personalizadas ao seu complemento, certifique-se de que suas configurações ainda funcionem conforme o esperado após a atualização.

Para testar o complemento da Interface de Rede de Contêiner (CNI) da Amazon Virtual Private Cloud (Amazon VPC), crie um novo pod para validar a atribuição de endereço IP. Para o complemento CoreDNS, use o comando exec para entrar no pod e, em seguida, use ferramentas como nslookup para validar a resolução do DNS.

Informações relacionadas

Atualize o complemento autogerenciado CoreDNS Amazon EKS

Atualize o Amazon VPC CNI (complemento Amazon EKS)

Gerencie o CoreDNS para DNS em clusters do Amazon EKS