Algumas partes de um app rodam fora das requisições web: queue workers, Horizon, um servidor websocket Reverb, o scheduler do Laravel. O rdev as executa para você no servidor, mantém-nas em execução e mostra como estão indo na página do seu servidor no painel. Isso exige o rdev 0.2.0-beta.24 ou posterior no servidor.
Quando um projeto Laravel no servidor não tem queue worker nem Horizon, o card Processos sugere adicionar um queue worker; quando não tem scheduler, o card Tarefas agendadas sugere adicioná-lo. Um clique abre o formulário preenchido para esse projeto; o × oculta essa sugestão para o projeto, e Mostrar sugestões ocultas no card traz as ocultas de volta. As sugestões exigem o rdev 0.2.0-beta.26 ou posterior, que informa ao painel quais projetos são apps Laravel.
Processos
Um processo é um comando que deve estar sempre em execução, como php artisan queue:work. O rdev o inicia na pasta do projeto, o inicia de novo se ele parar e pode executar várias cópias.
No painel, abra o servidor em Servidores na barra lateral e escolha Adicionar processo no card Processos. Escolha um tipo:
- Queue worker:
php artisan queue:work --tries=3; - Horizon:
php artisan horizon(o menu da linha abre o painel do Horizon); - Reverb:
php artisan reverb:start; - Personalizado: qualquer comando, para qualquer linguagem.
Depois escolha o projeto e quantas cópias executar. A tabela mostra cada processo e se todas as cópias dele estão em execução. O menu ⋯ de uma linha o inicia, para ou reinicia, abre Configurações para alterar o comando ou o número de cópias, ou o remove. Um processo que você para permanece parado até você iniciá-lo de novo.
No servidor:
| Comando | O que faz |
|---|---|
rdev process add shop queue --command "php artisan queue:work" --count 2 |
Adiciona um processo com duas cópias |
rdev process list |
Lista os processos e quantas cópias estão em execução |
rdev process stop shop queue / start / restart |
Para, inicia ou reinicia todas as cópias |
rdev process edit shop queue --count 4 |
Altera o comando ou o número de cópias |
rdev process logs shop queue |
Mostra as últimas linhas da saída de cada cópia |
rdev process remove shop queue |
Para e remove o processo |
Depois de fazer o deploy de um novo código, reinicie os queue workers e o Horizon para que o carreguem: rdev process restart shop queue.
Tarefas agendadas
Uma tarefa agendada executa um comando em horários definidos, como o cron. Os horários são em UTC, o relógio do servidor. Uma execução nunca começa enquanto a execução anterior da mesma tarefa ainda está em andamento.
No card Tarefas agendadas, escolha Adicionar tarefa agendada. Scheduler do Laravel adiciona php artisan schedule:run a cada minuto, que é tudo de que um app Laravel precisa: o agendamento em si fica no seu código. Personalizado aceita qualquer comando e agendamento.
Um agendamento tem cinco campos: minuto, hora, dia do mês, mês e dia da semana. Por exemplo:
| Agendamento | Executa |
|---|---|
* * * * * |
A cada minuto |
*/15 * * * * |
A cada 15 minutos |
0 3 * * * |
Todos os dias às 03:00 UTC |
30 8 * * 1-5 |
Dias úteis às 08:30 UTC |
@hourly, @daily, @weekly |
No início de cada hora, dia ou semana |
A tabela mostra quando cada tarefa foi executada pela última vez, se teve êxito e quanto tempo levou, e quando ela será executada em seguida. Clique no resultado para ver a saída. O interruptor desativa uma tarefa sem removê-la; ela então só é executada quando você escolhe Executar agora.
No servidor:
| Comando | O que faz |
|---|---|
rdev cron add shop scheduler --schedule "* * * * *" --command "php artisan schedule:run" |
Adiciona o scheduler do Laravel |
rdev cron list |
Lista as tarefas |
rdev cron run shop scheduler |
Executa-a agora |
rdev cron disable shop scheduler / enable |
Desativa ou ativa |
rdev cron logs shop scheduler |
Mostra a saída da última execução |
rdev cron remove shop scheduler |
Remove-a |