Cron Referência de expressões

Padrões avançados

Combinar 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 a começar em janeiro (Jan, Abr, Jul, Out)

Dia do mês vs. Dia da semana

Quando tanto o dia do mês como 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 satisfeita — é uma relação OU, não E. Isto surpreende muita gente.

0 0 15 * 1

Execução no arranque

Embora não seja uma expressão cron propriamente dita, @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 o seu crontab de utilizador com crontab -e:

# Executar cópia de segurança todos os dias à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 utilizador extra:

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

GitHub Actions

O GitHub Actions utiliza 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, consulte 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, terá instâncias sobrepostas. Um script que leva 8 minutos num agendamento */5 * * * * vai acumular.

Soluções:

• Utilize um ficheiro de bloqueio (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

Isto executa em janeiro, março, maio, julho, agosto, outubro e dezembro — mas salta silenciosamente os outros cinco meses. Se precisa de uma tarefa de fim de mês, considere executar no dia 1 e ajustar a lógica do seu script, ou utilize 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 ficheiro crontab. Se a 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