Argo CD na prática (parte 2): conectando o GitHub e o primeiro deploy


Segunda parte da série sobre Argo CD: preparar o repositório da aplicação, conectar o GitHub ao Argo CD com uma chave SSH e fazer o primeiro deploy.

Fala pessoal, tudo bem?

Agora vamos para a parte 2 do nosso lab com Argo CD. Se você ainda não viu a parte 1, onde instalamos o Argo CD no cluster, vale passar lá antes.

1. O repositório da aplicação

O repositório que deixei criado para a nossa aplicação de teste está em github.com/jguandalini/argo-demo-app.

⚠️ Faça um fork do repositório para a sua conta. É no seu fork que vamos cadastrar a chave e, no próximo post, fazer os commits que disparam o deploy.

A estrutura da aplicação é a seguinte:

  • app/: as versões e os arquivos de construção da aplicação (Dockerfile, Nginx e páginas). O Argo CD não usa essa pasta, mas ela está lá para vocês conhecerem;
  • k8s/: os manifestos YAML. É daqui que o Argo CD lê o que precisa fazer de deploy;
  • argocd/application.yaml: a definição da aplicação no Argo CD, para quem preferir criá-la com kubectl apply -f em vez da interface;
  • README.md: explica como a aplicação toda funciona.
Esses arquivos precisam estar no seu repositório antes de irmos para o Argo CD. Se o repositório estiver vazio, o Argo CD avisa que não encontrou nada e não efetiva a conexão.

2. Gerando a chave SSH

Existe mais de uma maneira de conectar o repositório do GitHub ao Argo CD. No nosso lab, vamos gerar um par de chaves SSH e usá-lo para fazer essa conexão. No Linux:

$ ssh-keygen -f ~/.ssh/argocd_git -t rsa -b 4096 -C "j.guandalini@gmail.com"

Colocar uma senha para proteger a chave fica a seu critério. Se não quiser, basta ir dando Enter nas opções que aparecem.

Serão criados dois arquivos:

  • ~/.ssh/argocd_git: a chave privada, que vai para o Argo CD;
  • ~/.ssh/argocd_git.pub: a chave pública, que vai para o GitHub.

3. Cadastrando a chave pública no GitHub (Deploy Key)

Acesse o seu fork do argo-demo-app → Settings → Deploy keys → Add deploy key:

Para ver o conteúdo da chave pública:

$ cat ~/.ssh/argocd_git.pub

Vamos dar o nome de Git_ArgoCD e, em Key, colar o conteúdo da chave pública. Depois clique em Add key:

🚨 Muito cuidado aqui: no GitHub vai a chave pública, a que termina com .pub. A chave privada nunca deve ser colada no GitHub.
💡 Dica: deixe a opção Allow write access desmarcada. O Argo CD só precisa ler o repositório.

O GitHub pode pedir alguma confirmação de segurança, como senha ou código por e-mail.

Testando a chave (opcional)

Antes de ir para o Argo CD, dá para testar se a chave funciona. Adicionamos a chave privada ao ssh-agent da nossa máquina e testamos a conexão com o GitHub:

$ ssh-add ~/.ssh/argocd_git
$ ssh -T git@github.com

Veja que, no final, temos a mensagem de sucesso na conexão com o GitHub.

E se a minha máquina reiniciar? Não tem problema. Esse teste usa a chave só na sua máquina. O Argo CD não depende dela: quando conectarmos o repositório, a chave privada fica guardada dentro do cluster, como um Secret do Kubernetes. Por isso a integração continua funcionando mesmo que a sua máquina seja desligada.

4. Conectando o repositório no Argo CD

Aqui vamos usar a interface gráfica. Se você encerrou o port-forward da parte 1, rode novamente:

$ kubectl port-forward svc/argocd-server -n argocd 8080:443

Acesse https://localhost:8080, faça login e vá em Settings → Repositories:

Depois clique em + CONNECT REPO e escolha VIA SSH:

Preencha as informações. No campo da chave SSH, aqui no Argo CD vai a chave privada:

$ cat ~/.ssh/argocd_git
⚠️ Atenção ao formato da URL: via SSH, a URL do repositório é git@github.com:SEU_USUARIO/argo-demo-app.git, e não o endereço https://.

Clique em CONNECT. Se der tudo certo, o status da conexão aparece como Successful:

💡 Curiosidade: como o nosso repositório é público, o Argo CD conseguiria lê-lo até sem chave, pelo endereço https://. Usamos SSH porque é o cenário real de um repositório privado, que é o mais comum nas empresas.

5. Criando a aplicação no Argo CD

Conectar o repositório só diz ao Argo CD como acessar o Git. Para ele fazer o deploy, precisamos criar uma Application, dizendo qual pasta aplicar, qual branch acompanhar e em qual cluster e namespace.

Vá em Applications → + NEW APP. Os campos e as informações que vamos preencher são estes:

⚠️ Um detalhe muito importante: com o Sync Policy em Automatic, qualquer alteração na branch main do GitHub faz o Argo CD iniciar o deploy sozinho. Também podemos deixar como Manual: nesse caso, o Argo CD identifica a alteração e espera que a gente faça o sync.

Para o nosso lab, não tem problema deixar automático. Mas em ambientes de produção, de maior controle e complexidade, precisamos de mecanismos de teste antes de subir qualquer coisa de forma "muito automática" assim.

Assim que todos os campos estiverem preenchidos, clique em CREATE:

Veja que, como estava tudo "automático", o Argo CD já iniciou e, neste caso, concluiu o deploy da aplicação.

Se clicarmos no card da aplicação demo-app, teremos um "mapa" do que foi criado, além dos logs:

6. Testando a aplicação

Para finalizar o post de hoje, vamos ver se a aplicação subiu mesmo. Na linha de comando:

$ kubectl get pods -n demo-app

E por que temos 3 réplicas? Porque, se olharmos o arquivo k8s/deployment.yaml, é isso que estamos pedindo ao Kubernetes (replicas: 3).

Olhando os services, também temos o service que foi criado pelo Argo CD, de acordo com o que está no repositório:

$ kubectl get svc -n demo-app

Agora vamos acessar a aplicação. Neste caso, também vamos precisar de um port-forward:

$ kubectl port-forward -n demo-app svc/demo-app 9090:80

Ao acessarmos http://localhost:9090, o tráfego é direcionado, dentro do Kubernetes, para a porta 80 do service demo-app. Dando tudo certo, devemos ver a nossa aplicação:

Veja que tem uma informação um tanto quanto "grande" mostrando que estamos na versão v1.0. Isso vai ser importante para a próxima etapa.

Considerações Finais

Hoje conectamos o GitHub ao Argo CD e fizemos o primeiro deploy da aplicação, sem rodar nenhum kubectl apply dos manifestos: quem aplicou foi o Argo CD, lendo o Git.

No próximo post vem a parte mais legal: vamos atualizar a aplicação para a v1.1 só com um commit e ver o Argo CD fazendo o resto.

Abs e até a próxima!!!

:wq!

Comentários