← Voltar para o blog

william@devops:~$ cat ./lab/do-merge-ao-eks-github-app.md

Do merge ao EKS em 3 minutos,
sem PAT fixo na esteira.

Minha esteira já fazia deploy por GitOps, mas para escrever no repositório GitOps ela dependia de um token fixo, daqueles que alguém cria, esquece e um dia vaza ou expira no pior momento. Troquei por um GitHub App. Agora cada deploy ganha uma credencial que vale 1 hora e só abre uma porta.

DE ONDE VEIO

Isso aconteceu no meu laboratório de estudo em 16 de novembro de 2026. Os prints são reais; o ID da conta AWS foi removido.

01 / O PROBLEMA

O token que ninguém lembra que existe.

No GitOps, a esteira não faz deploy no cluster. Ela só muda uma linha num repositório: a tag da imagem. Só que, para escrever nesse repositório, ela precisa de uma credencial. O caminho mais comum é um token pessoal (PAT) guardado como secret. Funciona no primeiro dia. O problema aparece depois.

01

Vida longa

Um token de 90 dias que vaza continua funcionando por 90 dias. Ninguém fica sabendo.

02

Acesso demais

É comum o token enxergar mais repositórios do que precisa, porque restringir dá trabalho.

03

Preso a uma pessoa

O token é de alguém. Se essa pessoa sai da empresa, o deploy para junto.

04

Vence na hora errada

Expirou numa sexta às 18h? A esteira quebra no meio de uma entrega e alguém corre atrás de um token novo.

02 / A TROCA

Um crachá de visitante, não uma chave da casa.

Um GitHub App funciona como um crachá de visitante: ele é emitido na hora, vale por pouco tempo e só abre a porta que você liberou. A esteira não guarda token nenhum. A cada execução, ela pede ao GitHub uma credencial nova, que vence em 1 hora.

01

Uma permissão, um repositório

O App tem uma única permissão, Contents: Read and write, e está instalado só no repositório GitOps. Mesmo que alguém pegue o token no meio da execução, ele não abre nenhum outro repositório e não faz mais nada além de escrever arquivo. E em 1 hora deixa de existir.

02

O token nasce dentro da esteira

No workflow reutilizável que todas as APIs usam, entrou um passo que gera o token antes de atualizar o GitOps. A action oficial fica fixada pelo SHA do commit, não pela tag, para ninguém trocar o código dela por baixo.

deploy-eks-node.yml (trecho)v2.2.0
- name: Gerar token temporário do GitHub App
  id: app-token
  uses: actions/create-github-app-token@<sha-fixo> # v3.3.0
  with:
    client-id: ${{ inputs.gitops_app_client_id }}
    private-key: ${{ secrets.GITOPS_APP_PRIVATE_KEY }}
    owner: minha-org
    repositories: gitops          # só este repositório
    permission-contents: write    # só esta permissão

- name: Atualizar tag da imagem no kustomization.yaml
  env:
    GITOPS_TOKEN: ${{ steps.app-token.outputs.token }}  # vale 1 hora
03

Mudança compatível

Saiu como versão v2.2.0 do workflow. Quem ainda usa o token antigo continua funcionando; quem atualiza ganha o GitHub App. Nenhuma API precisou mudar no mesmo dia.

03 / NA PRÁTICA

O mesmo SHA, do merge ao pod.

Para provar, fiz uma mudança pequena na API (a mensagem da rota principal) e acompanhei o caminho inteiro. O fio da meada é o SHA do commit: 6ac2a8e. Ele aparece no merge, na imagem, no repositório GitOps e no pod.

  1. 01

    15:03 · Merge do PR em develop

    O merge gera o commit 6ac2a8e e dispara a esteira.

  2. 02

    15:05 · Esteira verde em 1m50s

    Qualidade, testes e dependências em paralelo, build, scan da imagem no Trivy, publicação no ECR e atualização do GitOps.

  3. 03

    15:05 · Commit do robô no GitOps

    O github-actions[bot] troca a tag da imagem para o SHA do merge. Uma linha.

  4. 04

    15:07 · Pod novo no EKS

    O Argo CD percebe o commit, sincroniza e o pod sobe com a imagem 6ac2a8e.

Execução do GitHub Actions com todas as etapas verdes, do preparo do ambiente até a atualização do GitOps, em 1 minuto e 50 segundos
A esteira do merge: qualidade, testes e dependências em paralelo, depois build, Trivy, ECR e GitOps. 1m50s no total.
Resumo da esteira com as etapas qualidade, testes, dependências, build, scan da imagem, push no ECR e GitOps, todas com sucesso
O resumo que a esteira escreve no fim: cada etapa com o seu status.
Commit do github-actions bot no repositório GitOps trocando a linha newTag para o SHA 6ac2a8e
O deploy inteiro é isto: o robô troca uma linha. Revisável, auditável e reversível com um git revert.
Argo CD com o app app-piloto-api-dev Healthy e Synced no commit 71abb5b, com dois pods novos rodando
O Argo CD sincronizado com o commit do robô (71abb5b): dois pods novos rodando, revisão 2 do Deployment.

04 / O DETALHE

Um erro que é sinal de saúde.

Nos eventos do pod novo apareceu um Readiness probe failed: connection refused. Parece problema, mas é o contrário. No primeiro segundo de vida, a API ainda está abrindo a porta. O Kubernetes pergunta se ela está pronta, ouve um não e simplesmente espera.

Enquanto isso, os pods da versão anterior continuam atendendo. O Deployment está configurado para nunca derrubar um pod antigo antes de o novo responder (maxUnavailable: 0). O cliente não percebe a troca.

05 / POR QUE IMPORTA

Em ambiente crítico, isso vira regra.

✓

Nenhuma credencial de longa duração a esteira não guarda token. Cada execução recebe um novo, que vence em 1 hora.

✓

Menor permissão possível o App só escreve arquivos, e só no repositório GitOps.

✓

A esteira não toca no cluster ela só muda uma linha no Git. Quem aplica é o Argo CD, de dentro do cluster.

✓

Auditoria pronta todo deploy é um commit, com autor, horário e diff de uma linha.

✓

Rollback em segundos voltar a versão é reverter a tag no Git e deixar o Argo CD sincronizar.

✓

Do merge ao pod em ~3 minutos sem ninguém rodar kubectl, sem ninguém entrar no Argo CD.

06 / APRENDIZADOS

O que eu levo dessa.

Automatizar o deploy é metade do caminho. A outra metade é garantir que a automação não vire a porta dos fundos: credencial curta, permissão mínima e um rastro claro de tudo que mudou. O GitHub App resolveu as três coisas de uma vez, e ainda tirou da minha lista a tarefa de lembrar quando o token vence.

william@devops:~$ echo $LESSON_LEARNED

"A melhor credencial é a que expira antes de alguém conseguir usar."
COMPARTILHAR IDEIAS

Quer trocar uma ideia sobre Cloud ou DevOps?

Mandar um e-mail ↗