Pular para conteúdo

agendamento

um pipeline pode rodar automaticamente, numa recorrência definida por expressão cron — sem precisar de ninguém para disparar a execução manualmente.

configurando o agendamento

  1. abra o pipeline e acesse agendamento.
  2. informe a expressão cron desejada, no formato padrão de 5 campos (minuto hora dia-do-mês mês dia-da-semana).
  3. salve. o pipeline passa a ser avaliado automaticamente pelo agendador da plataforma.

exemplos comuns:

expressão cron frequência
0 * * * * a cada hora, no minuto 0
0 6 * * * todo dia às 06:00
0 6 * * 1-5 dias úteis às 06:00
*/15 * * * * a cada 15 minutos
0 0 1 * * no primeiro dia de cada mês, à meia-noite

fuso horário

as expressões cron são interpretadas em UTC. se o seu horário de referência é o local (ex: horário de Brasília), ajuste o valor da hora na expressão para compensar a diferença.

como funciona por trás da configuração

o agendador da plataforma verifica periodicamente todos os pipelines ativos com agendamento configurado e calcula, a partir da expressão cron, o próximo horário de disparo. quando esse horário chega, uma nova run é automaticamente enfileirada — sem duplicar execuções, mesmo se o agendador reiniciar ou dois ticks se sobrepuserem.

preenchendo execuções perdidas (backfill)

se um pipeline ficou pausado ou fora do ar por um período e você precisa recuperar as execuções que deveriam ter acontecido nesse intervalo, use o backfill: informe uma janela de tempo e a datablixt cria as runs correspondentes a cada ponto do cron dentro desse período, ignorando automaticamente pontos que já tenham sido executados — sem risco de duplicar dados.

próximos passos

  • monitoramento — acompanhando cada execução agendada
  • alertas — sendo avisado se uma execução agendada falhar ou estourar o sla
  • branches de ambiente — lembre-se: o agendamento só vale para o ambiente em que o pipeline está publicado