Generatore di espressioni cron

Cos'è un'espressione cron?

Un'espressione cron è un modo compatto per descrivere una pianificazione ricorrente. È la stessa sintassi usata da cron di Unix, lo scheduler originale di Linux, e si è diffusa in quasi tutti gli esecutori di job che incontrerai: CronJob di Kubernetes, schedule di GitHub Actions, AWS EventBridge, Cloudflare Workers, Vercel cron e la maggior parte delle piattaforme CI/CD.

Il formato sembra ostico ma in realtà sono solo cinque campi separati da spazi: minuto, ora, giorno del mese, mese, giorno della settimana. Ogni campo è un numero, una lista (1,15), un intervallo (9-17), un passo (*/5) oppure un jolly (*). Un buon strumento per cron trasforma l'espressione in una frase leggibile e mostra i prossimi orari di esecuzione, così puoi verificarla prima del deploy.

Alcune piattaforme estendono la sintassi base a 5 campi con un campo *secondi* iniziale (Quartz, Spring, Kubernetes a 6 campi) o con un campo *anno* finale. Controlla sempre quale formato accetta il tuo scheduler prima di incollare un'espressione.

Cosa imparerai creando pianificazioni cron

• Un'espressione cron standard ha 5 campi: minuto, ora, giorno del mese, mese, giorno della settimana.
• * significa "ogni valore" per quel campo: è il motivo più comune per cui una pianificazione scatta più spesso del previsto.
• */N significa "ogni N unità": */5 nel campo dei minuti vuol dire "ogni 5 minuti".
• Giorno del mese e giorno della settimana interagiscono: impostarli entrambi restringe la pianificazione, ma nel cron Unix classico impostare uno dei due a * mentre l'altro è specifico è il modo più sicuro per esprimere regole solo per i giorni della settimana o solo mensili.

Come scrivere un'espressione cron passo dopo passo

1. 1

   Parti da un preset

   Scegli un preset vicino a quello che ti serve: Ogni minuto, Ogni ora, Ogni giorno alle 09:00, Giorni feriali alle 09:00, Ogni mese. L'espressione compare nell'editor.

2. 2

   Regola ogni campo

   Modifica minuto, ora, giorno del mese, mese e giorno della settimana. Usa * per qualsiasi valore, liste separate da virgole, intervalli (9-17) o passi (*/15).

3. 3

   Leggi la spiegazione in italiano

   Lo strumento trasforma la tua espressione in una frase (Alle 09:00 nei giorni feriali). Se la frase non corrisponde a quello che volevi, l'espressione è sbagliata.

4. 4

   Guarda in anteprima le prossime esecuzioni

   Verifica i prossimi 5-10 orari di esecuzione nel tuo fuso orario. Fai attenzione ai cambi dell'ora legale se la pianificazione cade vicino al passaggio.

5. 5

   Copiala nel tuo scheduler

   Inserisci l'espressione nel tuo crontab, nel workflow di GitHub Actions, nel CronJob di Kubernetes o in qualunque scheduler tu stia usando.

Campi cron in breve

I cinque campi di un'espressione cron standard, in ordine. Riferimento: la pagina man crontab(5) POSIX.

Esempi di espressioni cron da provare

Errori comuni con cron

• Dimenticare il fuso orario. La maggior parte dei demoni cron scatta nel fuso orario del *server*, non nel tuo. Imposta il fuso orario in modo esplicito quando la piattaforma lo supporta.
• Impostare sia il giorno del mese sia il giorno della settimana. Nel cron Unix classico la pianificazione scatta in un giorno che corrisponde a *uno dei due*, cosa che la prima volta sorprende quasi tutti.
• Usare */45 aspettandosi che scatti ogni 45 minuti. I valori a passo si calcolano a partire da 0, quindi */45 scatta al minuto 0 e al 45, non a un vero intervallo di 45 minuti.
• Non guardare in anteprima le prossime esecuzioni prima del deploy. Un'espressione cron quasi giusta può scattare 60 volte più spesso del previsto.
• Dimenticare i cambi dell'ora legale. Una pianificazione 0 2 * * * può girare due volte nel giorno in cui l'orologio torna indietro, e per niente quando va avanti.

FAQ sulle espressioni cron