Cronjob-Zeitpläne konfigurieren

Cronjobs werden in regelmäßigen Abständen geplant und in einem Format bereitgestellt, das auf unix-cron basiert. Sie können einen Zeitplan so erstellen, dass Ihr Job mehrmals am Tag oder an bestimmten Tagen und in bestimmten Monaten ausgeführt wird. (Auch wenn wir deren Verwendung nicht mehr empfehlen) wird die alte Cron-Syntax von App Engine für vorhandene Jobs weiterhin unterstützt.

Cronjob-Format

Ein Zeitplan wird im Unix-Cron-Stringformat (* * * * *) definiert. Er besteht aus fünf Feldern in einer Zeile, die angeben, wann der Job ausgeführt werden soll.

Format des Unix-Cron-Strings

Zum Planen des Zeitplans können Sie die Google Cloud Console, die Google Cloud CLI oder die Cloud Scheduler REST API verwenden.

Die Zeitfelder haben das folgende Format und mögliche Werte und müssen in dieser Reihenfolge angegeben werden:

Feld Format gültiger Werte
Minute 0–59
Stunde 0–23
Day of the month 1–31
Monat 1–12 (oder JAN bis DEZ)
Wochentag 0–6 (oder SO bis SAT; oder 7 für Sonntag)

Sonderzeichen

  • Ein Feld kann ein Sternchen (*) enthalten, das immer für „first-last&&t“ steht.
  • Bereiche sind zwei Ziffern, die durch einen Bindestrich (-) getrennt sind. Der angegebene Bereich ist einschließlich.
  • Wenn Sie auf einen Bereich mit /NUMBER folgen, werden die Werte für den Wert im Bereich übersprungen. Beispielsweise können sowohl 0-23/2 als auch */2 im Feld „Stunde“ verwendet werden, um die Ausführung alle zwei Stunden festzulegen.
  • Eine Liste umfasst die durch Kommas (,) getrennten Zahlen oder Bereiche. Zum Beispiel gibt 1,2,5,6 im Feld „Monat“ eine Ausführung am ersten, zweiten, fünften und sechsten Tag des Monats an.

Zeitzone

Sie können die Zeitzone für die Auswertung des Zeitplans entweder in der Console (auf der Seite Job erstellen oder in der Liste eine Zeitzone) oder beim Erstellen des Jobs über das Flag gcloud--time-zone auswählen. Die Standardzeitzone ist Etc/UTC.

In einigen Zeitzonen kann die Sommerzeit dazu führen, dass Jobs unerwartet ausgeführt werden. Der Grund dafür ist, dass Cloud Scheduler die Wanduhrzeit ausführt. In Fällen, in denen eine Zeit zweimal vorkommen kann, z. B. wenn die Uhr rückwärts ausgeführt wird, und der Job zu diesem Zeitpunkt geplant ist, kann es sein, dass der geplante Job zu Anomalien führt.

Wenn für Ihren Job ein sehr spezifischer Kadenz erforderlich ist, können Sie eine Zeitzone auswählen, die die Sommerzeit nicht berücksichtigt. Für Cloud Scheduler wird insbesondere UTC empfohlen, um das Problem vollständig zu vermeiden.

Beispielzeitpläne

Die folgende Tabelle zeigt einige Beispiele für Cronjob-Zeitpläne sowie deren Beschreibung:

Beispielzeitplan Cronjob-Format
Jede Minute * * * * *
Jeden Samstag um 23:45 Uhr 45 23 * * 6
Jeden Montag um 9:00 Uhr (9:00 Uhr) 0 9 * * 1
Jeden Sonntag um 04:05 Uhr (4:05 Uhr) 5 4 * * SUN
Jeden Montag bis Freitag um 22:00 Uhr 0 22 * * 1-5