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 build
  • npm ci em vez de npm 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 main exigindo 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 }}
Onde fica cada coisa
TipoExemploOnde guardar
Configuração públicaURL da API, nível de logVariáveis do ambiente ou arquivo versionado
SegredoSenha do banco, chave de APISecrets da CI ou um cofre de segredos
Exemplo para quem chegaNomes das variáveis, sem valores.env.example versionado
Valores locaisSua chave de desenvolvimento.env fora do Git, no .gitignore

Um pipeline em que dá para confiar

Sintomas e o que fazer
SintomaO que fazer
A CI demora mais de 10 minutosCache 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çãoMesma versão de runtime, mesmas variáveis, mesmo artefato nos dois
Ninguém sabe o que foi publicadoMarque o artefato com o hash do commit e registre cada publicação
  • Todo pull request roda lint, tipos, testes e build.
  • A main só 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.

Referências

Trilhas relacionadas