Como executar o seu programa como um serviço do systemd que inicia com o servidor

VPS e ServidoresAdministração e problemas··· 1.024 visualizações· 3 min de leitura

Para que um programa seu (uma aplicação Node.js, um script Python, um bot) inicie com o servidor e volte sozinho se cair, escreve-se um arquivo de unidade em /etc/systemd/system/, recarrega-se o systemd e ativa-se o serviço com systemctl enable --now. É a forma nativa de qualquer Linux moderno, sem instalar mais nada. Para aplicações Node.js existe ainda o PM2 (manter uma aplicação Node.js a rodar com o PM2); o systemd serve para tudo o resto, e também para o Node.

Passo a passo

1 Rode o programa à mão primeiro. Se não inicia no terminal, também não inicia como serviço. Anote o caminho completo do programa (which node ou which python3) e a pasta de onde corre.
2 Crie um usuário sem poderes para o serviço, em vez de o rodar como root: sudo useradd --system --home /opt/meuapp --shell /usr/sbin/nologin meuapp. Se o programa for comprometido, o estrago fica preso a esse usuário.
3 Escreva a unidade com sudo nano /etc/systemd/system/meuapp.service[Unit]
Description=A minha aplicação
After=network.target

[Service]
User=meuapp
WorkingDirectory=/opt/meuapp
ExecStart=/usr/bin/node /opt/meuapp/server.js
Restart=on-failure
RestartSec=5
EnvironmentFile=/etc/meuapp.env

[Install]
WantedBy=multi-user.target
4 Ponha os segredos num arquivo à parte, /etc/meuapp.env, com uma linha NOME=valor por variável, e proteja-o: sudo chmod 600 /etc/meuapp.env. Veja variáveis de ambiente e segredos.
5 Diga ao systemd que há uma unidade nova e arranque-a: sudo systemctl daemon-reload e depois sudo systemctl enable --now meuapp. O “enable” faz iniciar com o servidor; o “--now” inicia já.
6 Confirme. systemctl status meuapp deve dizer “active (running)”, e journalctl -u meuapp -f mostra o que o programa escreve, ao vivo.
7 Prove o reinício. Reinicie o servidor numa hora calma e veja se o serviço volta. Só assim fica a saber que funciona.

As linhas da unidade, em palavras

Linha Para quê
After=network.target Só inicia depois de a rede estar pronta.
User= Quem roda o programa. Nunca root, a não ser que precise mesmo.
ExecStart= O comando, com o caminho completo do programa. O systemd não usa o seu PATH nem o seu terminal.
Restart=on-failure Volta a iniciar se terminar com erro; não volta se você o parou de propósito.
EnvironmentFile= Lê as variáveis de um arquivo, em vez de as escrever na unidade (que qualquer usuário pode ler).
WantedBy=multi-user.target É o que faz o enable iniciá-lo na inicialização normal do servidor.
O ExecStart não é um terminal. Redirecionamentos, && e ~ não funcionam como no terminal; use caminhos absolutos e, se precisar de vários comandos, ponha-os num script e execute o script. Se vir “status=203/EXEC”, o caminho está errado: ler o systemctl status.
Mudou a unidade e nada mudou? Falta o sudo systemctl daemon-reload. E uma unidade que dá “Permission denied” ao ler uma pasta é permissões ou o SELinux: permissões de arquivos.
Reiniciar com um temporizador, em vez do cron: o systemd também agenda (arquivos .timer), mas para tarefas simples o cron continua sendo o mais direto: quando o cron não corre.

O programa corre à mão e falha como serviço, e já leu o registro? Mostre-nos o texto do erro e o que mudou desde que funcionava.

Abrir um pedido de suporte

VEJA TAMBÉM

Um serviço não inicia: ler o systemctl status

Onde estão os registros num VPS Linux

Manter uma aplicação Node.js a rodar com o PM2

Até onde vai o nosso suporte

PRODUTO RECOMENDADO

Servidor VPS com acesso root

Recursos só seus, o sistema que escolher, reinstalação quando quiser. desde R$ 46,20/mês (plano de 3 anos, com cupom)

Ver planos
Esta resposta foi útil? Sua resposta nos ajuda a melhorar este artigo.

Artigos Relacionados

Administração e problemas 1.041 Um serviço não inicia no meu VPS: como ler o systemctl status Quando um serviço falha ao iniciar, a resposta está em dois comandos: systemctl status nome-do-servico e journalctl -u n...
Administração e problemas 1.291 Erros comuns em VPS e Cloud: SSH, memória, disco e reinícios Num VPS a máquina é sua: sistema, serviços e firewall respondem às suas ordens, e também aos seus enganos. Estes são os...
Administração e problemas 1.043 Copiar arquivos para outro servidor com o rsync, em segurança O rsync copia pastas entre dois computadores por SSH e, nas vezes seguintes, só envia o que mudou. É a ferramenta mais u...
Administração e problemas 815 Editar e procurar num servidor: nano, grep e find para quem está começando A resposta curta: num VPS não há mouse nem janelas, mas três ferramentas resolvem quase tudo o que um principiante preci...
Administração e problemas 746 Como acrescentar swap a um VPS que fica sem memória O swap é espaço do disco que o sistema usa como memória de reserva quando a RAM se enche. Não torna o servidor mais rápi...
Administração e problemas 1.549 Onde estão os registros num VPS Linux: journalctl e /var/log Num VPS Linux os registros estão em dois lugares: no diário do systemd, que se lê com journalctl, e em arquivos em /var/...