Cron Referência de expressões

Padrões avançados

Combinando listas e intervalos

Os campos aceitam sintaxe mista. Para executar uma tarefa às 8h e 18h em dias úteis:

0 8,18 * * 1-5

Para direcionar meses específicos com um passo:

0 0 1 1-12/3 *    # A cada 3 meses começando em janeiro (Jan, Abr, Jul, Out)

Dia do mês vs. Dia da semana

Quando tanto o dia do mês quanto o dia da semana estão definidos (não *), o comportamento depende da implementação. No cron padrão, a tarefa executa se qualquer uma das condições for atendida — é uma relação OU, não E. Isso surpreende muitas pessoas.

0 0 15 * 1

Execução na inicialização

Embora não seja uma expressão cron propriamente, @reboot é um atalho amplamente suportado:

@reboot /usr/local/bin/start-service.sh

Outros atalhos comuns:

Atalho	Equivalente
@yearly	0 0 1 1 *
@monthly	0 0 1 * *
@weekly	0 0 * * 0
@daily	0 0 * * *
@hourly	0 * * * *

Cron em diferentes ambientes

Crontab Linux

O clássico. Edite seu crontab de usuário com crontab -e:

# Executar backup todo dia às 2h
0 2 * * * /home/user/scripts/backup.sh >> /var/log/backup.log 2>&1

Tarefas cron do sistema em /etc/cron.d/ incluem um campo de usuário extra:

0 2 * * * root /usr/local/bin/cleanup.sh

GitHub Actions

O GitHub Actions usa a mesma sintaxe de cinco campos dentro de um gatilho schedule. Todos os horários são UTC.

on:
  schedule:
    - cron: '0 3 * * 1-5'   # Dias úteis às 3h UTC

Para um aprofundamento na configuração YAML, veja YAML para Kubernetes e YAML para Docker Compose.

Armadilhas comuns

2. Execuções sobrepostas

Se uma tarefa demora mais que o intervalo entre execuções, você terá instâncias sobrepostas. Um script que leva 8 minutos em um agendamento */5 * * * * vai acumular.

Soluções:

• Use um arquivo de lock (flock no Linux)
• Defina concurrencyPolicy: Forbid nos CronJobs do Kubernetes
• Verifique instâncias em execução no início do seu script

4. A armadilha do "dia 31 de cada mês"

0 0 31 * *    # Só executa em meses com 31 dias

Isso executa em janeiro, março, maio, julho, agosto, outubro e dezembro — mas pula silenciosamente os outros cinco meses. Se você precisa de uma tarefa de fim de mês, considere executar no dia 1 e ajustar a lógica do seu script, ou use uma ferramenta que suporte semânticas de "último dia do mês".

5. Esquecer a quebra de linha no final do crontab

Algumas implementações de cron requerem uma quebra de linha final no arquivo crontab. Se sua última entrada não executa, adicione uma linha vazia no final.

Kubernetes CronJob

apiVersion: batch/v1
kind: CronJob
metadata:
  name: nightly-report
spec:
  schedule: "0 2 * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
            - name: report
              image: reporting:latest
              command: ["python", "generate_report.py"]
          restartPolicy: OnFailure