Rode num agendamento
Um agendamento inicia um script ou flow publicado num horário — toda hora, todo dia útil às 9:00, todo dia 1º — com as entradas definidas uma vez. Ninguém precisa estar conectado. Nesta lição você agenda o daily-report, confere quando ele vai rodar, vê uma execução agendada chegar e pausa o agendamento para o exercício não continuar rodando.
- Criar um agendamento pela aba Gatilhos do editor ou pela página Agendamentos
- Definir o horário e ler as próximas execuções antes de salvar
- Decidir o que acontece quando uma execução agendada falha
- Pausar e retomar um agendamento
O que um agendamento roda
Um agendamento sempre roda a versão publicada do alvo — não há versão para escolher. Publique uma correção e o próximo disparo já usa; edite o rascunho e o agendamento não percebe. Por isso a lista de alvos marca como Não publicado os itens que nunca foram publicados, e a aba Gatilhos pede Publique antes — o agendamento executa a versão publicada.
Dá para criar o mesmo agendamento em dois lugares, e os dois editam a mesma coisa: a página Agendamentos do projeto, que lista todos, e a aba Gatilhos no editor do script, que mostra só os agendamentos daquele script (Adicionar agendamento, Abrir em Agendamentos).
Agende o daily-report
- O quê: escolha o alvo
Abra Agendamentos e clique em Novo Agendamento (ou Adicionar agendamento na aba Gatilhos do script, que já preenche esta etapa). Em O que deve rodar? escolha
daily-report. As entradas aparecem: deixepassingem 80 — estes valores vão em toda execução. - Quando: defina o horário
Escolha Semanal, marque de segunda a sexta, coloque Às em 09:00 e confira o Fuso horário. A prévia lista as Próximas execuções: — leia antes de seguir. Personalizado aceita uma expressão cron.
- Se falhar, depois Revisar
Se algo der errado é opcional — clique em Pular por enquanto. Em Revisar, dê o nome
daily-report weekdays, mantenha ligado e clique em Criar agendamento. Ele aparece na lista como Ativo, com a Próxima Execução. - Pause quando terminar
Depois da primeira execução agendada, abra o menu do agendamento e clique em Pausar (ou Pausar agendamento na aba Gatilhos). Um agendamento pausado mantém as configurações e não mostra próxima execução; Retomar o traz de volta.
Horários e cron
| Frequência | Exemplo | Igual ao cron |
|---|---|---|
| A cada N min | A cada 15 minutos | */15 * * * * |
| Por hora | No minuto 0: 9:00, 10:00, 11:00… | 0 * * * * |
| Diário | Às 07:30 | 30 7 * * * |
| Semanal | Seg–sex às 09:00 | 0 9 * * 1-5 |
| Mensal | No dia 1 às 06:00 | 0 6 1 * * |
Uma expressão cron tem cinco campos — min hora dia mês dia-da-semana — e é lida no fuso do agendamento, nunca no do seu navegador. A prévia não aparece para Personalizado, então confira as primeiras execuções na lista depois de salvar.
# min hour day month weekday
0 9 * * 1-5 # 09:00, Monday to FridayQuando uma execução agendada falha
- Tentar de novo ao falhar inicia de novo uma execução que falhou, até o número de vezes definido.
- Se a execução anterior deste agendamento ainda estiver ativa: Pular — esperar terminar (o padrão) ou Rodar em paralelo.
- Executar ao falhar inicia outro script ou flow — uma mensagem para você, uma limpeza. Para avisos sem código, use Alertas.
Limites
- O seu plano define o menor intervalo que um agendamento pode usar; o formulário mostra isso ao lado do intervalo (Seu plano executa agendamentos no máximo a cada N min).
- Um disparo que não consegue começar — sem créditos, uma entrada faltando, nada publicado — fica registrado como Não iniciou com o motivo, e conta no indicador Confiabilidade do painel.