Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Processos e tarefas agendadas

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