Cron Riferimento espressioni

Pattern avanzati

Combinare liste e intervalli

I campi accettano sintassi mista. Per eseguire un job alle 8 e alle 18 nei giorni feriali:

0 8,18 * * 1-5

Per puntare a mesi specifici con un passo:

0 0 1 1-12/3 *    # Ogni 3 mesi a partire da gennaio (Gen, Apr, Lug, Ott)

Giorno del mese vs. Giorno della settimana

Quando sia il giorno del mese che il giorno della settimana sono impostati (non *), il comportamento dipende dall'implementazione. Nel cron standard, il job si esegue se una delle due condizioni è soddisfatta — è una relazione OR, non AND. Questo sorprende molte persone.

0 0 15 * 1

Esecuzione all'avvio

Pur non essendo un'espressione cron in senso stretto, @reboot è una scorciatoia ampiamente supportata:

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

Altre scorciatoie comuni:

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

Cron in diversi ambienti

Crontab Linux

Il classico. Modifica il tuo crontab utente con crontab -e:

# Esegui backup ogni giorno alle 2
0 2 * * * /home/user/scripts/backup.sh >> /var/log/backup.log 2>&1

I job cron di sistema in /etc/cron.d/ includono un campo utente aggiuntivo:

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

GitHub Actions

GitHub Actions usa la stessa sintassi a cinque campi in un trigger schedule. Tutti gli orari sono in UTC.

on:
  schedule:
    - cron: '0 3 * * 1-5'   # Giorni feriali alle 3 UTC

Per un approfondimento sulla configurazione YAML, consulta YAML per Kubernetes e YAML per Docker Compose.

Errori comuni

2. Esecuzioni sovrapposte

Se un job impiega più tempo dell'intervallo tra le esecuzioni, otterrai istanze sovrapposte. Uno script che gira per 8 minuti con una pianificazione */5 * * * * si accumulerà.

Soluzioni:

• Usa un file di blocco (flock su Linux)
• Imposta concurrencyPolicy: Forbid nei CronJob di Kubernetes
• Controlla le istanze in esecuzione all'inizio del tuo script

4. La trappola del "31 di ogni mese"

0 0 31 * *    # Si esegue solo nei mesi con 31 giorni

Questo si esegue a gennaio, marzo, maggio, luglio, agosto, ottobre e dicembre — ma salta silenziosamente gli altri cinque mesi. Se hai bisogno di un job di fine mese, considera di eseguirlo il 1° e adattare la logica del tuo script, o usa uno strumento che supporti la semantica "ultimo giorno del mese".

5. Dimenticare il ritorno a capo alla fine del crontab

Alcune implementazioni di cron richiedono un ritorno a capo alla fine del file crontab. Se la tua ultima voce non si esegue, aggiungi una riga vuota alla fine.

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