Tema 16 · PM2 & Despliegue VPS

16. Despliegue en Producción: Gestión de Procesos con PM2, Reverse Proxy Nginx y VPS

Prepara tu aplicación Node.js para producción en servidores VPS: reinicios automáticos y modo cluster con PM2, configuración de proxy inverso con Nginx y variables NODE_ENV.

El Reto de Ejecutar Node.js en Servidores de Producción

En tu máquina de desarrollo basta con ejecutar node server.js. Sin embargo, en un servidor de producción VPS (como las instancias de Kilopolis en OVH), esta estrategia es inaceptable por dos razones críticas:

  1. Si cierras la sesión SSH en la terminal, el proceso se mata de inmediato.
  2. Si la aplicación sufre una excepción no controlada o el servidor se reinicia, el proceso muere y tus usuarios se encontrarán con el servicio caído.

PM2: El Gestor de Procesos de Nivel Empresarial

PM2 (Production Process Manager) es la herramienta estándar para mantener aplicaciones Node.js vivas para siempre (24/7), recargarlas sin tiempo de inactividad (Zero-Downtime Reloads) y facilitar el monitoreo de CPU y memoria.

# 1. Instalar PM2 de forma global en el VPS
npm install -g pm2

# 2. Iniciar la aplicación asignándole un nombre legible
pm2 start src/server.js --name "kilopolis-api"

# 3. Iniciar en Modo Cluster aprovechando todos los núcleos de la CPU
pm2 start src/server.js -i max --name "kilopolis-api-cluster"

# 4. Listar procesos y monitorear telemetría
pm2 status
pm2 monit
pm2 logs kilopolis-api --lines 50

Persistencia tras Reinicio del VPS

Para que tus servicios de Node.js arranquen automáticamente si el servidor VPS se reinicia por mantenimiento o corte de energía:

# Genera el script de inicio para el gestor systemd de Linux
pm2 startup

# Guarda la lista actual de procesos en ejecución
pm2 save

Arquitectura con Proxy Inverso Nginx

Nunca expongas el puerto de Node (ej. 3000) directamente a internet. La práctica recomendada en servidores VPS es colocar Nginx como Reverse Proxy en el puerto 80/443. Nginx se encarga de negociar el cifrado SSL (HTTPS con Let's Encrypt), comprimir respuestas con Gzip y reenviar las peticiones a la aplicación interna de Node:

server {
    server_name api.kilopolis.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

⚡ Archivo de Configuración para PM2: ecosystem.config.cjs

Configuración declarativa para orquestar despliegues, variables de entorno y modo cluster:

ecosystem.config.cjs
Solo lectura
// ecosystem.config.cjs - Configuración Oficial de Despliegue con PM2
module.exports = {
  apps: [
    {
      name: 'kilopolis-api',
      script: './src/server.js',
      
      // Modo Cluster: crea una instancia por cada núcleo de CPU del VPS
      instances: 'max',
      exec_mode: 'cluster',

      // Reinicio automático si el proceso supera 300MB de RAM (previene fugas)
      max_memory_restart: '300M',

      // Entorno de Producción
      env_production: {
        NODE_ENV: 'production',
        PORT: 3000,
      },

      // Configuración de Bitácoras Rotativas
      error_file: './storage/logs/pm2-err.log',
      out_file: './storage/logs/pm2-out.log',
      merge_logs: true,
      time: true,
    },
  ],
};
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es la función principal del "Modo Cluster" de PM2 (pm2 start -i max) en un servidor VPS multi-núcleo?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Node.js & npm Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.