Argo CD na prática (parte 3): nova versão com um commit e rollback


Terceira e última parte da série sobre Argo CD: atualizar a aplicação para a v1.1 só com um commit no Git e, se algo der errado, fazer o rollback.

Fala pessoal, tudo bem?

Hoje finalmente vamos para a última parte do nosso lab de Kubernetes + GitHub + Argo CD.

No post anterior, conectamos o Argo CD ao repositório da nossa aplicação no GitHub e criamos a aplicação no Argo CD, que já fez o primeiro deploy. Ao final daquele lab, estávamos com a seguinte aplicação no ar:

1. Atualizando a aplicação para a v1.1

Lá na primeira postagem, comentei que o Argo CD acompanha o que está no Git: uma branch, uma tag ou um commit específico. Ou seja, o gatilho do deploy é uma mudança no repositório.

Se olharmos o arquivo k8s/deployment.yaml, temos uma linha com a imagem e a versão da nossa aplicação:

Agora vamos imaginar que o time de desenvolvimento fez uma alteração na aplicação e precisamos subir a versão 1.1. Basta editar esse arquivo, trocando a tag de 1.0 para 1.1, e salvar:

Lembrando que essa alteração ocorreu apenas no nosso diretório local. Agora precisamos enviá-la para o GitHub, afinal ele é o repositório oficial da nossa aplicação:

$ git add .
$ git commit -m "update aplicacao para versao 1.1"
$ git push origin main

Acessando a console do Argo CD e dando um Refresh na aplicação demo-app, ele identifica que algo mudou, faz o sync e começa o deploy:

💡 Por que o Refresh? Sem ele, o Argo CD também perceberia a mudança sozinho. Por padrão, ele confere o repositório a cada ~3 minutos. O Refresh só adianta essa checagem.

Assim que o deploy terminar, se rodarmos novamente:

$ kubectl get pods -n demo-app

Podemos ver que o AGE dos pods é recente e os nomes também mudaram. Já é tudo novo.

2. A prova real: acessando a v1.1

Mas a prova real mesmo é ver se o que foi pedido para mudar na aplicação foi mudado. Vamos fazer o port-forward novamente:

$ kubectl port-forward -n demo-app svc/demo-app 9090:80
Por que de novo? O port-forward fica "preso" a um pod. Como o deploy substituiu todos os pods, aquele que estava sendo usado deixou de existir e a conexão caiu.

Acessando a aplicação novamente em http://localhost:9090:

Se compararmos com a v1.0, tudo mudou: a cor, o texto grande com a versão, a lista de novidades e até o nome do pod em que o nosso acesso caiu.

💡 Repare no que aconteceu: ninguém rodou kubectl apply. Fizemos um commit e o Argo CD cuidou do resto. Essa é a essência do GitOps: o Git é a fonte da verdade, e o Argo CD faz a entrega contínua (o "CD") para o cluster Kubernetes.

Neste lab, a etapa de CI (integração contínua: build da imagem, testes etc.) eu fiz manualmente, deixando as imagens prontas no Docker Hub. Em um ambiente real, uma pipeline faria isso antes de atualizar o repositório.

3. E se a nova versão quebrar algo? Rollback

Agora, e se o deploy da aplicação trouxer algo errado ou quebrar alguma coisa? Dá para fazer rollback.

Pela console do Argo CD, clicando novamente na aplicação demo-app → HISTORY AND ROLLBACK, teremos uma lista dos deploys já feitos:

Basta clicar nos três pontinhos da versão anterior ao deploy que quebrou (ou de outra que faça sentido), clicar em Rollback e confirmar o retorno da versão:

⚠️ Leia a confirmação com atenção: com o Sync Policy em Automatic, o Argo CD avisa que precisa desligar o Auto-Sync para fazer o rollback. Faz sentido: se o Auto-Sync continuasse ligado, ele aplicaria de novo a v1.1 que está no Git e desfaria o rollback.

Assim que o rollback terminar, os pods vão estar com o AGE recente e com nomes novos:

Acessando novamente a aplicação (é preciso rodar o port-forward de novo):

De volta à v1.0. Só que aqui tem uma coisa muito importante de olharmos: o Argo CD vai ficar com um alerta de OutOfSync na aplicação:

E está certo: o cluster está rodando a v1.0, mas o Git continua dizendo v1.1. O Argo CD está avisando que os dois não batem.

Duas considerações para fecharmos o tema de rollback

  1. O Auto-Sync ficou desligado. Quando a correção for feita e enviada ao GitHub, o deploy não vai acontecer sozinho. Será preciso fazer o Sync manualmente ou religar o Auto-Sync (em App Details → Sync Policy).
  2. Cuidado com o botão SYNC. Se alguém vir o alerta de OutOfSync e clicar em SYNC para "arrumar", o Argo CD vai aplicar o que está no Git, ou seja, a v1.1 com problema de novo. Por isso, quem opera precisa saber o que aconteceu antes de agir.
O rollback "do jeito GitOps": outra forma de voltar a versão é desfazer o commit no próprio Git, com git revert HEAD && git push. Assim o Git volta a dizer v1.0, o Argo CD aplica sozinho e nada fica OutOfSync. O rollback pela console é ótimo para uma emergência, mas o Git precisa ser corrigido depois.

Enfim, aqui entra um pouco a forma como a sua operação de suporte, DevOps, produto etc. trabalha: quem pode fazer rollback, como isso é comunicado e como o Git é corrigido depois.

Algumas dúvidas que podem aparecer

  • Tudo rodou no nosso lab local com kind. Em produção, teremos mais alguns componentes em volta: testes, gestão de imagens Docker, pipelines de CI etc.;
  • Para o lab, deixei a aplicação pronta em duas imagens Docker (1.0 e 1.1), que estão públicas no meu Docker Hub;
  • O meu repositório argo-demo-app também é público, mas é importante você fazer o fork para poder subir alterações no seu próprio repositório e ter permissão de edição;
  • Tente criar um modelo de aplicação seu e simular o mesmo passo a passo.

Considerações Finais

E fechamos a série! Em três posts, saímos de um cluster vazio para um fluxo completo: Argo CD instalado, repositório conectado, deploy por commit e rollback quando algo dá errado.

Espero que todos tenham chegado até aqui e gostado do conteúdo.

Abs e até a próxima!!!

:wq!

Comentários