A tela Servicos cria processos que ficam rodando o tempo todo na sua conta e voltam sozinhos se pararem. Use para filas do Laravel, Horizon, WebSockets, consumidores de fila do Magento e aplicações Node.js ou Python.
Diferença em relação ao cron: o cron roda um comando em horários definidos e termina; o serviço fica ligado continuamente.
Lista de serviços
| Coluna | O que mostra |
|---|---|
| Status | Ativo, Parado ou Falhou |
| Nome | Nome curto do serviço. A etiqueta desabilitado indica que ele não sobe sozinho quando o servidor reinicia |
| Descricao | Texto livre que você definiu |
| Comando | O comando executado |
| Acoes | Reiniciar, Parar ou Iniciar, Ver Logs e Excluir |
Modelos prontos (Templates Rapidos)
Clique em um modelo para abrir o formulário já preenchido com o caminho da sua conta:
| Modelo | O que roda |
|---|---|
| Laravel Queue | artisan queue:work na fila default |
| Laravel Scheduler | artisan schedule:run a cada 60 segundos (alternativa ao cron) |
| Laravel Horizon | artisan horizon |
| Laravel Reverb | artisan reverb:start (WebSockets) |
| Magento Consumer | bin/magento queue:consumers:start async.operations.all |
| Node.js App | node public_html/server.js |
| Python App | python3 public_html/app.py |
Os modelos supõem que o projeto está em public_html. Ajuste o caminho no Comando se o seu estiver em outra pasta.
Criar um serviço
- Clique em Novo Servico ou em um dos Templates Rapidos.
- Preencha o formulário:
| Campo | Como preencher |
|---|---|
| Nome do Servico | Identificador único, só letras minúsculas, números, - e _ (até 40 caracteres). Ex.: queue-default |
| Descricao | Texto para você reconhecer o serviço |
| Comando | Comando completo, com caminhos absolutos. Não pode começar com +, !, @, - ou : (o painel recusa com "O comando nao pode comecar com + ! @ - ou :.") |
| Versao PHP | Ao trocar, o painel ajusta o caminho do PHP no comando. Escolha Nenhum (nao usa PHP) para Node.js ou Python |
| Restart | Sempre (always), Apenas em falha (on-failure) ou Nunca (no) |
| Restart delay (seg) | Espera antes de religar, de 1 a 300 segundos |
- Clique em Criar e Iniciar.
O serviço roda com o seu usuário, dentro da pasta public_html, sem poder ganhar privilégios extras (NoNewPrivileges), e já fica configurado para subir junto com o servidor.
A saída do programa vai sempre para ~/logs/<nome>.log e os erros para ~/logs/<nome>-error.log. Não há mais campos para escolher outros arquivos.
Passo a passo: worker de fila do Laravel
- Em Templates Rapidos, clique em Laravel Queue.
- Confira a Versao PHP (a mesma do seu domínio).
- Se usar outra fila além de
default, ajuste--queue=defaultno Comando (ex.:--queue=high,default). - Clique em Criar e Iniciar.
- Confira se o Status ficou Ativo.
Atenção: o worker carrega o código na memória. Depois de cada deploy, clique em Reiniciar no serviço para ele usar o código novo.
Passo a passo: consumidor de fila do Magento
-
Clique em Magento Consumer. O Comando já vem com o consumidor
async.operations.all:/usr/bin/php8.3 /home/cliente/public_html/bin/magento queue:consumers:start async.operations.all --max-messages=1000 -
Para outro consumidor, troque
async.operations.allno Comando pelo nome dele. -
Mude o Nome do Servico para algo como
magento-async. -
Clique em Criar e Iniciar. Crie um serviço para cada consumidor de que a loja precisa.
Passo a passo: aplicação Node.js
- Clique em Node.js App.
- Ajuste o Comando para o arquivo de entrada da sua aplicação (ex.:
/usr/bin/node /home/cliente/public_html/dist/server.js). - Em Versao PHP, escolha Nenhum (nao usa PHP).
- Clique em Criar e Iniciar.
Dica: para o domínio entregar a aplicação Node.js ou o Reverb, o servidor web precisa encaminhar o tráfego para a porta da aplicação. Combine a porta com o administrador antes.
Acompanhar e corrigir
- Ver Logs mostra as últimas 100 linhas do registro do sistema para o serviço: quando iniciou, parou ou falhou.
- A saída do seu programa vai para
~/logs/<nome>.loge~/logs/<nome>-error.log. Esses arquivos são somente leitura para você (veja Logs dos seus domínios). Leia-os em Meus Arquivos ou no Terminal comtail -f ~/logs/queue-default-error.log. - Se o status ficar Falhou, teste o mesmo comando no Terminal para ver o erro.
Para mudar o comando de um serviço existente, exclua-o e crie de novo com os novos dados.
Atenção: Excluir para o serviço e apaga a configuração dele. Os arquivos de log permanecem.