Conceptos Básicos de Procesos

7 ejemplos para empezar con Procesos y Workers - 5 básicos y 2 intermedios.

Prerrequisitos

• Node.js 24.18.0 en un host multi-núcleo para los ejemplos de cluster.
• Lee Cómo funciona Node.js para el modelo JS de un solo hilo.

Ejemplos Básicos

1. process.pid y argv

Identifica el proceso en ejecución y los argumentos de la CLI.

console.log('pid', process.pid);
console.log('argv', process.argv.slice(2));

• process.pid es único por proceso del sistema operativo - regístralo en logs estructurados.
• argv incluye los argumentos del usuario después de node y la ruta del script.
• Los orquestadores de contenedores identifican los pods por la combinación de pid + nombre de host.

Relacionado: os y process - metadatos del host

2. Códigos de Salida de process.exit

Señala éxito o fracaso a shells y CI.

function main(): void {
  const ok = true;
  process.exit(ok ? 0 : 1);
}

• El código de salida 0 es éxito; cualquier valor distinto de cero falla CI y las unidades de systemd.
• Prefiere la salida natural después de que el trabajo asíncrono se complete - process.exit omite el vaciado de E/S.
• Las excepciones no capturadas salen automáticamente con un código distinto de cero.

3. Cuándo Permanecer En-Proceso

Las APIs ligadas a E/S no deben generar procesos por solicitud.

import { createServer } from 'node:http';
 
createServer(async (req, res) => {
  const data = await fetch('https://example.com').then((r) => r.text());
  res.end(data.slice(0, 100));
}).listen(3000);

• await cede durante la E/S de red - no se necesita un proceso adicional.
• Generar un proceso por solicitud añade latencia y presión de descriptores de archivo.
• Escala réplicas horizontalmente antes de recurrir a workers por defecto.

Relacionado: Mejores Prácticas del Bucle de Eventos - mantén el hilo principal responsivo

4. Esquema de worker_threads

Trabajo de CPU fuera del hilo principal de JavaScript.

import { Worker } from 'node:worker_threads';
 
const worker = new Worker(`
  const { parentPort, workerData } = require('worker_threads');
  parentPort.postMessage(workerData.x * 2);
`, { eval: true, workerData: { x: 21 } });
 
worker.on('message', (msg) => console.log(msg)); // 42

• Los workers comparten la misma máquina, aislados de V8 separados.
• workerData clona datos serializables al inicio.
• Prefiere un archivo worker .ts separado sobre eval: true en producción.

Relacionado: worker_threads - pools y SharedArrayBuffer

5. Esquema de child_process spawn

Ejecuta herramientas CLI externas como procesos hijos.

import { spawn } from 'node:child_process';
 
const child = spawn('node', ['--version'], { stdio: 'inherit' });
child.on('exit', (code) => console.log('exit', code));

• spawn transmite stdio - bueno para seguir logs y ffmpeg.
• Evita shell: true con entrada de usuario - riesgo de inyección.
• Consulta child_process para exec vs spawn.

Ejemplos Intermedios

6. cluster para Distribución HTTP

Bifurca workers para usar múltiples núcleos de CPU para el bucle de aceptación.

import cluster from 'node:cluster';
import { availableParallelism } from 'node:os';
import { createServer } from 'node:http';
 
if (cluster.isPrimary) {
  const cpus = availableParallelism();
  for (let i = 0; i < cpus; i++) cluster.fork();
} else {
  createServer((_req, res) => res.end(`worker ${process.pid}`)).listen(3000);
}

• El primario gestiona el ciclo de vida del worker - reinicia al exit en producción.
• Cada worker tiene memoria aislada - no hay caché compartida en el proceso.
• Kubernetes a menudo escala pods en lugar del módulo cluster.

Relacionado: Módulo cluster - patrones de producción

7. Hook de Apagado Elegante

Deja de aceptar trabajo antes de salir en SIGTERM.

process.on('SIGTERM', () => {
  console.log('draining...');
  setTimeout(() => process.exit(0), 2000);
});

• Coordina con server.close() de HTTP y el final del pool de la base de datos.
• Consulta Señales de Proceso y Apagado para el patrón completo.

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.