module.exports = {
apps: [
{
name: 'api-service',
script: './dist/server.js',
instances: 'max',
exec_mode: 'cluster',
wait_ready: true,
listen_timeout: 10000,
kill_timeout: 5000,
max_memory_restart: '1G',
env_production: {
NODE_ENV: 'production',
PORT: 3000
}
}
]
};Am văzut prea multe instanțe de Node.js rulate cu pm2 start server.js direct din CLI și lăsate de izbeliște pe VPS. Dacă nu folosești un fișier ecosystem.config.js bine reglat, pierzi exact ce face PM2 util: zero-downtime deploys, protecție la memory leaks și scalare pe toate nucleele disponibile.
Uite cum am configurat zeci de mașini de producție și peste ce capcane am dat în ultimii ani.
Cluster mode: de la un nucleu la toate
Node.js e single-threaded pe bucla de evenimente. Dacă ai un server cu 4 vCPU și rulezi clasic, 3 dintre ele stau degeaba în timp ce primul nucleu ajunge la 100% load pe primul val de trafic.
Setarea instances: 'max' (sau un număr fix) pornește modulul nativ de cluster din Node. PM2 face round-robin pe request-uri între workeri. Dar vine cu un trade-off pe care mulți îl uită: dacă ai state în memorie, l-ai pierdut. Sesiunile trebuie să stea în Redis, fișierele temporare într-un storage comun, iar dacă ai task-uri de cron în cod, se vor declanșa de 4 ori simultan. La un magazin online cu 6k comenzi pe zi, am trimis din greșeală notificări de tracking duplicate până să mut cronurile într-un worker separat, marcat cu instances: 1.
Graceful reload fără erori 502
Comanda pm2 restart omoară procesul brusc (SIGKILL) și îl pornește din nou. Pentru câteva secunde, utilizatorii tăi vor primi conexiuni refuzate sau clasicul 502 Bad Gateway de la Nginx.
Soluția e pm2 reload ecosystem.config.js, dar reload-ul are nevoie de sincronizare între PM2 și serverul tău HTTP:
- PM2 trimite
SIGINTprocesului vechi. - Procesul vechi apelează
server.close(), nu mai acceptă conexiuni noi, dar le lasă pe cele curente să se termine. - Procesul nou pornește, se conectează la baza de date și, când Express/Fastify ascultă efectiv pe port, trimite
process.send('ready')către PM2.
Fără wait_ready: true și listen_timeout, PM2 consideră noul proces gata imediat ce a încărcat fișierul JS, înainte ca conexiunea la Postgres sau Mongo să fie activă. Rezultatul? Câteva zeci de request-uri eșuate la fiecare deploy.
Auto-restart la OOM (Out Of Memory)
Toți scriem cod curat până când o librărie de generare de PDF-uri sau un buffer de imagini neasincron uită să elibereze memoria. La un API intern care procesa rapoarte lunare, aveam un leak lent: memoria urca cu 40MB pe oră.
Până am identificat problema în heap dump, parametrul max_memory_restart: '800M' a menținut serviciul sus fără niciun incident vizibil pentru clienți. Când un worker atinge pragul, PM2 îl oprește elegant și ridică altul curat în loc. Nu e o soluție definitivă pentru un bug, dar cumpără timp prețios fără pager alerts la 3 dimineața.
Log rotation: nu umple discul
PM2 salvează logurile în ~/.pm2/logs/. Dacă aplicația ta e zgomotoasă, un disc de 40GB se umple în două luni, iar serverul crapă complet. Instalează mereu modulul nativ cu pm2 install pm2-logrotate. Apoi setează rotația la 100MB și păstrează maxim 7 fișiere comprimate.
Folosiți PM2 direct pe mașină virtuală sau preferați să împachetați totul în containere Docker gestionate prin Kubernetes?