

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.

# Erstellen Sie einen Image-Workflow
<a name="image-workflow-create-resource"></a>

Wenn Sie einen Image-Workflow erstellen, haben Sie mehr Kontrolle über Ihren Image-Erstellungsprozess. Sie können den Workflow angeben, der ausgeführt wird, wenn Image Builder Ihr Image erstellt, die Workflows, die ausgeführt werden, wenn das Image getestet wird, und den Workflow, der ausgeführt wird, wenn das Image verteilt wird. Sie können auch einen vom Kunden verwalteten Schlüssel angeben, um Ihre Workflow-Ressourcen zu verschlüsseln. Weitere Informationen zur Verschlüsselung Ihrer Workflow-Ressourcen finden Sie unter[Verschlüsselung und Schlüsselverwaltung in Image Builder](data-protection.md#ib-encryption).

Für die Image-Erstellung können Sie einen Workflow für die Erstellungsphase, einen oder mehrere Workflows für die Testphase und einen Workflow für die Verteilungsphase angeben. Je nach Ihren Bedürfnissen können Sie sogar eine Phase komplett überspringen. Sie konfigurieren die Aktionen, die Ihr Workflow ausführt, in dem YAML-Definitionsdokument, das Ihr Workflow verwendet. Weitere Informationen zur Syntax für Ihr YAML-Dokument finden Sie unter. [Erstellen Sie ein YAML-Workflow-Dokument](image-workflow-create-document.md)

Um einen neuen Build-, Test- oder Distribution-Workflow zu erstellen, wählen Sie die Registerkarte aus, die Ihrer Umgebung entspricht.

------
#### [ AWS-Managementkonsole ]

Sie können den folgenden Prozess verwenden, um einen neuen Workflow in der Image Builder-Konsole zu erstellen.

1. Öffnen Sie die EC2 Image Builder-Konsole unter [ https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).

1. Wählen Sie im Navigationsbereich ** Image-Workflows ** aus. Daraufhin wird eine Liste der Image-Workflows angezeigt, die Ihrem Konto gehören oder auf die Sie Zugriff haben.
**Anmerkung**  
Die Liste enthält immer die von Amazon verwalteten Workflow-Ressourcen, die Image Builder für seine Standard-Workflows verwendet. Um Details für diese Workflows anzuzeigen, wählen Sie den ** ** Workflow-Link.

1. Um einen neuen Workflow zu erstellen, wählen Sie Image-Workflow ** erstellen**. Daraufhin wird die ** Workflow-Seite „Image ** erstellen“ angezeigt.

1. Konfigurieren Sie die Details für Ihren neuen Workflow. Wählen Sie oben im Formular den Workflowtyp aus: Wählen Sie Erstellen, ** um einen ** Build-Workflow zu erstellen, ** Test, ** um einen Test-Workflow zu erstellen, oder ** Verteilung, ** um einen Verteilungsworkflow zu erstellen. Der Workflowtyp entspricht dem `Type` Wert in der API (`BUILD``TEST`, oder`DISTRIBUTION`). Image Builder füllt die ** ** Vorlagenliste auf der Grundlage dieser Option auf. Alle anderen Schritte sind für Erstellungs-, Test- und Verteilungs-Workflows identisch.

**General**  
Der allgemeine Abschnitt enthält Einstellungen, die für Ihre Workflow-Ressource gelten, wie Name und Beschreibung. Zu den allgemeinen Einstellungen gehören die folgenden:
   + **Name des Image-Workflows ** (erforderlich) — Der Name für Ihren Image-Workflow. Der Name muss in Ihrem Konto eindeutig sein. Der Name kann bis zu 128 Zeichen lang sein. Zu den gültigen Zeichen gehören Buchstaben, Zahlen`-`, Leerzeichen und`_`.
   + **Version ** (erforderlich) — Die semantische Version für die zu erstellende Workflow-Ressource (**major.minor.patch).
   + **Beschreibung ** (optional) — Fügen Sie optional eine Beschreibung für Ihren Workflow hinzu.
   + **KMS-Schlüssel ** (optional) — Sie können Ihre Workflow-Ressourcen mit einem vom Kunden verwalteten Schlüssel verschlüsseln. Weitere Informationen finden Sie unter [Verschlüsseln Sie Image-Workflows mit einem vom Kunden verwalteten Schlüssel](data-protection.md#ib-workflow-encrypt-cmk).

**Definitionsdokument**  
Das YAML-Workflow-Dokument enthält die gesamte Konfiguration für Ihren Workflow.

**Erste Schritte**
   + Um mit einer Image Builder-Standardvorlage als Grundlage für Ihren Workflow zu beginnen, wählen Sie die ** Option Mit Vorlagen ** beginnen. Diese Option ist standardmäßig ausgewählt. Nachdem Sie aus der ** ** Vorlagenliste ausgewählt haben, welche Vorlage Sie verwenden möchten, wird die Standardkonfiguration aus der ausgewählten Vorlage in den ** Inhalt ** Ihres neuen Workflow-Dokuments kopiert, wo Sie Änderungen vornehmen können.
   + Um Ihr Workflow-Dokument von Grund auf neu zu definieren, wählen Sie die ** Option Von vorne ** beginnen. Dadurch wird der ** Inhalt ** mit einer kurzen Beschreibung einiger wichtiger Teile des Dokumentformats gefüllt, um Ihnen den Einstieg zu erleichtern.

   Das ** ** Inhaltsfenster enthält unten eine Statusleiste, in der Warnungen oder Fehler für Ihr YAML-Dokument angezeigt werden. Weitere Informationen zum Erstellen eines YAML-Workflow-Dokuments finden Sie unter. [Erstellen Sie ein YAML-Workflow-Dokument](image-workflow-create-document.md)

1. Wenn Sie Ihren Workflow abgeschlossen haben oder wenn Sie den Fortschritt speichern und später darauf zurückkommen möchten, wählen Sie Workflow ** ** erstellen.

------
#### [ AWS CLI ]

Bevor Sie den **[create-workflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html)** Befehl in der ausführen AWS CLI, müssen Sie das YAML-Dokument erstellen, das die gesamte Konfiguration für Ihren Workflow enthält. Weitere Informationen finden Sie unter [Erstellen Sie ein YAML-Workflow-Dokument](image-workflow-create-document.md).

Das folgende Beispiel zeigt, wie Sie einen Build-Workflow mit dem Befehl [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html) AWS CLI create-workflow erstellen. Der `--data` Parameter bezieht sich auf ein YAML-Dokument, das die Build-Konfiguration für den von Ihnen erstellten Workflow enthält.

**Beispiel: Workflow erstellen **

```
aws imagebuilder create-workflow --name {{example-build-workflow}} --semantic-version {{1.0.0}} --type BUILD --data {{file://example-build-workflow.yml}}
```

**Ausgabe:**

```
{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:{{us-west-2}}:{{111122223333}}:workflow/build/example-build-workflow/{{1.0.0}}/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}
```

Das folgende Beispiel zeigt, wie Sie einen Testworkflow mit dem Befehl [ create-workflow ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html) AWS CLI erstellen. Der `--data` Parameter bezieht sich auf ein YAML-Dokument, das die Testkonfiguration für den von Ihnen erstellten Workflow enthält.

**Beispiel: Testworkflow erstellen **

```
aws imagebuilder create-workflow --name {{example-test-workflow}} --semantic-version {{1.0.0}} --type TEST --data {{file://example-test-workflow.yml}}
```

**Ausgabe:**

```
{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:{{us-west-2}}:{{111122223333}}:workflow/test/example-test-workflow/{{1.0.0}}/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}
```

Das folgende Beispiel zeigt, wie Sie einen Verteilungsworkflow mit dem Befehl [ create-workflow ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html) AWS CLI erstellen. Der `--data` Parameter bezieht sich auf ein YAML-Dokument, das die Verteilungskonfiguration für den von Ihnen erstellten Workflow enthält.

**Beispiel: Verteilungsworkflow erstellen **

```
aws imagebuilder create-workflow --name {{example-distribution-workflow}} --semantic-version {{1.0.0}} --type DISTRIBUTION --data {{file://example-distribution-workflow.yml}}
```

**Ausgabe:**

```
{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:{{us-west-2}}:{{111122223333}}:workflow/distribution/example-distribution-workflow/{{1.0.0}}/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}
```

------