

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
<a name="schedule-pipeline"></a>

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 unter[Verwenden Sie Cron-Ausdrücke in Image Builder](cron-expressions.md).

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ühren`start-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
<a name="schedule-pipeline-auto-disable"></a>

Für Image-Pipelines, die nach einem Zeitplan ausgeführt werden, können Sie die maximale Anzahl aufeinanderfolgender Fehler so konfigurieren, dass (bis zu`10`) 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 überschreitet`AutoDisablePolicy`, 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
<a name="configure-pipeline-logging"></a>

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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) im *Amazon CloudWatch Logs-Benutzerhandbuch*. Weitere Hinweise zu den Anforderungen für die Benennung von Protokollgruppen finden Sie [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)in 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-pipeline](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-image-pipeline.html)in 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.