Generator wyrażeń cron

Czym jest wyrażenie cron?

Wyrażenie cron to zwięzły sposób opisania cyklicznego harmonogramu. To ta sama składnia, której używa uniksowy cron, oryginalny harmonogram zadań w Linuksie, i trafiła ona do prawie każdego systemu zadań, jaki spotkasz: Kubernetes CronJobs, harmonogramów GitHub Actions, AWS EventBridge, Cloudflare Workers, Vercel cron i większości platform CI/CD.

Format wygląda groźnie, ale to tylko pięć pól oddzielonych spacjami: minuta, godzina, dzień miesiąca, miesiąc, dzień tygodnia. Każde pole to liczba, lista (1,15), zakres (9-17), krok (*/5) lub symbol wieloznaczny (*). Dobre narzędzie do crona zamienia wyrażenie na zwykłe zdanie i pokazuje kolejne terminy uruchomień, żeby można było je sprawdzić przed wdrożeniem.

Niektóre platformy rozszerzają podstawową składnię 5 pól o pole *sekund* na początku (Quartz, Spring, 6-polowy Kubernetes) lub pole *roku* na końcu. Zawsze sprawdź, jaki format akceptuje twój harmonogram, zanim wkleisz wyrażenie.

Czego nauczysz się, tworząc harmonogramy cron

• Standardowe wyrażenie cron ma 5 pól: minuta, godzina, dzień miesiąca, miesiąc, dzień tygodnia.
• * oznacza "każdą wartość" w danym polu i to najczęstszy powód, dla którego harmonogram uruchamia się częściej, niż się spodziewano.
• */N oznacza "co N jednostek": */5 w polu minut to "co 5 minut".
• Dzień miesiąca i dzień tygodnia wpływają na siebie nawzajem: ustawienie obu zawęża harmonogram, ale w klasycznym uniksowym cronie ustawienie jednego z nich na *, a drugiego na konkretną wartość to bezpieczniejszy sposób zapisu reguł tylko dla dni tygodnia lub tylko miesięcznych.

Jak krok po kroku napisać wyrażenie cron

1. 1

   Zacznij od gotowego ustawienia

   Wybierz ustawienie bliskie temu, czego potrzebujesz: Co minutę, Co godzinę, Codziennie o 9:00, W dni robocze o 9:00, Co miesiąc. Wyrażenie pojawi się w edytorze.

2. 2

   Dostosuj każde pole

   Edytuj minutę, godzinę, dzień miesiąca, miesiąc i dzień tygodnia. Używaj * dla dowolnej wartości, list z przecinkami, zakresów (9-17) lub kroków (*/15).

3. 3

   Przeczytaj opis w zwykłym języku

   Narzędzie zamienia wyrażenie na zdanie (O 09:00 w dni robocze). Jeśli zdanie nie odpowiada temu, czego chcesz, wyrażenie jest błędne.

4. 4

   Podejrzyj kolejne uruchomienia

   Sprawdź od 5 do 10 najbliższych terminów w swojej lokalnej strefie czasowej. Uważaj na zmiany czasu letniego, jeśli harmonogram wypada blisko przestawienia zegarów.

5. 5

   Skopiuj do harmonogramu

   Wklej wyrażenie do crontab, workflow GitHub Actions, Kubernetes CronJob lub dowolnego harmonogramu, którego używasz.

Pola crona: ściąga

Pięć pól standardowego wyrażenia cron, po kolei. Źródło: strona podręcznika POSIX crontab(5).

Przykłady wyrażeń cron do wypróbowania

Częste błędy przy cronie

• Zapominanie o strefie czasowej. Większość demonów cron działa w strefie czasowej *serwera*, a nie twojej. Ustaw strefę czasową jawnie, jeśli platforma na to pozwala.
• Ustawianie jednocześnie dnia miesiąca i dnia tygodnia. W klasycznym uniksowym cronie harmonogram uruchamia się w dniu pasującym do *dowolnego* z nich, co za pierwszym razem zaskakuje większość osób.
• Używanie */45 w oczekiwaniu, że zadanie będzie uruchamiane co 45 minut. Wartości krokowe liczone są od 0, więc */45 uruchamia się w minucie 0 i 45, a nie w prawdziwym 45-minutowym odstępie.
• Brak podglądu kolejnych uruchomień przed wdrożeniem. Wyrażenie cron, które jest prawie dobre, może uruchamiać się 60 razy częściej, niż zamierzano.
• Zapominanie o zmianie czasu. Harmonogram 0 2 * * * może uruchomić się dwa razy w dniu cofnięcia zegarów i ani razu, gdy zegary przesuwają się do przodu.

Wyrażenia cron: FAQ