Crontab Guru

Folha de dicas dos campos

 ┌───────────── minuto (0-59)
 │ ┌─────────── hora (0-23)
 │ │ ┌───────── dia do mês (1-31)
 │ │ │ ┌─────── mês (1-12 ou JAN-DEC)
 │ │ │ │ ┌───── dia da semana (0-6 ou SUN-SAT; Dom = 0 ou 7)
 │ │ │ │ │
 * * * * *

Operadores em expressões cron

A ordem de leitura importa

0 */2 * * 1-5 é lido da esquerda para a direita como: minuto 0, a cada 2 horas, qualquer dia do mês, qualquer mês, de segunda a sexta. Por hábito, às vezes se lê os campos da direita para a esquerda e isso confunde; comece sempre pelo minuto.

A armadilha “a cada X minutos”

*/10 * * * * dispara nos minutos 0, 10, 20, 30, 40, 50, não “a cada 10 minutos a partir de quando o trabalho foi criado.” Os passos do cron sempre medem a partir do início do intervalo do campo. Se você implantar um trabalho às 12:03, a primeira execução será às 12:10, não às 12:13.

Para trabalhos que realmente precisam de “N minutos após a última execução,” use um agendador com um temporizador persistente (temporizadores systemd com OnUnitActiveSec, ou agendamento em nível de aplicativo com um timestamp da última execução armazenado).

Armadilhas do cron que vale conhecer

• Dia do mês + dia da semana ambos definidos: a maioria das implementações de cron trata isso como comportamento OR, provavelmente não é o que você deseja.
• Passo de 0: */0 é inválido.
• Intervalo se enrola: 22-2 para horas não funciona no cron clássico; use 22-23,0-2.
• Fevereiro 30: uma programação como 0 0 30 2 * nunca dispara.
• Ambiguidade do DST: trabalhos agendados entre 2h e 3h da manhã podem disparar duas vezes ou zero vezes em dias de transição do horário de verão.

Cron vs. agendadores modernos

O cron Unix ainda está em toda parte, mas para qualquer coisa crítica você provavelmente quer:

• temporizadores systemd: capturam execuções perdidas, suportam deslocamentos aleatórios, leem de arquivos de unidade.
• Kubernetes CronJob: declarativo, tentativas, ciente de fuso horário na versão 1.25+.
• Airflow / Prefect / Dagster: para trabalhos com dependências, tentativas, backfills, observabilidade.
• GitHub Actions schedule: cron de 5 campos, apenas UTC, intervalo mínimo de 5 minutos, entrega de melhor esforço.

O cron em si é um ótimo formato, mas um agendador ruim para trabalhos que não podem falhar.