A sintaxe do cron é cinco campos de números e símbolos que de alguma forma precisam expressar "toda segunda a sexta às 9h, exceto feriados" ou "a cada 15 minutos entre 8h e 18h." Os campos são minuto, hora, dia do mês, mês e dia da semana, em uma ordem que ninguém lembra corretamente na primeira tentativa, e asteriscos, vírgulas, traços e barras significam coisas diferentes dependendo da posição.
0 9 * * 1-5 parece razoável, mas isso é 9h ou 21h, e 1-5 significa segunda a sexta ou algo completamente diferente dependendo se a implementação do cron conta domingo como 0 ou 7? Errar isso em um pipeline de implantação, uma tarefa de backup ou um relatório agendado significa falhas silenciosas ou uma tarefa disparando em um horário inconveniente — às vezes por semanas antes que alguém perceba.
Cada Implementação de Cron Tem Suas Próprias Peculiaridades
O cron padrão do Unix, os CronJobs do Kubernetes, o AWS EventBridge e várias plataformas de CI usam aproximadamente a mesma sintaxe de cinco campos, mas diferem em pequenos detalhes — se os segundos são suportados, como funciona a numeração do dia da semana, se certas strings abreviadas como @daily são válidas. Escrever um agendamento que funcione corretamente na primeira implantação significa entender exatamente qual variante de cron você está usando.
Traduza Expressões para Português Simples
Bellows inclui um assistente de expressão cron que pega uma string de agendamento e explica o que ela realmente significa em linguagem simples, para que você possa verificar sua intenção antes de implantar uma tarefa agendada em qualquer lugar.
Verificando Antes de Implantar
Uma tarefa agendada que dispara na hora errada costuma ser uma falha silenciosa — nada quebra, ela simplesmente roda quando você não pretendia, às vezes sobrepondo uma janela de manutenção ou sobrecarregando um banco de dados durante o pico de tráfego. Verificar o significado em português simples de uma string cron antes de mesclar uma configuração de implantação captura isso antes que se torne um alerta às 2 da manhã.
Lendo o Agendamento de Outra Pessoa
Herdar uma base de código com uma dúzia de tarefas cron existentes significa descobrir o que cada uma faz antes de poder alterá-las com segurança. Traduzir cada expressão rapidamente é mais rápido do que analisar mentalmente cinco campos crípticos, uma tarefa de cada vez.