Verwenden Sie Cron-Ausdrücke in EC2 Image Builder - EC2 Image Builder

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden Sie Cron-Ausdrücke in EC2 Image Builder

Verwenden Sie Cron-Ausdrücke für EC2 Image Builder, um ein Zeitfenster einzurichten, in dem Ihr Image mit Updates aktualisiert wird, die für das Basis-Image und die Komponenten Ihrer Pipeline gelten. Das Zeitfenster für Ihre Pipeline-Aktualisierung beginnt mit der Zeit, die Sie im Cron-Ausdruck festgelegt haben. Sie können die Zeit in Ihrem Cron-Ausdruck auf die Minute genau festlegen. Ihr Pipeline-Build kann am oder nach der Startzeit ausgeführt werden.

Es kann manchmal einige Sekunden oder bis zu einer Minute dauern, bis Ihr Build ausgeführt wird.

Anmerkung

Cron-Ausdrücke verwenden standardmäßig die Zeitzone UTC (Universal Coordinated Time), oder Sie können die Zeitzone angeben. Weitere Informationen zur UTC-Zeit und zum Ermitteln des Offsets für Ihre Zeitzone finden Sie unter Abkürzungen für Zeitzonen — Weltweite Liste.

Unterstützte Werte für Cron-Ausdrücke in Image Builder

EC2 Image Builder verwendet ein Cron-Format, das aus sechs Pflichtfeldern besteht. Jedes Feld ist von den anderen durch ein Leerzeichen getrennt, ohne führende oder nachgestellte Leerzeichen:

<Minute> <Hour> <Day> <Month> <Day of the week> <Year>

Die folgende Tabelle zeigt die Werte, die für erforderliche Cron-Einträge unterstützt werden.

Unterstützte Werte für Cron-Ausdrücke
Feld Werte Platzhalter
Minute 0-59 , - * /
Stunde 0-23 , - * /
Tag 1-31 , - * ? / L W
Monat 1-12 oder jan-dec , - * /
Tag der Woche 1-7 oder sun-sat , - * ? L #
Jahr 1970-2199 , - * /
Platzhalter

In der folgenden Tabelle wird beschrieben, wie Image Builder Platzhalter für Cron-Ausdrücke verwendet. Beachten Sie, dass es nach der von Ihnen angegebenen Zeit bis zu einer Minute dauern kann, bis der Build gestartet wird.

Unterstützte Platzhalter für Cron-Ausdrücke
Platzhalter Beschreibung
, Das Platzhalterzeichen , (Komma) schließt zusätzliche Werte ein. Im Feld Monat jan,feb,mar sind Januar, Februar und März enthalten.
- Das Platzhalterzeichen - (Bindestrich) gibt einen Bereich an. Schließt im Feld Tag des Monats die Tage 1 bis 15 des angegebenen Monats ein. 1-15
* Der Platzhalter * (Sternchen) enthält alle gültigen Werte für das Feld.
? Der Platzhalter ? (Fragezeichen) gibt an, dass der Feldwert von einer anderen Einstellung abhängt. Wenn bei den Feldern Day und D eines der ay-of-week Felder angegeben ist oder alle möglichen Werte (*) enthält, muss das andere Feld a ? sein. Sie können nicht beides angeben. Wenn Sie beispielsweise a 7 in das Feld Tag eingeben (führen Sie den Build am siebten Tag des Monats aus), muss die ay-of-week D-Position a enthalten?.
/ Das Platzhalterzeichen / (Schrägstrich) steht für schrittweise Steigerungen. Wenn Sie beispielsweise möchten, dass Ihr Build jeden zweiten Tag ausgeführt wird, geben Sie */2 in das Feld Tag ein.
L Der Platzhalter L in einem der Tagesfelder gibt den letzten Tag an: 28-31 für den Tag des Monats, je nachdem, welcher Monat ist, oder Sonntag für den Wochentag.
W Der Platzhalter W im ay-of-month Feld D gibt einen Wochentag an. Wenn Sie im ay-of-month Feld D eine Zahl vor dem eingeben, bedeutet dasW, dass Sie den Wochentag als Ziel angeben möchten, der diesem Tag am nächsten liegt. Wenn Sie beispielsweise angeben3W, dass Ihr Build an dem Wochentag ausgeführt werden soll, der dem dritten Tag des Monats am nächsten liegt.
# Das # (Hash) ist nur für das Feld Wochentag zulässig und muss von einer Zahl zwischen 1 und 5 gefolgt werden. Die Zahl gibt an, in welchen Wochen in einem bestimmten Monat der Build ausgeführt werden kann. Wenn Sie beispielsweise möchten, dass Ihr Build am zweiten Freitag eines jeden Monats ausgeführt wird, verwenden Sie das Feld fri#2 für den Wochentag.
Einschränkungen
  • Sie können die ay-of-week Felder D ay-of-month und D nicht in demselben Cron-Ausdruck angeben. Wenn Sie einen Wert oder * in einem dieser Felder angeben, müssen Sie ? in dem anderen Feld a verwenden.

  • cron-Ausdrücke werden mit einer Ausführungsrate ab einer Minute unterstützt, kürzere Intervalle sind nicht möglich.

