module.exports = {
apps: [{
name: 'api-core',
script: './dist/server.js',
instances: -1,
exec_mode: 'cluster',
wait_ready: true,
listen_timeout: 10000,
kill_timeout: 5000,
max_memory_restart: '800M',
env_production: {
NODE_ENV: 'production',
PORT: 3000
}
}]
};Dacă încă pornești aplicațiile pe server cu pm2 start app.js -i max direct din CLI, pierzi jumătate din avantajele tool-ului. Un fișier ecosystem.config.js versionat în Git îți standardizează deploy-ul și te scapă de apeluri nocturne când un worker crapă din senin.
Am avut acum doi ani un API de facturare cu vreo 1.2k request-uri pe minut. Din cauza unei librării vechi de generat PDF-uri, aveam un memory leak nesimțit care umfla Node de la 180MB la 1.5GB în câteva ore. Până am rescris modulul, max_memory_restart din PM2 ne-a ținut pe linia de plutire.
Cluster mode fără bătăi de cap
Node.js e single-threaded, asta știm toți. Dar dacă ai un VPS cu 4 sau 8 vCPU-uri și rulezi un singur proces, arunci banii pe geam. În mod normal pui instances: 'max', dar pe mașini partajate unde mai rulează un Redis sau Postgres local, recomand să lași măcar un core liber: instances: -1.
Trade-off-ul la cluster mode? Aplicația ta trebuie să fie complet stateless. Dacă ții sesiuni în memoria procesului sau folosești variabile globale pentru stări tranzitorii, o să ai bug-uri bizare când request-ul următor ajunge pe alt worker.
Graceful reload și handoff curat
Comanda clasică pm2 restart omoară procesele brutal. Utilizatorii care au request-uri în zbor primesc direct 502 Bad Gateway. Ca să eviți asta, folosești pm2 reload combinat cu setările potrivite în config:
- Setezi
wait_ready: true. PM2 așteaptă semnalul aplicației înainte să considere worker-ul nou activ. - În codul tău de Express sau Fastify, după ce serverul ascultă pe port și s-a conectat la baza de date, trimiți
process.send('ready'). - Pui un
kill_timeout: 5000. Dacă un request vechi e lent, îi dai 5 secunde să termine înainte ca vechiul worker să primească SIGKILL.
Salvarea la OOM și logurile scăpate de sub control
Cu opțiunea max_memory_restart: '800M', PM2 monitorizează constant consumul workerilor. Când un proces depășește pragul, e reciclat automat în fundal, iar celălalt worker preia traficul. E clar un band-aid — nu rezolvă bug-ul de memorie, dar cumpără timp prețios fără să afecteze clienții.
Altă capcană clasică: logurile. PM2 scrie stdout și stderr până îți umple tot SSD-ul. Am văzut un server de producție blocat pe un disc de 40GB din cauza unui fișier out.log de 28GB. Instalează din start modulul de rotație:
pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 50M
pm2 set pm2-logrotate:retain 10
Asta comprimă logurile vechi și ține doar ultimele 10 fișiere de 50MB. Atât de simplu.
Voi cum gestionați reload-urile pe clustere mari de Node, mergeți încă pe PM2 sau ați migrat totul în containere cu Kubernetes?