-
Verificar Pré-requisitos:
# Verificar variáveis de ambiente env | grep -E "JWT__SIGNINGKEY|CORS__ALLOWEDORIGINS|ConnectionStrings" # Verificar health checks curl https://api.Arah.com/health -
Executar Migrations:
dotnet ef database update --project backend/Arah.Infrastructure --startup-project backend/Arah.Api -
Deploy da Aplicação:
# Docker docker-compose up -d --build # Kubernetes kubectl apply -f k8s/ kubectl rollout status deployment/Arah-api -
Verificar Deploy:
# Health check curl https://api.Arah.com/health/ready # Verificar logs docker logs Arah-api --tail 100
Runbook de Operações - Arah
Este documento contém procedimentos operacionais para o sistema Arah.
🚀 Deploy
⏪ Rollback
Rollback Rápido
-
Identificar Versão Anterior:
git log --oneline -10 -
Rollback:
# Docker docker-compose down git checkout <commit-anterior> docker-compose up -d --build # Kubernetes kubectl rollout undo deployment/Arah-api -
Verificar Rollback:
curl https://api.Arah.com/health/ready
⚠️ ATENÇÃO: Rollback de migrations pode causar perda de dados. Sempre fazer backup antes.
# Listar migrations
dotnet ef migrations list --project backend/Arah.Infrastructure --startup-project backend/Arah.Api
# Rollback para migration específica
dotnet ef database update <MigrationName> --project backend/Arah.Infrastructure --startup-project backend/Arah.Api
📞 Escalação
-
Nível 1 - Equipe de Desenvolvimento
- Problemas de funcionalidade
- Bugs não críticos
- Melhorias
-
Nível 2 - DevOps/Infraestrutura
- Problemas de infraestrutura
- Performance degradada
- Problemas de deploy
-
Nível 3 - Emergência
- Sistema indisponível
- Perda de dados
- Segurança comprometida
🔧 Manutenção
Manutenção Programada
- Notificar Usuários (24h antes)
- Backup Completo
- Executar Manutenção
- Verificar Sistema
- Notificar Conclusão
Limpeza de Logs
# Logs são rotacionados automaticamente (30 dias)
# Limpeza manual se necessário:
find logs/ -name "*.log" -mtime +30 -delete
Limpeza de Cache
# Redis
redis-cli FLUSHDB
# IMemoryCache (reiniciar aplicação)
💾 Backup e Restore
Backup do Banco de Dados
# PostgreSQL
pg_dump -h localhost -U Arah -d Arah > backup_$(date +%Y%m%d_%H%M%S).sql
# Backup automático (cron)
0 2 * * * pg_dump -h localhost -U Arah -d Arah > /backups/araponga_$(date +\%Y\%m\%d).sql
Restore do Banco de Dados
# PostgreSQL
psql -h localhost -U Arah -d Arah < backup_20250115_020000.sql
Backup de Configuração
# Backup de appsettings.json e variáveis de ambiente
cp appsettings.Production.json appsettings.Production.json.backup
env | grep -E "JWT|CORS|ConnectionStrings" > env_backup.txt
🔍 Verificações Pós-Deploy
Checklist
- Health checks passando (
/health/ready) - Métricas sendo coletadas (
/metrics) - Logs sendo gerados corretamente
- Cache funcionando
- Database conectado
- Redis conectado (se configurado)
- Sem erros nos logs recentes
A aplicação possui uma interface web integrada para monitoramento e auxílio à produção.
Acesso: https://api.Arah.com/admin/monitoring (requer autenticação e autorização)
Funcionalidades:
- ✅ Dashboard principal com status geral
- ✅ Visualizador de logs em tempo real
- ✅ Métricas e dashboards interativos
- ✅ Health checks visuais
- ✅ Troubleshooting assistido
Ver documentação completa: LOGS_MONITORAMENTO_ARQUITETURA.md
- Arquitetura de Logs e Monitoramento:
LOGS_MONITORAMENTO_ARQUITETURA.md- Documentação completa sobre logs e monitoramento em diferentes arquiteturas, incluindo interface web - TROUBLESHOOTING.md - Troubleshooting comum
- INCIDENT_PLAYBOOK.md - Playbook de incidentes
- METRICS.md - Métricas disponíveis
- MONITORING.md - Dashboards e alertas
- FASE4.md - Fase 4: Observabilidade e Monitoramento
Última Atualização: 2026-01-28
Status: 📋 Runbook Completo - Atualizado com Interface Web