CI/CD com GitHub Actions
Um pipeline comentado, onde guardar configuração e segredos e como manter a CI rápida e confiável.
7 min de leitura · Iniciante · Revisado em
CI e CD em uma frase cada
- Integração contínua (CI)
- A cada push ou pull request, um servidor instala, compila e testa o projeto do zero. Quebrou, todo mundo sabe em minutos.
- Entrega contínua (CD)
- O que passou na CI fica sempre pronto para publicar, com um clique ou automaticamente.
- Pipeline
- A sequência de etapas, cada uma só começa se a anterior passou.
Um pipeline típico: do mais rápido ao mais caro
- Publicar: Gera o artefato, publica e confere se o serviço respondeu.
- Testes de integração e ponta a ponta: Com banco e navegador reais.
- Testes de unidade: Segundos. Pegam a maioria das regressões.
- Lint, formatação e tipos: Falham primeiro e mais barato.
Um workflow do GitHub Actions comentado
.github/workflows/ci.yml
name: CI
on:
pull_request:
push:
branches: [main]
jobs:
verificar:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm # reaproveita downloads
- run: npm ci # instala exatamente o lockfile
- run: npm run lint
- run: npx tsc --noEmit
- run: npm test -- --run
- run: npm run buildnpm ciem vez denpm install: usa o lockfile e falha se ele estiver desatualizado.- Uma etapa com erro interrompe o job e marca o pull request com um X vermelho.
- Proteja a
mainexigindo que esse job passe antes do merge.
Configuração e segredos
Segredos vêm do cofre do repositório, nunca do código
- run: npm run deploy
env:
DATABASE_URL: ${{ secrets.DATABASE_URL }}
API_KEY: ${{ secrets.API_KEY }}| Tipo | Exemplo | Onde guardar |
|---|---|---|
| Configuração pública | URL da API, nível de log | Variáveis do ambiente ou arquivo versionado |
| Segredo | Senha do banco, chave de API | Secrets da CI ou um cofre de segredos |
| Exemplo para quem chega | Nomes das variáveis, sem valores | .env.example versionado |
| Valores locais | Sua chave de desenvolvimento | .env fora do Git, no .gitignore |
Um pipeline em que dá para confiar
| Sintoma | O que fazer |
|---|---|
| A CI demora mais de 10 minutos | Cache de dependências, jobs em paralelo, testes lentos só na main |
| Teste que falha "às vezes" | Trate como bug: isole, corrija ou remova. Não normalize rodar de novo |
| Passa na CI e falha em produção | Mesma versão de runtime, mesmas variáveis, mesmo artefato nos dois |
| Ninguém sabe o que foi publicado | Marque o artefato com o hash do commit e registre cada publicação |
- Todo pull request roda lint, tipos, testes e build.
- A
mainsó aceita merge com a CI verde. - Instalação reprodutível com lockfile e
npm ci. - Nenhum segredo no código ou nos logs.
- O que é publicado é o mesmo artefato que foi testado.
- Existe um jeito documentado de voltar para a versão anterior.