Beispiele für Cron-Ausdrücke in EC2 Image Builder

Cron-Ausdrücke werden für die Image Builder Builder-Konsole anders eingegeben als für die API oder CLI. Um Beispiele zu sehen, wählen Sie die für Sie zutreffende Registerkarte aus.

Image Builder console

Die folgenden Beispiele zeigen Cron-Ausdrücke, die Sie in die Konsole für Ihren Build-Zeitplan eingeben können. Die UTC-Zeit wird im 24-Stunden-Format angegeben.

Wird täglich um 10:00 Uhr (UTC) ausgeführt

0 10 * * ? *

Läuft täglich um 12:15 Uhr (UTC)

15 12 * * ? *

Läuft täglich um Mitternacht (UTC)

0 0 * * ? *

Läuft an jedem Werktagmorgen um 10:00 Uhr (UTC)

0 10 ? * 2-6 *

Laufen Sie an jedem Wochentag abends um 18 Uhr (UTC)

0 18 ? * mon-fri *

Läuft am ersten Tag jedes Monats um 8:00 Uhr (UTC)

0 8 1 * ? *

Läuft jeden zweiten Dienstag im Monat um 22:30 Uhr (UTC)

30 22 ? * tue#2 *

Tipp

Wenn Sie nicht möchten, dass sich Ihr Pipeline-Job während der Ausführung auf den nächsten Tag erstreckt, stellen Sie sicher, dass Sie bei der Angabe der Startzeit die Zeit für Ihren Build berücksichtigen.

API/CLI

Die folgenden Beispiele zeigen Cron-Ausdrücke, die Sie mithilfe von CLI-Befehlen oder API-Anfragen für Ihren Build-Zeitplan eingeben können. Nur der Cron-Ausdruck wird angezeigt.

Wird täglich um 10:00 Uhr (UTC) ausgeführt

cron(0 10 * * ? *)

Läuft täglich um 12:15 Uhr (UTC)

cron(15 12 * * ? *)

Läuft täglich um Mitternacht (UTC)

cron(0 0 * * ? *)

Läuft an jedem Werktagmorgen um 10:00 Uhr (UTC)

cron(0 10 ? * 2-6 *)

Laufen Sie an jedem Wochentag abends um 18:00 Uhr (UTC)

cron(0 18 ? * mon-fri *)

Läuft am ersten Tag jedes Monats um 8:00 Uhr (UTC)

cron(0 8 1 * ? *)

Läuft jeden zweiten Dienstag im Monat um 22:30 Uhr (UTC)

cron(30 22 ? * tue#2 *)

Tipp

Wenn Sie nicht möchten, dass sich Ihr Pipeline-Job während der Ausführung auf den nächsten Tag erstreckt, stellen Sie sicher, dass Sie bei der Angabe der Startzeit die Zeit für Ihren Build berücksichtigen.

Ausdrücke in EC2 Image Builder bewerten

Ein Rate-Ausdruck beginnt, wenn Sie eine Regel für ein geplantes Ereignis erstellen und mit dem definierten Zeitplan ausführen.

Rate-Ausdrücke bestehen aus zwei Pflichtfeldern. Die Felder werden durch ein Leerzeichen voneinander getrennt.

Syntax

rate(value unit)
Wert

Eine positive Zahl.

Einheit

Die Zeiteinheit. Für Werte von 1 werden verschiedene Einheiten benötigt, z. B. minute, ebenso für Werte über 1, z. B. minutes.

Zulässige Werte: Minute | Minuten | Stunde | Stunden | Tag | Tage

Einschränkungen

Wenn der Wert gleich 1 ist, muss die Einheit im Singular stehen. Wenn die Werte größer als 1 sind, muss die Einheit im Plural stehen. Beispielsweise sind rate(1 hours) und rate(5 hour) ungültige, rate(1 hour) und rate(5 hours) jedoch gültige Werte.