View a markdown version of this page

Erstellen Sie einen Image-Workflow - 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.

Erstellen Sie einen Image-Workflow

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 unterVerschlüsselung und Schlüsselverwaltung in Image Builder.

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 Ihres YAML-Dokuments finden Sie unter. Erstellen Sie ein YAML-Workflow-Dokument

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/.

  2. 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.

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

  4. 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 (BUILDTEST, oderDISTRIBUTION). 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.

    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

  5. 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 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.

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 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 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 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"
}