Como configurar um processo Node.js para reiniciar sozinho em caso de falha (process manager)
Olá, querido(a) desenvolvedor(a)! Se você está aqui, provavelmente já tem um projeto em Node.js rodando no seu servidor da GeHost e quer garantir que ele nunca fique parado — mesmo que algo dê errado. Que bom que você pensou nisso! 😊
Na GeHost, não temos o controle total do servidor como em um VPS, mas podemos usar ferramentas simples e poderosas para manter seu app sempre vivo. Vamos aprender a usar um process manager — um "guardião" que cuida do seu Node.js, reiniciando-o automaticamente se ele parar por qualquer motivo.
Hoje, vamos usar o PM2, uma das ferramentas mais populares e fáceis de usar. Vamos fazer isso passo a passo, como se fosse um ritual de aprendizado — calmo, claro e com carinho. 🌿
Passo 1: Acesse o terminal via SSH (ou o Terminal do cPanel)
Para configurar o PM2, você precisará acessar o terminal do seu servidor. Na GeHost, isso é feito por meio do Terminal no cPanel.
1. Faça login no cPanel.
2. Na tela principal, procure por Terminal (geralmente na seção "Outros").
3. Clique em Terminal para abrir o console.
Passo 2: Instale o PM2 globalmente
O PM2 precisa ser instalado apenas uma vez no seu servidor. Ele será usado para gerenciar todos os seus processos Node.js.
No terminal, digite:
npm install -g pm2
Pressione Enter. O sistema vai baixar e instalar o PM2. Isso pode levar alguns segundos.
Passo 3: Vá até a pasta do seu projeto
Antes de iniciar o seu app com o PM2, você precisa estar na pasta onde está o código do seu Node.js.
Use o comando cd para navegar até a pasta do seu projeto. Por exemplo:
cd public_html/seu-projeto
Substitua seu-projeto pelo nome da pasta onde está seu código (geralmente dentro de public_html).
Passo 4: Inicie seu app com o PM2
Agora, vamos dizer ao PM2: "Olha, esse app é meu, e ele precisa estar sempre rodando!"
Use o comando:
pm2 start app.js
Substitua app.js pelo nome do arquivo principal do seu projeto (pode ser server.js, index.js, etc.).
Se tudo der certo, o PM2 vai mostrar algo como:
App started successfully
Prontinho! Seu app está rodando. E o melhor: se ele parar por algum motivo, o PM2 vai reiniciá-lo automaticamente.
Passo 5: Salve a configuração (para reiniciar após reinicialização do servidor)
Quando o servidor reiniciar (por exemplo, por manutenção), o PM2 não vai lembrar dos seus apps por padrão. Para evitar isso, vamos salvar a lista de processos.
Execute este comando:
pm2 save
Isso garante que, mesmo após reiniciar o servidor, seu app será reiniciado automaticamente.
Passo 6: (Opcional) Configure o PM2 para reiniciar automaticamente após atualizações
Se você atualizar seu código (por exemplo, com Git), o PM2 não vai perceber. Para que ele reinicie automaticamente após mudanças, você pode usar:
pm2 startup
Esse comando configura o PM2 para iniciar automaticamente quando o servidor ligar. Ele vai te mostrar um comando específico para copiar e colar — siga as instruções.
Dica extra: Verifique o status do seu app
Para ver se seu app está rodando, use:
pm2 status
Se tudo estiver certo, você verá seu app com status online.
Conclusão: Você está no controle!
Com o PM2, seu app Node.js está protegido contra quedas, falhas e reinícios inesperados. Isso é o que chamamos de resiliência — e é o que todo bom desenvolvedor deseja para seus projetos.
Se tiver dúvidas, não hesite em nos procurar. Estamos aqui para ajudar, sempre. 💙
Até a próxima, com muita energia e código limpo!