
Node.js PM2 konfiguracija za produkciju: klaster, logovanje i deploy vodič
PM2 je standardni menadžer procesa za Node.js u produkciji. Vodič obrađuje cluster režim, upravljanje logovima, deploy bez prekida rada i Nginx integraciju.
Ahmet Yılmaz
Viši inženjer infrastrukture
Vaša Node.js aplikacija u razvoju radi bez problema pomoću node app.js, ali u produkciji pad jednog procesa obara celu uslugu, logovi se gube, a većina CPU jezgara miruje. PM2 je postao standardni menadžer procesa za pokretanje Node.js aplikacija u produkciji. U ovom vodiču na praktičnim primerima obrađujemo PM2 cluster režim, upravljanje logovima, deploy bez prekida rada i Nginx integraciju.
Šta je PM2 i zašto vam je potreban?
Node.js radi na jednoj niti. Ako vaš server ima 4 CPU jezgra, podrazumevano koristi samo jedno. Ne postoji ugrađen mehanizam za ponovno pokretanje srušenog procesa. PM2 rešava ove probleme: nadzor procesa, automatska ponovna pokretanja, korišćenje više jezgara putem cluster režima i centralizovano upravljanje logovima. Prema zvaničnoj PM2 dokumentaciji, aktivno se koristi na milionima produkcijskih servera širom sveta.
Instalacija i osnovne komande
# Global installation
npm install -g pm2
# Start application
pm2 start app.js --name "my-api"
# Check status
pm2 status
# View logs
pm2 logs my-api --lines 50
# Restart
pm2 restart my-api
# Stop and delete
pm2 stop my-api
pm2 delete my-api
Konfiguracija pomoću ecosystem fajla
Umesto da svaki put ponavljate parametre u komandnoj liniji, svu konfiguraciju možete definisati u jednom fajlu. Fajl ecosystem.config.js je srce PM2-a — centralno upravlja nazivom aplikacije, brojem instanci u klasteru, promenljivim okruženja i podešavanjima logova.
module.exports = {
apps: [{
name: 'my-api',
script: './dist/server.js',
instances: 'max', // Match CPU core count
exec_mode: 'cluster', // Cluster mode
max_memory_restart: '512M', // Memory limit
watch: false, // Must be off in production
max_restarts: 10, // Max restarts in 15 min
min_uptime: '10s', // Stable threshold
// Log settings
error_file: './logs/error.log',
out_file: './logs/output.log',
log_date_format: 'YYYY-MM-DD HH:mm:ss Z',
merge_logs: true,
// Environment variables
env_production: {
NODE_ENV: 'production',
PORT: 3000
}
}]
};
# Start with ecosystem file
pm2 start ecosystem.config.js --env production
# Auto-start on server reboot
pm2 startup
pm2 save
⚠️ Upozorenje: Nikada ne koristite watch: true u produkciji. Prati promene fajlova i izaziva nepotrebna ponovna pokretanja. Ova funkcija je namenjena samo razvojnim okruženjima.
Korišćenje više jezgara pomoću cluster režima
Pošto Node.js radi na jednoj niti, podrazumevano koristi samo jedno CPU jezgro. PM2 cluster režim koristi ugrađeni Node.js modul cluster da pokrene poseban worker proces na svakom jezgru. Pokretanjem 4 workera na serveru sa 4 jezgra teoretski možete obraditi 4 puta više zahteva.
| Režim | Korišćenje CPU-a | Otpornost na greške | Kada? |
|---|---|---|---|
| fork (podrazumevano) | Jedno jezgro | Niska | Razvoj, cron poslovi |
| cluster | Sva jezgra | Visoka | Produkcijski API/web serveri |
💡 Savet: instances: 'max' koristi sva jezgra. Međutim, ako na serveru rade i druge usluge (Redis, Nginx, baza podataka), bezbednije je koristiti instances: -1 kako bi jedno jezgro ostalo slobodno. Na serveru sa 4 jezgra to znači 3 workera.
Upravljanje logovima i rotacija
U produkciji logovi brzo rastu. Ugrađeno upravljanje logovima u PM2-u je osnovno; modul pm2-logrotate automatski rotira fajlove logova i sprečava popunjavanje diska.
# Install log rotation module
pm2 install pm2-logrotate
# Configure settings
pm2 set pm2-logrotate:max_size 50M # Max size per file
pm2 set pm2-logrotate:retain 7 # Keep 7 files
pm2 set pm2-logrotate:compress true # Compress old logs
pm2 set pm2-logrotate:dateFormat YYYY-MM-DD_HH-mm-ss
pm2 set pm2-logrotate:workerInterval 30 # Check every 30 sec
Za strukturirano logovanje preporučuje se korišćenje biblioteke kao što je Winston ili Pino u vašoj aplikaciji. Logovi u JSON formatu lako se integrišu sa centralizovanim sistemima za logove poput ELK Stack-a ili Grafana Loki-ja.
Deploy bez prekida rada
Tradicionalna komanda pm2 restart zaustavlja sve workere istovremeno i ponovo ih pokreće — dolazni zahtevi se u tom intervalu gube. pm2 reload izvodi graceful reload: ponovo pokreće workere jedan po jedan, čime je uvek aktivan najmanje jedan worker.
#!/bin/bash
# Zero-downtime deployment script
git pull origin main
npm ci --production
npm run build
# Graceful reload - zero downtime
pm2 reload ecosystem.config.js --env production
echo "Deploy completed: $(date)"
Za graceful shutdown vaša aplikacija mora da uhvati signal SIGINT i zatvori otvorene konekcije:
const server = app.listen(PORT);
process.on('SIGINT', () => {
console.log('Graceful shutdown started...');
server.close(() => {
// Close DB connections
mongoose.connection.close();
process.exit(0);
});
// Force exit if not closed within 10 seconds
setTimeout(() => process.exit(1), 10000);
});
Integracija Nginx reverse proxyja
Pokretanje Node.js aplikacije direktno na portu 80/443 ne preporučuje se iz bezbednosnih razloga i razloga performansi. Korišćenjem Nginx-a kao reverse proxyja SSL terminaciju, posluživanje statičkih fajlova, ograničavanje broja zahteva i gzip kompresiju prebacujete sa Node.js-a na Nginx.
upstream nodejs_backend {
server 127.0.0.1:3000;
keepalive 64;
}
server {
listen 443 ssl http2;
server_name api.example.com;
ssl_certificate /etc/letsencrypt/live/api.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/api.example.com/privkey.pem;
# Static files served by Nginx
location /static/ {
alias /var/www/my-api/public/;
expires 30d;
add_header Cache-Control "public, immutable";
}
location / {
proxy_pass http://nodejs_backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
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;
proxy_cache_bypass $http_upgrade;
}
}
Više detalja o Nginx reverse proxyju potražite u našem vodiču za Nginx Reverse Proxy.
Nadzor i metrike
PM2 pruža ugrađenu kontrolnu tablu za nadzor. Komanda pm2 monit omogućava da direktno iz terminala pratite CPU, memoriju, kašnjenje petlje događaja i broj aktivnih zahteva.
# Live monitoring dashboard
pm2 monit
# Detailed info
pm2 show my-api
# JSON metrics (for automation)
pm2 jlist
-
Korišćenje CPU-a Ako je stalno iznad 80%, povećajte broj workera ili nadogradite resurse servera.
-
Memorija (heap) Stalni rast potrošnje memorije ukazuje na curenje memorije. Podesite
max_memory_restartza automatska ponovna pokretanja. -
Broj restartova Česti restartovi ukazuju na neotklonjenu grešku u vašoj aplikaciji. Proverite logove grešaka pomoću
pm2 logs --err.
Za sveobuhvatniji nadzor pogledajte naš vodič za nadzor pomoću Prometheus + Grafana.
Dimenzionisanje servera
Zahtevi vaše Node.js aplikacije za resursima variraju u zavisnosti od obima zahteva i vrste obrade. I/O-intenzivne aplikacije (API gateway, proxy) zahtevaju manje CPU-a, dok zadaci intenzivni po CPU-u (obrada slika, enkripcija) zahtevaju više jezgara.
| Tip aplikacije | CPU | RAM | PM2 instance |
|---|---|---|---|
| Jednostavan API (~1K rps) | 2 vCPU | 2 GB | 2 |
| API srednjeg obima (~5K rps) | 4 vCPU | 4 GB | 4 |
| Veliki saobraćaj (~10K+ rps) | 8+ vCPU | 8+ GB | 8+ |
Za infrastrukturu vašeg Node.js hostinga razmotrite Hosted Cloud cloud servere.
Često postavljana pitanja
Koja je razlika između PM2 i forever?
Forever samo održava proces u životu. PM2 nudi sveobuhvatne funkcije, uključujući cluster režim, upravljanje logovima, deploy bez prekida rada, kontrolnu tablu za nadzor i ecosystem fajl. PM2 je postao standardni izbor za produkcijska okruženja.
Da li cluster režim radi sa WebSocketom?
Da, ali zahteva sticky sesije. Kada koristite cluster režim sa -i max, doslednost sesija možete obezbediti pomoću ip_hash u Nginx-u ili Redis adaptera za Socket.IO.
Kako da koristim PM2 sa TypeScript projektima?
Prvo kompajlirajte TypeScript (tsc ili npm run build) i pokrenite JavaScript izlaz pomoću PM2. Direktno pokretanje pomoću ts-node u produkciji dovodi do pada performansi.
Da li se PM2 automatski pokreće nakon restarta servera?
Komanda pm2 startup kreira systemd/init skriptu, a pm2 save čuva trenutnu listu procesa. Kada se server restartuje, PM2 automatski pokreće sve aplikacije.
Treba li da koristim PM2 unutar Dockera?
Docker kontejneri već obezbeđuju upravljanje procesima. Međutim, ako želite cluster režim unutar jednog kontejnera, koristite pm2-runtime. U Kubernetes okruženjima povećanje broja replika podova bolji je pristup od korišćenja PM2-a.
Zaključak
Upravljanje Node.js aplikacijom u produkciji pomoću PM2 omogućava vam da iskoristite sva CPU jezgra kroz cluster režim, obezbedite neprekidan rad automatskim ponovnim pokretanjima i pojednostavite otklanjanje grešaka centralizovanim upravljanjem logovima. Kodirajte svoju konfiguraciju ecosystem fajlom, unapredite bezbednost Nginx reverse proxyjem i radite deploy bez prekida rada pomoću pm2 reload.
Infrastruktura visokih performansi za vaš Node.js projekat
Pokrenite svoju Node.js aplikaciju maksimalnom brzinom u PM2 cluster režimu uz Hosted Cloud NVMe SSD cloud servere.
Pogledajte pakete cloud servera →Ahmet Yılmaz
Viši inženjer infrastrukture
Sa više od 10 godina iskustva u cloud infrastrukturi i DevOps-u, Ahmet se specijalizovao za Kubernetes, Terraform i arhitekture visoke dostupnosti.
Komentari uskoro