Agendamentos Cron Comuns que Você Pode Reutilizar
Padrões cron prontos para produção com orientação de validação, notas de risco e checklist pré-implantação.
Abrir Gerador de CronPor que Padrões Cron Reutilizáveis Importam
A maioria dos erros de cron começa antes da implantação, quando a intenção do agendamento e a sintaxe divergem. Um desenvolvedor sabe que quer um job para rodar todo dia útil às 9h, mas um valor de campo mal posicionado muda a execução para todo minuto nos dias úteis. O resultado são centenas de execuções não pretendidas e um rollback frenético. A edição manual de cron causa erros repetidos porque a sintaxe é compacta, posicional e implacável.
Este artigo fornece um catálogo de agendamentos cron comuns que você pode reutilizar com exemplos práticos, verificações de validação e próximas ações claras no Cronwise. Cada padrão inclui a expressão bruta, uma explicação em linguagem simples e notas sobre riscos potenciais. Comece por um padrão verificado e ajuste para atender aos seus requisitos.
Teste cada padrão diretamente no gerador de cron do Cronwise, que fornece validação inline e pré-visualização dos próximos horários com fuso horário. Confirme que os próximos 10 horários de execução correspondem à sua intenção e copie com confiança. Para um guia completo da interface do construtor, veja o guia Gerador Visual de Cron.
Princípios de Melhores Práticas para Agendamento Cron
Antes de mergulhar em padrões específicos, estabeleça alguns princípios que separam uma expressão cron válida de uma que é segura em produção.
Seja explícito em vez de implícito. Prefira valores específicos como 0 9 * * 1-5 em vez de abreviações que podem ser mal interpretadas. Explicitude torna agendamentos autodocumentados e mais fáceis de revisar por colegas.
Valide com contexto de fuso horário. Um agendamento definido em UTC se comporta diferentemente de um interpretado em fuso horário local. Sempre confirme os próximos horários no fuso que seu servidor realmente usa. O Cronwise mostra as próximas 10 execuções em qualquer fuso horário IANA que você selecionar.
Visualize antes de implantar. Nunca copie uma expressão para um crontab ou pipeline CI/CD sem verificar sua pré-visualização dos próximos horários. Uma verificação rápida dos próximos horários de execução captura erros de deslocamento e mapeamentos errados de dia da semana antes que custem downtime real.
Documente sua intenção. Anexe uma nota a cada expressão salva descrevendo o que o job faz e por que roda naquele horário. Quando alguém herdar o agendamento depois, a nota previne suposições.
Padrões Cron Recomendados por Caso de Uso
A tabela a seguir lista os agendamentos cron mais comumente necessários. Cada expressão foi validada e pode ser colada diretamente no gerador do Cronwise para confirmação dos próximos horários.
| Expressão | Significado | Quando Usar | Notas de Risco |
|---|---|---|---|
0 * * * * | De hora em hora no minuto 0 | Sincronizações horárias de dados, atualização de cache | Baixo risco; confirme que o job completa dentro de uma hora |
0 0 * * * | Diariamente à meia-noite | Rotação de logs, relatórios noturnos | Meia-noite UTC pode diferir da meia-noite local |
0 9 * * 1-5 | Dias úteis às 09:00 | Alertas em horário comercial, tarefas apenas em dias úteis | Numeração de dia da semana varia; 1=Segunda no cron padrão |
0 2 1 * * | Primeiro dia de cada mês às 02:00 | Faturamento mensal, gatilhos de faturamento | Meses curtos são ok; 1º de fevereiro sempre existe |
*/15 * * * * | A cada 15 minutos | Health checks, polling leve | Alta frequência; garanta que o job é idempotente |
0 3 * * 0 | Domingos às 03:00 | Backups semanais de banco de dados, limpeza | 0=Domingo no cron padrão; verifique que seu sistema concorda |
30 4 15 * * | Dia 15 de cada mês às 04:30 | Relatórios de reconciliação quinzenal | Sem risco de fevereiro; dia 15 sempre existe |
0 0 1 1 * | 1º de janeiro à meia-noite | Renovação anual de licenças, arquivamento anual | Roda apenas uma vez por ano; verifique que realmente disparou |
Para um entendimento mais profundo de como cada campo nessas expressões funciona, leia Fundamentos de Expressões Cron, que cobre a estrutura de 5 campos em detalhe.
Verificando Padrões Rapidamente
Um catálogo de padrões só é útil se você verificar cada um antes da produção. O Cronwise fornece dois caminhos rápidos de verificação que funcionam para toda expressão listada acima.
Cole e visualize. Abra o gerador de cron, insira sua expressão e revise a tabela de pré-visualização. Ela mostra os próximos 10 timestamps de execução no fuso horário selecionado. Se um agendamento apenas para dias úteis mostra execuções no sábado, o campo de dia da semana precisa de ajuste. Esse ciclo de feedback imediato captura erros em segundos em vez de após a implantação.
Construa e compare. Use os controles de campo com abas para construir o agendamento visualmente, depois compare a expressão gerada com a deste catálogo. Se diferirem, o construtor visual esclarece qual campo causa a discrepância.
Ambos os caminhos se beneficiam da validação inline. O Cronwise sinaliza erros como valores fora do intervalo e avisos para padrões incomuns como intervalos de passo que não produzem correspondências. Resolva todo erro e revise todo aviso antes de copiar a expressão final.
Anti-Padrões a Evitar
Nem toda expressão cron sintaticamente válida pertence à produção. Esses padrões aparecem frequentemente em crontabs do mundo real e causam problemas previsíveis.
Executar a cada minuto sem limitação. A expressão * * * * * dispara 1.440 vezes por dia. A menos que o job seja idempotente e complete em menos de 60 segundos, isso leva a execuções sobrepostas e esgotamento de recursos.
Empilhar jobs no início da hora. Agendar múltiplos jobs em 0 * * * * cria um pico de recursos a cada hora. Escalone os horários de início aleatorizando o campo de minuto. O gerador do Cronwise inclui um recurso de aleatorização para esse propósito.
Ignorar numeração de dia da semana. No cron padrão, domingo pode ser 0 ou 7 dependendo da implementação. Se você assume 1=Domingo mas seu sistema usa 1=Segunda, seu job de fim de semana roda em um dia útil. Sempre verifique com a pré-visualização dos próximos horários.
Omitir verificação de fuso horário. Uma expressão como 0 9 * * * significa 09:00 no fuso horário que o servidor usa. Se o servidor roda em UTC e você pretendia horário local, o job dispara no horário errado.
Checklist de Revisão Pré-Produção
Antes de qualquer expressão cron chegar a um ambiente ao vivo, passe por este checklist. Cada item aborda um modo de falha que causa incidentes reais em sistemas de produção.
| Verificação | Por que Importa | Critério de Aprovação |
|---|---|---|
| Validação de sintaxe passa | Expressões inválidas falham silenciosamente | Zero erros no validador do Cronwise |
| Próximos horários correspondem à intenção | Erros de deslocamento mudam a execução | Todos os 10 horários de pré-visualização alinham com agendamento esperado |
| Fuso horário corresponde ao servidor alvo | Incompatibilidade local vs UTC é o erro de implantação mais comum | Fuso da pré-visualização definido para fuso do servidor |
| Nenhum aviso não revisado | Avisos sinalizam casos extremos como pulos de meses curtos | Cada aviso revisado e resolvido |
| Idempotência do job confirmada | Execuções repetidas não devem corromper dados | Job lida com re-execução com segurança |
| Monitoramento implantado | Falhas silenciosas passam despercebidas | Alerta configurado para execuções perdidas |
| Plano de rollback documentado | Um agendamento ruim precisa de reversão rápida | Versão anterior do crontab salva ou versionada |
Cada item é um gate go/no-go. Se alguma verificação falhar, corrija o problema antes de implantar. O custo de uma revisão de cinco minutos é muito menor que o custo de um incidente por um agendamento mal configurado.
Juntando Tudo
Padrões cron reutilizáveis economizam tempo, mas só entregam valor quando combinados com hábitos de verificação consistentes. Comece por uma expressão conhecida e validada deste catálogo, valide-a no gerador do Cronwise com o fuso horário correto, revise cada aviso e passe pelo checklist pré-produção antes da implantação. Esse fluxo transforma agendamento cron de um jogo de adivinhação em um processo repetível e auditável.
Se você é novo na sintaxe cron e quer construir uma base sólida antes de trabalhar com esses padrões, o artigo Fundamentos de Expressões Cron cobre a estrutura de 5 campos, comportamento de curingas e valores de passo em detalhe. Para prática hands-on com o construtor visual, siga o passo a passo Gerador Visual de Cron.
Todo padrão neste artigo pode ser testado, salvo e exportado diretamente do Cronwise. Sem necessidade de conta, sem dados saindo do navegador, e suas expressões salvas permanecem privadas. Para mais estratégias de agendamento, guias de resolução de problemas e fluxos operacionais, navegue por todos os artigos sobre cron no Cronwise.