Melhores Práticas de Operações em Tempo de Execução

Um resumo condensado das 25 práticas de operações em tempo de execução mais importantes para equipes Node.js - extraídas de todas as páginas desta seção.

Como Usar Esta Lista

• Vincule cada página wiki de serviço ao comando de rollback e ao proprietário
• Execute um game day trimestral usando Iniciadores de Runbook On-Call
• Emparelhe com Melhores Práticas de Implantação de Plataforma para configurações de implantação

1. Desligamento gracioso SIGTERM: server.close() e depois feche os pools - Desligamento Gracioso.

2. Falhar na prontidão durante o esvaziamento: 503 em /ready durante o desligamento.

3. preStop + esvaziamento do aplicativo alinhados: K8s dorme antes do SIGTERM - Implantações Sem Interrupção.

4. Tempo limite de saída forçada: Sair com 1 se o esvaziamento exceder o período de graça.

5. Política de uncaughtException documentada: Saída padrão para APIs HTTP - Noções Básicas de Operações em Tempo de Execução.

6. unhandledRejection -> sair: O mesmo que uncaught para serviços de API.

7. Sem PM2 dentro do K8s: Um processo por contêiner; a plataforma escala réplicas.

8. PM2/systemd apenas em VMs: Quando não conteinerizado - PM2 & systemd.

9. Vincular 0.0.0.0: Evita que o LB 502 se conecte apenas ao localhost.

10. Logs para stdout JSON: requestId, método, caminho, status, duração.

11. Nunca registrar segredos ou corpos completos: Conformidade com PII.

12. NODE_OPTIONS --max-old-space-size: ~75% do limite de memória do contêiner.

13. Margem de limite de memória: Investigação de OOMKill antes de aumentar o limite cegamente.

14. Solução de problemas de CPU: Distinguir pico de tráfego vs implantação vs loop apertado.

15. Reverter primeiro quando a implantação estiver correlacionada: kubectl rollout undo ou SHA anterior.

16. Separar triagem de liveness e readiness: 502 frequentemente readiness ou drain.

17. Tempo limite do ALB/Ingress > p99 do aplicativo: Impede proxy 502 em solicitações lentas.

18. Fechar BullMQ/Redis/cron no desligamento: Não apenas o servidor HTTP.

19. NestJS enableShutdownHooks: Ordem de destruição do módulo.

20. Hooks onClose do Fastify: Limpeza de pool e Redis.

21. Log de inicialização com versão do Node e pid: Confirma a imagem correta após a implantação.

22. Runbooks on-call mantidos: Iniciadores de CPU alta, memória e 502 atualizados após incidentes.

23. Postmortems sem culpa: Itens de ação rastreados no sistema de tickets.

24. Monitoramento sintético: Sonda /health de 1 minuto de fora do cluster.

25. Não perfilhar produção casualmente: Reproduzir em staging com replay de carga.

FAQs

Relacionados

• Noções Básicas de Operações em Tempo de Execução - introdução à supervisão
• Desligamento Gracioso - padrão SIGTERM
• Implantações Sem Interrupção - implantações contínuas
• Iniciadores de Runbook On-Call - triagem de incidentes
• Melhores Práticas Docker - lista de verificação de imagem e sonda

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.