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.
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 comkubectl apply -fem vez da interface;README.md: explica como a aplicação toda funciona.
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:
.pub. A chave privada nunca deve ser colada no GitHub.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.
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
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:
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:
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
Postar um comentário