Mejores Prácticas de Despliegue en Plataforma
Un resumen condensado de las 25 prácticas de despliegue en plataforma más importantes para equipos de Node.js, extraídas de cada página de esta sección.
//
Busca en todas las páginas de la documentación
Un resumen condensado de las 25 prácticas de despliegue en plataforma más importantes para equipos de Node.js, extraídas de cada página de esta sección.
Configuración de 12 factores: Variables de entorno + análisis Zod al inicio - Conceptos Básicos de Despliegue en Plataforma.
NODE_ENV=production en el orquestador: No solo en el Dockerfile.
Enlaza 0.0.0.0 y PORT: Requerido para contenedores.
Un proceso por contenedor: No PM2 dentro de los pods de K8s.
Réplicas sin estado: Sesiones y cargas en Redis/S3, no en el disco del pod.
Registros a stdout JSON: Sin añadidores de archivos en el contenedor.
Etiquetas de imagen inmutables: Despliega SHA desde CI - Mejores Prácticas de CI/CD.
Fase de lanzamiento para migraciones: Job/initContainer antes del despliegue del Deployment.
/health para liveness, /ready para readiness: DB en ready solo - Sondas de Salud y Preparación.
UID no root 1000: Coincide con Docker USER node.
Solicitudes de recursos de pruebas de carga: No copiar y pegar valores predeterminados - HPA y Límites de Recursos.
Margen de límite de memoria: 1.5-2x RSS p99 para picos de GC de Node.
HPA minReplicas ≥ 2: Alta disponibilidad para drenajes de nodos.
PDB minAvailable: Protege durante las actualizaciones del clúster.
Rolling maxUnavailable: 0: Sin caída de capacidad durante el despliegue - Despliegues sin Tiempo de Inactividad.
preStop sleep + manejador SIGTERM: Drena HTTP en curso.
ConfigMap para no secretos, Secret para credenciales: - ConfigMaps y Secrets.
External Secrets para rotación: Sincronización SSM/Vault en el clúster.
Nunca registres valores de entorno secretos: Redacta en los serializadores.
Terminación TLS de Ingress: cert-manager o certificados de balanceador de carga en la nube.
Deployment de worker separado: Escala los consumidores de cola de forma independiente.
Documenta la ADR de elección de plataforma: K8s vs ECS vs Cloud Run con fecha de revisión.
Prueba de humo después de cada despliegue: /health + un flujo de negocio.
Reversión = SHA de imagen anterior: Documentado en menos de 15 minutos.
Paridad dev/prod: Misma imagen de Node 24 localmente a través de compose y en producción.
Valida toda la configuración al inicio con un único módulo Zod y haz que el pod falle si es inválido. Evita el tráfico de producción medio configurado.
Fargate o Cloud Run si es nativo de AWS/GCP y tienes de uno a tres servicios. K8s cuando varios equipos comparten una plataforma o necesitan operadores.
Alternadores no sensibles en el entorno de ConfigMap. Flags de producto en un servicio dedicado (LaunchDarkly) cuando se requiere una segmentación dinámica.
Mínimo: desarrollo, staging, producción. Vistas previas opcionales por PR - Entornos de Vista Previa.
GitOps (Argo/Flux) para el registro de auditoría; pipeline kubectl es aceptable para equipos pequeños con disciplina.
Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS Activo), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.
Revisado por Chris St. John·Última actualización: 19 jul 2026