Konfigurieren Sie die Pipeline-Ausführungseinstellungen für Image-Pipelines - EC2 Image Builder
Automatische Deaktivierung einer fehlgeschlagenen PipelinePipeline-Protokollierung konfigurieren

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.

Konfigurieren Sie die Pipeline-Ausführungseinstellungen für Image-Pipelines

Sie können aus den folgenden Optionen wählen, um die Pipelineausführung zu planen:

Schedule Builder

Verwenden Sie den Schedule Builder, um die automatische, wiederkehrende Pipeline-Ausführung zu konfigurieren. Sie definieren, wann und wie oft Ihre Pipeline ausgeführt werden soll (Tag, Uhrzeit und Häufigkeit). Der Standardplan ist jede Woche und basiert auf dem Tag und der Uhrzeit, an dem der Zeitplan erstellt wird (UTC).

cron-Ausdruck

Führen Sie die Pipeline automatisch mit einem Cron-Ausdruck aus, der den Zeitplan angibt. Weitere Informationen zur Cron-Syntax, die Image Builder verwendet, finden Sie unterVerwenden Sie Cron-Ausdrücke in Image Builder.

Manuell

Die Pipeline läuft nicht nach einem Zeitplan. Wählen Sie in der Konsole im Menü Aktionen die Option Pipeline ausführen aus, um die Pipeline auszuführen. Von der AWS CLI aus können Sie ausführenstart-image-pipeline-execution.

Einstellungen für Abhängigkeiten

Bei geplanten Builds können Sie wählen, ob die Ausführung immer nach dem Zeitplan ausgeführt werden soll oder ob die Pipeline-Ausführung übersprungen werden soll, sofern keine Abhängigkeitsupdates vorliegen, z. B. eine Änderung am Basis-Image oder an einer Komponente, die im Rezept verwendet wird.

Automatische Deaktivierung einer fehlgeschlagenen Pipeline

Für Image-Pipelines, die nach einem Zeitplan ausgeführt werden, können Sie die maximale Anzahl aufeinanderfolgender Fehler so konfigurieren, dass (bis zu10) zulässig ist, bevor Image Builder die Pipeline automatisch deaktiviert.

Einstellungen automatisch deaktivieren

Image Builder verfolgt die Anzahl aufeinanderfolgender Fehler bei geplanten Pipeline-Ausführungen und führt bei jeder Ausführung nach einem Zeitplan eine der folgenden Aktionen durch:

  • Wenn die Pipeline-Ausführung erfolgreich ist, wird die Anzahl der aufeinanderfolgenden Fehler auf Null zurückgesetzt.

  • Wenn die Pipeline-Ausführung fehlschlägt, erhöht Image Builder die Anzahl der aufeinanderfolgenden Fehler. Wenn die Anzahl der Fehler den in definierten Grenzwert überschreitetAutoDisablePolicy, deaktiviert Image Builder die Pipeline.

Die Anzahl aufeinanderfolgender Fehler wird unter den folgenden Bedingungen ebenfalls auf Null zurückgesetzt:

  • Die Pipeline wird manuell ausgeführt und ist erfolgreich.

  • Die Pipeline-Konfiguration wurde aktualisiert.

Wenn die Pipeline manuell ausgeführt wird und ausfällt, bleibt die Anzahl gleich. Der nächste geplante Lauf wird an der Stelle fortgesetzt, an der er zuvor aufgehört hat.

Pipeline-Protokollierung konfigurieren

Wenn Sie eine Image-Pipeline erstellen oder aktualisieren, können Sie benutzerdefinierte CloudWatch Logs-Gruppen für Image-Build- und Pipeline-Logs konfigurieren. Stellen Sie sicher, dass Ihre benutzerdefinierte Pipeline-Ausführungsrolle über die folgenden Berechtigungen verfügt, um die Protokollgruppenressourcen zu erstellen und darauf zuzugreifen.

  • Protokolle: CreateLogGroup

  • Protokolle: CreateLogStream

  • Protokolle: PutLogEvents

Benutzerdefinierte Protokollgruppen

Um benutzerdefinierte Protokollgruppen für die Image-Erstellung oder die Pipeline-Ausführung zu verwenden, erstellen Sie zunächst die Protokollgruppe in CloudWatch Logs. Weitere Informationen finden Sie unter Erstellen einer Protokollgruppe im Amazon CloudWatch Logs-Benutzerhandbuch. Weitere Hinweise zu den Anforderungen für die Benennung von Protokollgruppen finden Sie CreateLogGroupin der Amazon CloudWatch Logs API-Referenz.

Console

Geben Sie die Image-Protokollgruppe oder Pipeline-Protokollgruppe für Ihre Pipeline im Abschnitt Logging-Konfiguration unter Erweiterte Einstellungen an.

CLI

Geben Sie die folgenden Felder innerhalb des logging-configuration Objekts an, wenn Sie ein JSON-Objekt für die Konfiguration verwenden:

  • imageLogGroupName

  • pipelineLogGroupName

Informationen zur direkten Angabe aller Parameter in der Befehlszeile finden Sie create-image-pipelinein der AWS CLI Befehlsreferenz.

Image Builder verwendet die folgenden Standardprotokollgruppen, wenn Sie keine benutzerdefinierte Protokollgruppe angeben:

Protokolle zur Image-Erstellung

Image Builder schreibt Build-Logs in die folgende Image Builder CloudWatch Builder-Protokollgruppe und den folgenden Stream:

LogGroup: /aws/imagebuilder/ImageName

LogStream (x.x.x/x): ImageVersion/ImageBuildVersion

Protokolle zur Pipeline-Ausführung

Image Builder schreibt Pipeline-Ausführungsprotokolle in die folgende Image Builder CloudWatch Builder-Protokollgruppe und den folgenden Stream:

LogGroup: /aws/imagebuilder/pipeline/pipeline-name

LogStream: 2025/09/01 (das Ausführungsdatum der Pipeline im YYYY/MM/DD Format)

Jedes Pipeline-Protokoll wird an den Stream für diesen Tag angehängt.