Ejecución de proyectos Node.js en producción con PM2: Guía del panel

Node.js es un tiempo de ejecución que funciona con un bucle de eventos en un solo hilo. Esta arquitectura tiene un rendimiento tremendo para servidores API, pero tiene dos límites: si hay una falla, el proceso muere, no funciona en paralelo con tantos núcleos de CPU. PM2 es un gestor de procesos diseñado para superar estos dos límites. Es una de las herramientas líderes utilizadas para la implementación de Production Node.js.

En esta guía, explicaremos qué hace PM2 en producción, qué configuraciones le interesan y por qué, y cómo puede administrar estas configuraciones desde la interfaz con VDS Panel.

Bir bakışta

99.9%

Objetivo de tiempo de actividad

4-8×

rendimiento con cluster

<1seg

reinicio automático

Recarga de tiempo de inactividad

¿Qué hace el PM2?

PM2 “daimoniza” sus procesos Node.js. Bien:

Reinicia el proceso cuando falla.
Abre más de un proceso y distribuye la carga (modo cluster)
Escribe los registros en el archivo y los rota.
Gestiona el tráfico ininterrumpido entre reinicios.
Supervisa la memoria/CPU, reinicia el proceso que excede los límites

También es posible ejecutar Node.js con systemd, pero es necesario instalar las funciones anteriores una por una.

¿Por qué es importante el modo de clúster?

Node.js ejecuta un solo subproceso de forma predeterminada. Si está ejecutando un proceso de Nodo en un VPS de 4 núcleos, el 75% de la capacidad de su CPU permanece inactiva. El modo de clúster PM2 abre tantos procesos de trabajo como núcleos de CPU hay y distribuye la carga entre ellos:

4-8×

más rendimiento

Modo de clúster comparado con el modo de instancia única en VPS de 4 núcleos.

Instalación clásica vs mediante panel

Clásico

Manual PM2 con terminal

npm install pm2 -g (instalación global)
Escribe ecosistema.config.js
Aprenda los comandos de inicio/parada/recarga de pm2
Seguimiento de registros con registros pm2
Comenzando en el arranque con pm2 save + pm2 startup
SSH + recarga manual para actualización

interfaz

con panel VDS

Agregar proyecto, seleccionar Node.js
Establezca el número de instancias de clúster con el control deslizante
Límite de memoria, reinicio automático, rotación de registros automática
Transmisión de registro en vivo en el panel
Inicio automático al arrancar (ya instalado)
Git push → recarga automática sin tiempo de inactividad

Instalación paso a paso con panel.

01

Agregue el proyecto Node.js

Vincula o comprime el repositorio de GitHub. El panel detecta package.json, usa 'scripts.start' o el punto de entrada que especifique.
02

Configurar clúster

Control deslizante para el número de instancias: 1 (modo bifurcación) al número de CPU de su VPS. Para la mayoría de las API, lo ideal es entre 2 y 4.
03

Establecer límite de memoria

Como 256 MB, 512 MB, 1 GB. El trabajador que supere este límite se reiniciará automáticamente. Se tolera la pérdida de memoria, la aplicación sigue funcionando.
04

Introduzca variables ambientales

NODE_ENV=producción, DATABASE_URL, claves API. No está escrito en Git, se almacena en la bóveda secreta del panel y se inyecta en tiempo de ejecución.
05

Conectar dominio

Nombre de dominio o subdominio personalizado. El panel obtiene automáticamente el certificado Let's Encrypt y dirige el proxy inverso nginx a su puerto 3000.
06

Presione Implementar

Su aplicación estará activa en aproximadamente 90 segundos. Cuando realizas un git push, se activa la recarga sin tiempo de inactividad.

Recarga sin tiempo de inactividad

Una de las funciones más potentes de PM2 es la recarga elegante. Cuando implementas código nuevo:

PM2 inicia nuevos trabajadores
Los nuevos trabajadores empiezan a escuchar
Espera a que los trabajadores antiguos finalicen sus solicitudes actuales (cierre elegante)
Los viejos trabajadores cierran

El usuario no siente ninguna interrupción. VDS Panel realiza cada despliegue con esta estrategia.

Señal de apagado elegante

Si su aplicación Node.js está escuchando la señal SIGINT o SIGTERM, cuando PM2 se cierra, le da a su aplicación 10 segundos para realizar tareas de limpieza, como cerrar conexiones de base de datos abiertas y vaciar el caché. El panel establece este tiempo por defecto.

Defensa contra pérdidas de memoria

Las pérdidas de memoria de Node.js son comunes; especialmente cuando se olvida el detector de eventos y el caché global crece. La configuración P0 de PM2 proporciona la solución:

En la interfaz del panel, este valor es un control deslizante. Si especificó 512M, PM2 reinicia silenciosamente un trabajador cuando supera los 512MB. Otros trabajadores continúan manejando el tráfico.

Dependencias DEV en Producción

Se instala con el panel P0, las dependencias de desarrollo no están instaladas. Si importa un paquete en P1 en tiempo de ejecución, la compilación de producción fallará. Verá estos errores en el registro de construcción del panel.

Gestión de registros

PM2 escribe P0 y P1 para cada trabajador. Con el tiempo, estos archivos se llenan. El panel activa automáticamente la rotación de registros:

Girar cuando el tamaño del archivo alcance los 100 MB
Se conservan 5 archivos antiguos.
Los registros se transmiten en vivo desde la interfaz de usuario del panel (sin abrir una terminal)

Monitoreo y alertas

Para cada proceso de PM2, el panel:

El gráfico de CPU y memoria fluye en vivo
Se monitorea el número de reinicios (demasiados reinicios = señal de error)
Telemetría de tiempo de respuesta (si se agrega express-status-monitor o similar)
Lanzamiento automático del demonio cpulimit cuando se excede el límite de CPU (protegiendo proyectos vecinos)

Marcos de trabajo de Node.js

VDS Panel ha sido probado y detecta automáticamente los siguientes frameworks:

Express, común, rápido, sencillo
NestJS, de nivel empresarial, centrado en TypeScript
Fastify, validación de esquema JSON integrada y ultrarrápida
Koa.js, el sucesor moderno de los creadores de Express
Hapi, amplio ecosistema de complementos orientado a la configuración
AdonisJS, MVC similar a Laravel

El panel lee su P0, detecta el marco correcto y selecciona el script de inicio apropiado.

Conclusión

PM2 es imprescindible para la producción de Node.js. Modo de clúster, reinicio automático, límite de memoria, rotación de registros, recarga sin tiempo de inactividad, todos vienen con un solo demonio. VDS Panel permite gestionar estas configuraciones desde la interfaz sin memorizar el comando del terminal.

Para poner en marcha su proyecto Node.js, puede completar la configuración del panel en 8 minutos y ver su primer proyecto solicitando una demostración desde nuestro formulario de contacto.