Como manter uma aplicação rodando permanentemente com systemd imprimir

Sua aplicação caiu de novo? Vamos resolver isso de vez

Se você já teve aquele susto de fechar o terminal e sua aplicação simplesmente parar de rodar — ou pior, o servidor reiniciou e ninguém lembrou de "ligar" o processo de novo — este guia é pra você. Vou te mostrar, com calma, como usar o systemd para manter sua aplicação rodando o tempo todo, reiniciando sozinha se cair e voltando automaticamente quando o servidor reinicia.

Antes de começar: este guia vale para ambientes com acesso via terminal (SSH) e permissão de administrador na máquina. Se você não sabe se o seu plano tem esse tipo de acesso, dá uma olhada no painel.gehost.com.br ou fala com o nosso suporte — a gente confirma certinho pra você.

O que é o systemd, afinal?

Pensa no systemd como o "gerente" do seu servidor Linux. Ele é responsável por ligar, desligar e monitorar tudo o que roda no sistema — inclusive a sua aplicação, se você ensinar ele a cuidar dela. Em vez de você rodar sua aplicação manualmente (e torcer pra não cair), o systemd assume esse trabalho: inicia sua aplicação junto com o servidor, reinicia se ela travar, e te dá comandos simples para controlar tudo.

Passo a passo: criando um serviço para sua aplicação

1. Acesse o servidor via terminal

Conecte-se ao seu servidor via SSH, do mesmo jeito que você já costuma fazer para outras tarefas de manutenção.

2. Crie o arquivo de serviço

O systemd usa arquivos de configuração chamados "unit files", guardados em /etc/systemd/system/. Crie um arquivo com o nome da sua aplicação, por exemplo minhaaplicacao.service, com um conteúdo parecido com este:

• [Unit] — uma descrição da sua aplicação e quando ela deve iniciar (geralmente depois da rede estar disponível).
• [Service] — o comando que liga sua aplicação, a pasta onde ela roda, o usuário responsável e a política de reinício automático.
• [Install] — em que "momento" do boot do servidor o serviço deve ser habilitado.

Um exemplo básico, adaptando os caminhos e comandos para a sua aplicação:

• Description=Minha aplicação
• After=network.target
• WorkingDirectory=/caminho/da/sua/aplicacao
• ExecStart=/caminho/do/comando/que/inicia/sua/app
• Restart=always
• User=seu-usuario
• WantedBy=multi-user.target

O segredo está no Restart=always: é essa linha que diz ao systemd "se essa aplicação cair por qualquer motivo, levanta ela de novo".

3. Recarregue o systemd e habilite o serviço

Depois de salvar o arquivo, é preciso avisar o systemd que existe uma configuração nova e então habilitar o serviço para iniciar automaticamente com o servidor:

1. Recarregue as configurações do systemd.
2. Habilite o serviço para iniciar junto com o boot do servidor.
3. Inicie o serviço pela primeira vez.

4. Confirme que está tudo funcionando

O systemd tem um comando de status que mostra se sua aplicação está ativa, há quanto tempo está rodando e as últimas linhas de log — ótimo para um diagnóstico rápido sem precisar caçar arquivo de log manualmente.

Comandos que você vai usar no dia a dia

• Ver o status da aplicação (rodando, parada, com erro).
• Parar a aplicação temporariamente, sem apagar a configuração.
• Reiniciar depois de publicar uma atualização no código.
• Ver os logs mais recentes, úteis para investigar um erro.

Esses quatro comandos resolvem praticamente 90% do dia a dia de quem mantém uma aplicação no ar.

Dicas da Sensei

Sempre teste o comando de ExecStart manualmente antes de colocar no arquivo de serviço. Se ele não funcionar rodando "na mão", também não vai funcionar dentro do systemd.

Depois de qualquer alteração no arquivo .service, não esqueça de recarregar as configurações do systemd antes de reiniciar a aplicação — é um passo fácil de esquecer, e sem ele a mudança simplesmente não é aplicada.

Evite deixar sua aplicação rodando "solta" dentro de uma sessão de terminal (aquele famoso hábito de rodar e deixar a janela aberta). Assim que a sessão cai, a aplicação cai junto. O systemd existe exatamente para te livrar dessa armadilha.

Quando chamar o suporte

Se depois de seguir os passos sua aplicação continuar caindo, ou se você não tiver certeza sobre o tipo de acesso que o seu plano oferece, é só chamar a gente. Você pode consultar os detalhes do seu plano e contrato pelo painel.gehost.com.br ou abrir um chamado com o suporte — estamos aqui pra ajudar você a manter tudo rodando redondinho.