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 Image-Pipeline-Workflows in Image Builder
Mit Image-Workflows können Sie die Workflows, die Ihre Pipeline zum Erstellen, Testen und Verteilen von Images ausführt, an Ihre Bedürfnisse anpassen. Die Workflows, die Sie definieren, werden im Kontext des Image Builder-Workflow-Frameworks ausgeführt. Weitere Informationen zu den Phasen, aus denen das Workflow-Framework besteht, finden Sie unterVerwaltung von Erstellungs-, Test- und Verteilungs-Workflows für Image Builder-Images.
- Arbeitsablauf erstellen
-
Workflows erstellen werden in der
BuildPhase des Workflow-Frameworks ausgeführt. Sie können nur einen Build-Workflow für Ihre Pipeline angeben. Oder Sie können den Build komplett überspringen, um eine Pipeline zu konfigurieren, die nur zum Testen verwendet wird. - Testen Sie den Arbeitsablauf
-
Test-Workflows werden während der
TestPhase des Workflow-Frameworks ausgeführt. Sie können Ihrer Pipeline einen oder mehrere Testworkflows bis zu einer Gesamtzahl von zehn Workflows hinzufügen, wobei auch Ihre Build- und Distribution-Workflows mitgezählt werden. Testworkflows können parallel oder einzeln ausgeführt werden, je nachdem, wie Sie Ihre Testgruppen definieren. Sie können Tests auch komplett überspringen, wenn Sie nur möchten, dass Ihre Pipeline erstellt wird. - Ablauf der Verteilung
-
Die Workflows für die Verteilung werden in der
DistributionPhase des Workflow-Frameworks ausgeführt. Ein Verteilungsworkflow ist optional. Wenn Sie keinen angeben, verteilt Image Builder Ihr AMI trotzdem, indem er die Verteilungskonfiguration ausführt, die Sie an die Pipeline oder das Image anhängen. Geben Sie einen Verteilungsworkflow an, wenn Sie diese Verteilungskonfiguration mit anderen Verteilungseinstellungen außer Kraft setzen oder einen besseren Einblick in den Verteilungsprozess erhalten möchten. Sie können einen Verteilungsworkflow für Ihre Pipeline angeben. Wenn Sie Container-Images erstellen und keinen Verteilungsworkflow angeben, fügt Image Builder den von Amazon verwalteten Workflow für die Containerverteilung für Sie hinzu.
Definieren Sie Testgruppen für Test-Workflows
Sie definieren Testworkflows innerhalb von Testgruppen. Sie können mehrere Testworkflows für Ihre Pipeline ausführen. Das kombinierte Limit liegt bei insgesamt zehn Workflows, einschließlich Ihrer Erstellungs- und Verteilungsworkflows. Sie entscheiden, ob Sie die Testworkflows in einer bestimmten Reihenfolge oder so viele wie möglich gleichzeitig ausführen möchten. Wie sie ausgeführt werden, hängt davon ab, wie Sie Ihre Testgruppen definieren. Die folgenden Szenarien zeigen verschiedene Möglichkeiten, wie Sie Ihre Testworkflows definieren können.
Anmerkung
Die onFailure Einstellungen parallelGroup und gelten nur für Testworkflows. Image Builder lehnt sie in einem Erstellungs- oder Verteilungsworkflow mit einem InvalidParameterCombinationException ab.
Wie werden Testgruppen ausgeführt
Image Builder führt Ihre Testworkflows in Testgruppen aus. Es führt die Gruppen nacheinander aus. Die Testworkflows innerhalb einer einzelnen Gruppe werden gleichzeitig (parallel) ausgeführt. Image Builder führt bis zu fünf Testworkflows gleichzeitig aus. Wenn eine Gruppe mehr als fünf hat, startet Image Builder den nächsten Testworkflow, sobald jeder einzelne abgeschlossen ist. Ein Testworkflow, der nicht Teil einer Gruppe ist, wird eigenständig ausgeführt.
Wie Sie Testgruppen definieren, hängt davon ab, ob Sie die Konsole oder die AWS CLI UND-API verwenden. Wählen Sie die Registerkarte aus, die der von Ihnen verwendeten Methode entspricht.
Szenario 1: Führen Sie jeweils einen Testworkflow aus
Um alle Ihre Testworkflows nacheinander auszuführen, konfigurieren Sie für jeden Testworkflow eine separate Testgruppe bis zur kombinierten Grenze von insgesamt zehn Workflows (einschließlich Ihrer Erstellungs- und Verteilungsworkflows). Image Builder führt die Testgruppen nacheinander aus. Auf diese Weise können Sie sicherstellen, dass Ihre Testworkflows nacheinander in einer bestimmten Reihenfolge ausgeführt werden.
Szenario 2: Führen Sie mehrere Testworkflows gleichzeitig aus
Wenn die Reihenfolge keine Rolle spielt und Sie so viele Testworkflows wie möglich gleichzeitig ausführen möchten, können Sie eine einzelne Testgruppe konfigurieren und die maximale Anzahl von Testworkflows darin angeben. Image Builder startet bis zu fünf Testworkflows gleichzeitig und startet weitere Testworkflows, wenn andere Workflows abgeschlossen sind. Wenn Ihr Ziel darin besteht, Ihre Test-Workflows so schnell wie möglich auszuführen, ist dies eine Möglichkeit.
Szenario 3: Mischen und Kombinieren
Wenn Sie ein gemischtes Szenario haben, bei dem einige Testworkflows gleichzeitig ausgeführt werden können und andere, die nacheinander ausgeführt werden sollten, können Sie Ihre Testgruppen so konfigurieren, dass dieses Ziel erreicht wird. Die einzige Grenze für die Konfiguration Ihrer Testgruppen ist die maximale Anzahl von Testworkflows, die für Ihre Pipeline ausgeführt werden können
Legen Sie Workflow-Parameter in einer Image Builder-Pipeline von der Konsole aus fest
Workflow-Parameter funktionieren für Erstellungs-, Test- und Verteilungs-Workflows auf die gleiche Weise. Wenn Sie eine Pipeline erstellen oder aktualisieren, wählen Sie die Workflows zum Erstellen, Testen und Verteilen aus, die Sie einbeziehen möchten. Wenn Sie im Workflow-Dokument für einen von Ihnen ausgewählten Workflow Parameter definiert haben, zeigt Image Builder sie im Parameterbereich an. Das Bedienfeld ist für Workflows, für die keine Parameter definiert sind, ausgeblendet.
Jeder Parameter zeigt die folgenden Attribute an, die Ihr Workflow-Dokument definiert hat:
Name (nicht bearbeitbar) — Der Name des Parameters.
Typ (nicht bearbeitbar) — Der Datentyp für den Parameterwert.
-
Wert — Der Wert für den Parameter. Sie können den Parameterwert bearbeiten, um ihn für Ihre Pipeline festzulegen.
Geben Sie die IAM-Servicerolle an, die Image Builder zum Ausführen von Workflow-Aktionen verwendet
Wenn Sie benutzerdefinierte Image-Workflows an Ihre Pipeline anhängen oder wenn Sie eine Protokollierungskonfiguration einrichten, müssen Sie auch eine Ausführungsrolle angeben. Dies ist die IAM-Rolle, die Image Builder zur Ausführung Ihrer Workflow-Aktionen annimmt. Die Rolle muss dem Image Builder-Dienstprinzipal vertrauen. Die erforderlichen Berechtigungen finden Sie in den folgenden Informationen zum Zugriff auf den Workflow-Dienst.
Um Image-Workflows ausführen zu können, benötigt Image Builder die Erlaubnis, Workflow-Aktionen auszuführen. Sie gewähren diese Berechtigung mit einer Ausführungsrolle, die Image Builder in Ihrem Namen übernimmt. Sie weisen die Ausführungsrolle wie folgt zu.
Wichtig
Es wird empfohlen, die AWSServiceRoleForImageBuilder dienstgebundene Rolle nicht als Ausführungsrolle zu übergeben. Erstellen Sie stattdessen eine benutzerdefinierte IAM-Rolle und hängen Sie die EC2ImageBuilderExecutionPolicy AWS verwaltete Richtlinie an. Diese Richtlinie gewährt dieselben Berechtigungen, die Image Builder benötigt, um in AWS-Services Ihrem Namen anzurufen. Durch die Verwendung einer benutzerdefinierten Rolle haben Sie die volle Kontrolle über die Berechtigungen, die Image Builder verwendet. Außerdem bleiben Ihre Service Control Policies (SCPs) und Resource Control Policies (RCPs) für Vorgänge gültig, die Image Builder in Ihrem Namen ausführt.
-
Konsole — Wählen Sie im Pipeline-Assistenten Schritt 3 Definieren Sie den Image-Erstellungsprozess und wählen Sie Ihre benutzerdefinierte Rolle aus der IAM-Rollenliste im Bereich Service Access aus.
-
Image Builder-API — Geben Sie in der CreateImage Aktionsanfrage Ihre benutzerdefinierte Rolle als Wert für den
executionRoleParameter an.
Informationen zum Erstellen einer benutzerdefinierten Ausführungsrolle finden Sie im AWS Identity and Access Management Benutzerhandbuch unter Erstellen einer Rolle zum Delegieren von Berechtigungen an einen AWS Dienst.
Ordnen Sie Workflows einer Pipeline zu
Um benutzerdefinierte Image-Workflows zum Erstellen, Testen und Verteilen Ihrer Pipeline zuzuordnen, wählen Sie die Registerkarte aus, die der Methode entspricht, die Sie verwenden möchten.
