Migre de Runners GitHub Actions do AWS CodeBuild para o Latchkey
O CodeBuild hospeda runners do GitHub Actions dentro da sua conta AWS. O Latchkey os hospeda para você. Eis exatamente o que muda quando você migra.
De acordo com a documentação do AWS CodeBuild, rodar GitHub Actions no CodeBuild significa criar um projeto CodeBuild do tipo Runner, conectar o GitHub, configurar um webhook que filtra eventos WORKFLOW_JOB_QUEUED e direcioná-lo com um label runs-on no formato codebuild-<project>-${{ github.run_id }}-${{ github.run_attempt }}. Isso é poderoso se você está totalmente na AWS, mas você é dono do projeto, da IAM service role, da configuração de VPC e do webhook. O Latchkey roda os mesmos jobs em runners totalmente gerenciados e com autocorreção, acessados por uma mudança de runs-on de uma linha, sem conta AWS ou infraestrutura para operar. Veja como é uma migração.
Runners hospedados no CodeBuild vs Latchkey
| Capacidade | AWS CodeBuild (runner self-hosted) | Latchkey |
|---|---|---|
| Onde os runners ficam | Sua conta AWS | Totalmente gerenciado para você |
| Configuração | Projeto CodeBuild + IAM role + webhook | Troca de label runs-on de uma linha |
| Conta AWS / IAM / VPC necessários | Sim | Não |
| Webhook para configurar | Sim (WORKFLOW_JOB_QUEUED) | Não |
| Autocorreção (auto-retry de falhas transitórias) | Não | Sim |
| Integração profunda com AWS | Sim (IAM, VPC, serviços AWS) | Não é nativo da AWS |
| Mais conhecido por | Runners nativos da AWS que você opera | Runners gerenciados com autocorreção, sem setup AWS |
No que o CodeBuild é genuinamente bom
O CodeBuild é nativo da AWS. De acordo com a documentação do AWS CodeBuild, seus runners do GitHub Actions rodam dentro da sua conta com uma IAM service role e podem rodar na sua VPC para alcançar recursos como RDS ou ElastiCache. Se seus builds já assumem credenciais AWS, sub-redes privadas e limites IAM restritos, essa integração nativa é uma vantagem real e um bom motivo para permanecer.
O que você deixa de operar com o Latchkey
O Latchkey remove as peças que você configura e mantém na AWS: nenhum projeto CodeBuild do tipo Runner, nenhuma service role para escopar, nenhuma sub-rede de VPC e security group para ligar, e nenhum webhook WORKFLOW_JOB_QUEUED para depurar. O GitHub Actions enxerga um runner gerenciado, e falhas transitórias ou mecânicas fazem autocorreção e retry automaticamente em vez de falhar o job.
Como funciona a migração
- Escolha um workflow e mude seu runs-on do label codebuild-<project>-... para o label do Latchkey.
- Rode-o lado a lado com o caminho do CodeBuild e compare tempo total e confiabilidade em builds reais.
- Faça o rollout dos workflows restantes um label por vez; seu YAML, actions e steps permanecem iguais.
- Mantenha o CodeBuild para qualquer job que realmente precise de acesso AWS dentro da VPC, e mova o resto.
O veredito
Fique no CodeBuild para jobs que precisam de acesso AWS nativo dentro da VPC e IAM restrito. Para todo o resto, se operar um projeto CodeBuild, service role, VPC e webhook é mais do que você quer manter, o Latchkey oferece runners totalmente gerenciados com autocorreção e uma troca de runs-on de uma linha. Teste em um workflow e compare com seus builds reais do CodeBuild.