Melhores Práticas de Implantação de Plataforma
Um resumo condensado das 25 práticas de implantação de plataforma mais importantes para equipes Node.js - extraídas de todas as páginas desta seção.
//
Busque em todas as páginas da documentação
Um resumo condensado das 25 práticas de implantação de plataforma mais importantes para equipes Node.js - extraídas de todas as páginas desta seção.
Configuração 12-factor: Variáveis de ambiente + parse Zod na inicialização - Noções Básicas de Implantação de Plataforma.
NODE_ENV=production no orquestrador: Não apenas no Dockerfile.
Bind 0.0.0.0 e PORT: Necessário para contêineres.
Um processo por contêiner: Sem PM2 dentro de pods K8s.
Réplicas stateless: Sessões e uploads em Redis/S3, não no disco do pod.
Logs para stdout JSON: Sem appenders de arquivo no contêiner.
Tags de imagem imutáveis: Implante o SHA do CI - Melhores Práticas de CI/CD.
Fase de release para migrações: Job/initContainer antes do rollout do Deployment.
/health liveness, /ready readiness: DB apenas em ready - Probes de Saúde e Prontidão.
UID 1000 não-root: Corresponde ao USER node do Docker.
Requisições de recursos de testes de carga: Não cópia de padrões - HPA & Limites de Recursos.
Headroom de limite de memória: 1.5-2x RSS p99 para picos de GC do Node.
minReplicas HPA ≥ 2: HA para drenagens de nó.
minAvailable PDB: Protege durante upgrades de cluster.
Rolling maxUnavailable: 0: Sem queda de capacidade durante a implantação - Implantações Zero-Downtime.
Sleep preStop + handler SIGTERM: Drena HTTP em andamento.
ConfigMap para não-segredos, Secret para credenciais: - ConfigMaps & Secrets.
External Secrets para rotação: Sincroniza SSM/Vault para dentro do cluster.
Nunca registrar valores de env de segredos: Redigir em serializadores.
Terminação TLS do Ingress: cert-manager ou certificados de LB da nuvem.
Deployment de worker separado: Escala consumidores de fila independentemente.
Documentar a escolha da plataforma ADR: K8s vs ECS vs Cloud Run com data de revisão.
Smoke test após cada implantação: /health + um fluxo de negócios.
Rollback = SHA da imagem anterior: Documentado em menos de 15 minutos.
Paridade dev/prod: Mesma imagem Node 24 localmente via compose e em produção.
Valide toda a configuração na inicialização com um único módulo Zod e falhe o pod se inválido. Evita tráfego de produção parcialmente configurado.
Fargate ou Cloud Run se nativo AWS/GCP e um a três serviços. K8s quando várias equipes compartilham uma plataforma ou precisam de operadores.
Flags não sensíveis no env do ConfigMap. Flags de produto em um serviço dedicado (LaunchDarkly) quando o direcionamento dinâmico é necessário.
Mínimo: dev, staging, produção. Previews opcionais por PR - Ambientes de Preview.
GitOps (Argo/Flux) para trilha de auditoria; pipeline kubectl aceitável para equipes pequenas com disciplina.
Versões da Stack: Esta página foi escrita para Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5, e NestJS 11.
Revisado por Chris St. John·Última atualização: 19 de jul. de 2026