DevOps e CI/CD (Integração e Entrega Contínua)

O que é

• DevOps é cultura de colaboração entre dev e ops, apoiada em automação, monitoramento e feedback rápido.
• CI (Integração Contínua): cada alteração dispara build e testes automatizados no repositório.
• CD (Entrega/Deploy Contínuo): código aprovado segue para homologação e produção de forma repetível.
• No RF-012, a pipeline deve rodar testes de RN-004, integração da API exportar-pdf e E2E antes do merge.

Componentes de uma pipeline

• Gatilho: push, pull request, tag de release ou agendamento.
• Etapas típicas: checkout → lint → build → testes unitários → testes integração → artefato → deploy.
• Ambientes: dev → homolog → prod, com aprovação manual ou gates automáticos.
• Ferramentas: GitHub Actions, GitLab CI, Jenkins, Azure DevOps, CircleCI.
• Containers (Docker) padronizam runtime; Kubernetes orquestra em escala.

Exemplo visual — pipeline CI/CD

• Fluxo da feature exportar PDF desde o commit até produção.

Boas práticas

• Pipeline como código (YAML versionado no repo).
• Falha rápida: testes unitários antes dos E2E lentos.
• Secrets via vault/GitHub Secrets — nunca hardcoded.
• Branch protection: PR obrigatório + pipeline verde.
• Observabilidade pós-deploy: métricas, logs e rollback plan.

Modelo textual — definição de pipeline (YAML resumido)

• Esboço de workflow GitHub Actions para a API de exportação.

────────────────────────────────────────────────────────────
PIPELINE CI — ESBOÇO (GitHub Actions)
────────────────────────────────────────────────────────────

Nome:            ci-exportar-pdf
Gatilho:         push e pull_request na branch main
Escopo:          RF-012, US-018, módulo atividades

Jobs:
  1. lint
     - npm run lint / phpcs / eslint conforme stack

  2. test-unit
     - validarPeriodoConsulta (RN-004)
     - gerador PDF mockado

  3. test-integration
     - POST /api/atividades/exportar-pdf com banco de teste
     - assert status 200 + Content-Type application/pdf

  4. test-e2e (homolog, opcional no PR)
     - CT-012-01 a CT-012-05

Critério merge:
  - Todos os jobs verdes
  - Revisão de código aprovada

Deploy produção:
  - Tag v* ou merge main → CD homolog → smoke → CD prod
  - Rollback: redeploy tag anterior