Rollback¶

Procedimentos de rollback de emergencia para o TepConfina.

Visao Geral¶

O rollback permite reverter rapidamente para uma versao anterior em caso de problemas apos o deploy.

flowchart TD
    A[Problema Detectado] --> B{Tipo}
    B -->|Aplicacao| C[Rollback ECS]
    B -->|Banco de Dados| D[Rollback Migration]
    C --> E[Smoke Test]
    E --> F{Passou?}
    F -->|Sim| G[Notificar Equipe]
    F -->|Nao| H[Escalar Incidente]
    D --> G

Rollback da Aplicacao (ECS)¶

Via GitHub Actions¶

O workflow rollback.yml permite rollback manual pelo GitHub:

name: Rollback
on:
  workflow_dispatch:
    inputs:
      environment:
        description: "Ambiente"
        required: true
        type: choice
        options:
          - staging
          - production
      image_tag:
        description: "Tag da imagem (commit SHA)"
        required: true
        type: string
      reason:
        description: "Motivo do rollback"
        required: true
        type: string

Como executar¶

1. Acesse Actions no repositorio tepconfina-api
2. Selecione o workflow Rollback
3. Clique em Run workflow
4. Preencha os campos:

1. Confirme a execucao

Etapas do Workflow¶

O workflow executa as seguintes etapas automaticamente:

1. Validacao: Verifica se a imagem com a tag informada existe no ECR
2. Update Service: Atualiza o ECS service para usar a imagem anterior
3. Wait for Stability: Aguarda o ECS estabilizar com a nova task
4. Smoke Test: Executa testes de saude nos endpoints criticos
5. Notificacao: Envia alerta via Slack/Email com detalhes do rollback

sequenceDiagram
    participant Dev as Desenvolvedor
    participant GH as GitHub Actions
    participant ECR as ECR
    participant ECS as ECS Fargate
    participant App as Aplicacao

    Dev->>GH: Trigger rollback (env, tag, motivo)
    GH->>ECR: Verificar imagem existe
    ECR-->>GH: Imagem encontrada
    GH->>ECS: Atualizar task definition
    ECS->>App: Iniciar nova task com imagem anterior
    App-->>ECS: Health check OK
    ECS-->>GH: Service estavel
    GH->>App: Smoke test endpoints
    App-->>GH: Testes passaram
    GH->>Dev: Notificacao de sucesso

Smoke Test¶

Apos o rollback, os seguintes endpoints sao verificados automaticamente:

Rollback de Banco de Dados¶

Via Script¶

./scripts/migrate.sh rollback

Procedimento Completo¶

1. Identificar a migration problematica

./scripts/migrate.sh status

1. Verificar o SQL de rollback

./scripts/migrate.sh dry-run

1. Fazer backup do banco

pg_dump -h <host> -U <user> -d tepconfina > backup_pre_rollback.sql

1. Executar o rollback

./scripts/migrate.sh rollback

1. Validar o estado do banco

./scripts/migrate.sh status

Identificando a Versao Estavel¶

Para encontrar o SHA do ultimo deploy estavel:

# Listar ultimos deploys via GitHub CLI
gh run list --workflow=deploy.yml --status=success --limit=5

Checklist de Rollback¶

• [ ] Identificar a causa raiz do problema
• [ ] Comunicar a equipe sobre o rollback
• [ ] Verificar se e necessario rollback de migration
• [ ] Executar rollback da aplicacao
• [ ] Validar smoke tests
• [ ] Verificar metricas no CloudWatch
• [ ] Documentar o incidente
• [ ] Planejar correcao definitiva