Instalar e iniciar a aplicação com PM2
PM2 é instalado globalmente via npm. Após instalar, inicie a aplicação e configure o startup automático:
bash
# Instalar PM2 globalmente
npm install -g pm2
# Iniciar aplicação (modo fork — 1 processo)
pm2 start dist/index.js --name "minha-api"
# Iniciar com variáveis de ambiente
pm2 start dist/index.js --name "minha-api" --env production
# Ver processos rodando
pm2 list
pm2 status
# Configurar para iniciar no boot da VPS
pm2 startup
# Executar o comando que o PM2 sugerir (ex: sudo env PATH=... pm2 startup systemd -u deploy)
pm2 saveecosystem.config.js: configuração declarativa
O arquivo de ecosistema centraliza a configuração de todos os processos e deve ser commitado no repositório:
javascript
// ecosystem.config.js
module.exports = {
apps: [
{
name: 'minha-api',
script: 'dist/index.js',
instances: 'max', // um processo por CPU
exec_mode: 'cluster', // modo cluster (workers)
watch: false, // nunca watch em produção
max_memory_restart: '500M', // reiniciar se usar > 500 MB
env_production: {
NODE_ENV: 'production',
PORT: 3000,
},
// Logs centralizados
out_file: '/var/log/pm2/minha-api-out.log',
error_file: '/var/log/pm2/minha-api-err.log',
merge_logs: true,
log_date_format: 'YYYY-MM-DD HH:mm:ss',
// Restart inteligente
restart_delay: 3000, // aguardar 3s antes de reiniciar
max_restarts: 10, // max 10 restarts em 15min
min_uptime: '5s', // mínimo 5s rodando para ser "estável"
},
],
}Cluster mode: usar todos os CPUs
No modo cluster, PM2 cria um processo por CPU e distribui requisições com balanceamento de carga nativo do Node.js:
bash
# Iniciar com ecosistema (modo cluster)
pm2 start ecosystem.config.js --env production
# Ver distribuição de carga entre workers
pm2 list
# Cada processo mostra CPU%, RAM e restarts
# Reiniciar workers um a um (zero downtime)
pm2 reload minha-api
# Escalar para número específico de instâncias
pm2 scale minha-api 4 # 4 processos
pm2 scale minha-api +2 # adicionar 2 processos
pm2 scale minha-api -1 # remover 1 processo
# Ver em que worker cada requisição está sendo processada
pm2 monitGerenciar logs
PM2 centraliza logs de todos os workers. Configure rotação para evitar disco cheio:
bash
# Ver logs em tempo real
pm2 logs minha-api
pm2 logs minha-api --lines 100
# Ver apenas erros
pm2 logs minha-api --err
# Limpar logs manualmente
pm2 flush minha-api
# Instalar rotação de logs automática
pm2 install pm2-logrotate
# Configurar rotação
pm2 set pm2-logrotate:max_size 10M # arquivo máximo 10 MB
pm2 set pm2-logrotate:retain 7 # manter 7 arquivos rotacionados
pm2 set pm2-logrotate:compress true # comprimir arquivos antigosDeploy com PM2 (sem Docker)
Script de deploy para aplicações Node.js gerenciadas pelo PM2 diretamente no host:
bash
#!/bin/bash
# deploy.sh
VPS_USER=deploy
VPS_HOST=IP_DA_VPS
APP_DIR=/opt/minha-api
# Sincronizar arquivos
rsync -avz --exclude='node_modules' --exclude='.env' --exclude='.git' \
./ $VPS_USER@$VPS_HOST:$APP_DIR/
# Na VPS: instalar deps, build e reload
ssh $VPS_USER@$VPS_HOST "
cd $APP_DIR
npm ci --only=production
npm run build
pm2 reload ecosystem.config.js --env production
pm2 save
"