Diretrizes DevOps

Aplique apenas seções relevantes para a carga de trabalho/provedor/ambiente/critérios de aceitação. Pule Docker, Kubernetes, mobile, produção, rollback, saúde, feature-flag, verificações de segurança quando não aplicável.

Estratégia de Implantação

• Contínua (padrão): substituição gradual, sem tempo de inatividade.
• Blue-green: ambientes duplicados, corte atômico, rollback instantâneo, 2x infra.
• Canary: roteia pequena % primeiro; requer divisão de tráfego.

Docker

• Fixe tags de imagem base (node:22-alpine); NUNCA :latest.
• Builds multi-stage + usuário não root. Copie dependências primeiro para cache.
• .dockerignore: node_modules, .git, testes. Defina HEALTHCHECK + limites de recursos.

Kubernetes

Configure probes de inicialização, prontidão e vivacidade com atrasos iniciais/limiares apropriados para a carga de trabalho.

CI/CD

• PR: lint -> typecheck -> unit -> integration -> preview.
• Main: build -> staging -> smoke -> production.

Saúde e Desligamento

• Simples: GET /health -> { "status": "ok" }.
• Detalhado: dependências, tempo de atividade, versão.
• Serviços DEVEM expor saúde significativa + lidar graciosamente com SIGTERM quando a carga de trabalho exigir.

Configuração

Use variáveis de ambiente (Twelve-Factor), separadas por ambiente. Valide na inicialização + falhe rapidamente. NUNCA comite segredos ou codifique NODE_ENV=production.

Rollback

• Kubernetes: kubectl rollout undo.
• Vercel: vercel rollback.
• Docker: reimplantar imagem fixada anterior.

Feature Flags

• Ciclo de vida: criar -> habilitar -> 5% -> 25% -> 50% -> 100% -> remover flag + código morto.
• Cada flag DEVE ter proprietário, expiração, gatilho de rollback. Remover em até duas semanas.

Checklists

• Pré-implantação: testes passando, revisão de código, variáveis de ambiente, migrações, plano de rollback.
• Pós-implantação: saudável, monitorado, pods antigos terminados, resultado documentado.
• Produção: testes passando; sem segredos codificados; logs JSON; saúde significativa; versões fixadas; variáveis de ambiente validadas; limites de recursos; TLS; scan CVE; CORS; rate limiting; CSP/HSTS/X-Frame-Options; rollback testado; runbook; on-call.
• Aplique verificações de segurança/CVE a cargas de trabalho executáveis ou sensíveis à segurança.

Implantação Mobile

• EAS: eas build:configure; eas build -p ios|android --profile preview; eas update --branch production; --auto-submit.
• Fastlane: iOS match/cert/sigh/pilot; Android Gradle/supply.
• Credenciais em env/armazenamento de segredos, nunca Git. Automatize a assinatura iOS com fastlane match; use keytool + Google Play App Signing para Android.
• TestFlight: interno instantâneo; externo 90 dias/100 testadores. Google Play: interno/beta/produção. Espere 1–7 dias de revisão.
• Rollback: EAS eas update:rollback; release nativo -> reverter build; release da loja -> reduzir rollout faseado.