PM2 na VPS: processos, logs e reinício da aplicação
Comandos para acompanhar aplicações Node.js e investigar reinícios sem confundir processo online com aplicação saudável.
O PM2 gerencia processos, permite consultar logs e ajuda a manter uma aplicação em execução. Ainda assim, ver o estado “online” não garante que o site esteja respondendo corretamente.
Use o usuário correto
Execute os comandos com o usuário responsável pela aplicação. O PM2 pode ter diretórios de estado diferentes conforme o usuário e a variável PM2_HOME. Uma sessão como root pode mostrar uma lista diferente daquela usada para iniciar o projeto.
Inicie e acompanhe o processo
Com Node.js e PM2 instalados, entre na pasta do projeto e escolha um nome fácil de reconhecer. Ajuste o arquivo de entrada ao seu código:
pm2 start server.js --name minha-api
pm2 status
pm2 logs minha-api --lines 100
pm2 restart minha-apiSe a aplicação precisa de um build, conclua essa etapa antes de iniciar a versão de produção. Evite iniciar o mesmo serviço em dois gerenciadores ao mesmo tempo: isso pode causar conflito de porta.
Prepare a volta após um reboot
pm2 startup
pm2 saveO primeiro comando mostra instruções para configurar o início automático no sistema. Execute a instrução gerada para o usuário correto e salve a lista desejada. Fechar o terminal não configura, por si só, a recuperação após uma reinicialização da VPS.
Investigue por que reinicia
Se o contador de reinícios aumenta, consulte os logs e confira memória, disco, porta ocupada e dependências externas. Verifique o código de saída. Reiniciar repetidamente pode esconder o sintoma sem resolver a causa.
Teste uma rota HTTP e a conexão com o banco. Um processo pode continuar em execução e devolver erros em todas as requisições. Um erro 502 também pode estar no caminho entre o proxy e a aplicação; a mensagem sozinha não identifica qual componente falhou.
Respeite o fluxo do ambiente
Os comandos deste artigo são para uma VPS em que você administra o PM2 diretamente. Em um ambiente gerenciado pelo painel, siga os controles da plataforma. Consulte a documentação da CylinderHost e os logs para identificar o fluxo do seu projeto.
Referência: guia oficial de início do PM2.