CI/CD e Automação

Visão Geral

Automatize os portões de qualidade para que nenhuma mudança chegue à produção sem passar por testes, linting, verificação de tipos e build. CI/CD é o mecanismo de aplicação para todas as outras habilidades — ele captura o que humanos e agentes perdem, e faz isso consistentemente em cada mudança.

Shift Left (Antecipar): Capture problemas o mais cedo possível no pipeline. Um bug encontrado no linting custa minutos; o mesmo bug encontrado em produção custa horas. Mova as verificações para a montante — análise estática antes dos testes, testes antes do staging, staging antes da produção.

Mais Rápido é Mais Seguro: Lotes menores e lançamentos mais frequentes reduzem o risco, não o aumentam. Uma implantação com 3 mudanças é mais fácil de depurar do que uma com 30. Lançamentos frequentes constroem confiança no próprio processo de lançamento.

Quando Usar

• Configurando o pipeline de CI de um novo projeto
• Adicionando ou modificando verificações automatizadas
• Configurando pipelines de implantação
• Quando uma mudança deve acionar verificação automatizada
• Depurando falhas de CI

O Pipeline de Portões de Qualidade

Toda mudança passa por estes portões antes do merge:

Pull Request Opened
    │
    ▼
┌─────────────────┐
│   LINT CHECK     │  eslint, prettier
│   ↓ pass         │
│   TYPE CHECK     │  tsc --noEmit
│   ↓ pass         │
│   UNIT TESTS     │  jest/vitest
│   ↓ pass         │
│   BUILD          │  npm run build
│   ↓ pass         │
│   INTEGRATION    │  API/DB tests
│   ↓ pass         │
│   E2E (optional) │  Playwright/Cypress
│   ↓ pass         │
│   SECURITY AUDIT │  npm audit
│   ↓ pass         │
│   BUNDLE SIZE    │  bundlesize check
└─────────────────┘
    │
    ▼
  Ready for review

Nenhum portão pode ser pulado. Se o lint falhar, corrija o lint — não desabilite a regra. Se um teste falhar, corrija o código — não pule o teste.

Limite de Execução

Estes são templates separados para um projeto com os scripts nomeados e CLIs bloqueadas já instaladas. Fixe revisões de ações revisadas e use permissões de menor privilégio. Jobs de produção e preview precisam de sua própria identidade autorizada, destino e proteções de ambiente; PRs não confiáveis não devem receber segredos de implantação. Verifique a transferência de artefatos e o escopo de recuperação antes de aplicar. O auto-merge é opcional e deve seguir a política real de mantenedores do repositório.

Configuração do GitHub Actions

Pipeline Básico de CI

# .github/workflows/ci.yml
name: CI

on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

jobs:
  quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'

      - name: Install dependencies
        run: npm ci

      - name: Lint
        run: npm run lint

      - name: Type check
        run: npx tsc --noEmit

      - name: Test
        run: npm test -- --coverage

      - name: Build
        run: npm run build

      - name: Security audit
        run: npm audit --audit-level=high

Com Testes de Integração de Banco de Dados

  integration:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_DB: testdb
          POSTGRES_USER: ci_user
          POSTGRES_PASSWORD: ${{ secrets.CI_DB_PASSWORD }}
        ports:
          - 5432:5432
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5

    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'
      - run: npm ci
      - name: Run migrations
        run: npx prisma migrate deploy
        env:
          DATABASE_URL: postgresql://ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb
      - name: Integration tests
        run: npm run test:integration
        env:
          DATABASE_URL: postgresql://ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb

Nota: Mesmo para bancos de dados de teste apenas para CI, use Segredos do GitHub para credenciais em vez de codificar valores. Isso cria bons hábitos e evita o reuso acidental de credenciais de teste em outros contextos.

Testes E2E

  e2e:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'
      - run: npm ci
      - name: Instalar Playwright
        run: npx playwright install --with-deps chromium
      - name: Build

…