Upgrade Cluster EKS 1.21 para 1.22

Nesse artigo daremos um passo a passo para atualizar o seu AWS EKS da versão 1.21 para 1.22 utilizando a console da AWS e algumas considerações importantes.

Pré-Requisitos

  • Um cluster EKS
  • Sempre seguir uma documentação oficial

Aviso importante:

  • A configuração do cluster é exclusiva para laboratório e testes.

Vamos seguir os passos abaixo:

  1. Analisar APIs depreciadas
  2. Atualizar Cluster
  3. Atualizar Add-ons (Caso exista Addons gerenciados)
  4. Atualizar AMI´s
  5. Validação
  6. Referências

 

  1. Analisar APIs depreciadas

Conforme a documentação oficial do Kubernetes que pode ser acessada clicando aqui, algumas APIs na versão 1.22 serão descontinuadas. Para resolver esse problema precisamos fazer sua identificação e atualização.

Para identificar as APIs obsoletas utilizamos o comando kubent.
Exemplo da saída do kubent.

Para mais informações do kubent clique aqui.

Para converter as APIs obsoletas utilizamos o comando kubectl-convert, por exemplo:

kubectl-convert -f <file> –output-version <group>/<version>

Para mais informações sobre o kubectl-convert acesse documentação oficial (https://kubernetes.io/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis).

Após converter todas as API´s vamos para o próximo passo.

  1. Atualizar Cluster

Para atualização do cluster, acesse a console de gerenciamento da AWS, pesquise pelo serviço AWS EKS, entre no cluster que será atualizado.
Será exibido uma mensagem como a abaixo, clique em Upgrade Now.

Será exibido a tela que mostra as versões disponíveis para atualização, selecione a versão 1.22 e clique no botão Upgrade.

Agora podemos acompanhar a atualização no item Status, conforme o print abaixo.

A atualização leva em torno de 25 minutos.

Após a conclusão podemos ver que em Kubernetes version a versão já está a 1.22 e o Status o cluster está Active.

  1. Atualizar Add-ons (Caso exista Add-ons gerenciados)

Dentro do cluster, acesse o menu Add-ons, e clique em um dos 3 abaixo:
3.1 — Amazon VPC CNI

Clique um Update Version e selecione a versão mais atual disponível e clique em Save Changes.

Acompanhe a atualização.

Quando finalizar confirme a versão e se o Add-on está Active.

Para mais detalhes do upgrade deste Add-on e compatibilidade de versão acesse o link oficial clicando aqui.

Repita os mesmos passos nos Add-ons 3.2 e 3.3.

3.2 — CoreDNS

Para mais detalhes do upgrade deste Add-on e compatibilidade de versão acesse o link oficial clicando aqui.

3.3 — Kube-Proxy

Para mais detalhes do upgrade deste Add-on e compatibilidade de versão acesse o link oficial clicando aqui.

Para saber mais sobre os Add-ons, procure no item 6 o tema Amazon EKS add-ons.

Para saber mais sobre como confirmar qual versão está disponível, procure no item 6 o tema Managing Amazon EKS add-ons.

  1. Atualizar AMI´s

Acesse o cluster, menu ComputeNode Groups e localize o Node Group que será atualizado.
Em AMI release version, confirme a AMI que está e clique em Update Now.

Selecione o tipo de estratégia de upgrade, e clique em Update.

Acompanhamos o update pelo Status no Node Group.

Após finalizar a atualização, confirme se a versão da AMI está com a mesma versão do cluster e se o Status está Active.

Para mais informações sobre AMI, consulte no item 6 o tema Amazon EKS optimized Amazon Linux AMI versions.

  1. Validação

5.1 Validar Cluster
Para validar a versão selecione o cluster e consulte em Cluster Info o Kubernetes version e o Status.

5.2 Validar AMI

Confirme se a versão da AMI está com a mesma versão do cluster e se o Status está Active.

5.3 Validar Add-ons

Confirme de todos os 3 add-ons estão na versão compatível conforme documentação e com o Status Active.

  1. Referências