Objetivo: 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
Avisos importantes
- A configuração do cluster é exclusiva para laboratório e testes.
Vamos seguir os passos abaixo:
- Analisar APIs depreciadas
- Atualizar Cluster
- Atualizar Add-ons (Caso exista Addons gerenciados)
- Atualizar AMI´s
- Validação
- Referências
Let's go to work!
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 [nesse link].(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.
2. 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.
3. 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.
4. Atualizar AMI´s
Acesse o cluster, menu Compute, Node 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 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.
5. 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 compativel conforme documentação e com o Status Active.
6. Referências
Oldest comments (0)