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.
# Tutorial: Erstellen Sie eine Image-Pipeline mit Ausgabe-AMI aus dem Image Builder Builder-Konsolenassistenten
Dieses Tutorial führt Sie durch die Erstellung einer automatisierten Pipeline zum Erstellen und Verwalten eines benutzerdefinierten EC2 Image Builder mithilfe des Konsolenassistenten **Create Image Pipeline**. Damit Sie die Schritte effizient durchführen können, werden Standardeinstellungen verwendet, sofern sie verfügbar sind, und optionale Abschnitte werden übersprungen.
**Topics**
+ [Schritt 1: Geben Sie die Pipeline-Details an](#start-build-image-step1)
+ [Schritt 2: Rezept wählen](#start-build-image-step2)
+ [Schritt 3: Definieren Sie die Infrastrukturkonfiguration — optional](#start-build-image-step3)
+ [Schritt 4: Definieren Sie die Verteilungseinstellungen — optional](#start-build-image-step4)
+ [Schritt 5: Prüfen](#start-build-image-step5)
+ [Schritt 6: Bereinigen](#start-build-image-cleanup)
## Schritt 1: Geben Sie die Pipeline-Details an
1. Öffnen Sie die EC2 Image Builder Builder-Konsole unter [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Um mit der Erstellung Ihrer Pipeline zu beginnen, wählen Sie **Create Image Pipeline**.
1. Geben Sie im Abschnitt **Allgemein** Ihren **Pipeline-Namen** ein (*erforderlich*).
**Tipp**
Die erweiterte Metadatensammlung ist standardmäßig aktiviert. Um die Kompatibilität zwischen Komponenten und Basis-Images sicherzustellen, sollten Sie sie aktiviert lassen.
1. Im Abschnitt **Zeitplan erstellen** können Sie die Standardeinstellungen für die **Zeitplanoptionen** beibehalten. Beachten Sie, dass die für den Standardzeitplan angezeigte **Zeitzone** die koordinierte Weltzeit (UTC) ist. Weitere Informationen zur UTC-Zeit und zur Ermittlung des Zeitversatzes für Ihre Zeitzone finden Sie unter [Abkürzungen für Zeitzonen — Weltweite Liste](https://www.timeanddate.com/time/zones/).
Wählen Sie für die **Einstellungen für Abhängigkeitsupdates** die Option **Pipeline zur geplanten Zeit ausführen, falls es Abhängigkeitsupdates gibt**. Diese Einstellung veranlasst Ihre Pipeline, vor dem Start des Builds nach Updates zu suchen. Wenn keine Updates vorhanden sind, wird der geplante Pipeline-Build übersprungen.
**Anmerkung**
Um sicherzustellen, dass Ihre Pipeline Abhängigkeitsupdates und Builds wie erwartet erkennt, müssen Sie die semantische Versionierung (x.x.x) für Ihr Basis-Image und Ihre Komponenten verwenden. Weitere Informationen zur semantischen Versionierung für Image Builder Builder-Ressourcen finden Sie unter. [Semantische Versionierung in Image Builder](ibhow-semantic-versioning.md)
1. Wählen Sie **Weiter**, um mit dem nächsten Schritt fortzufahren.
## Schritt 2: Rezept wählen
1. Image Builder ist standardmäßig auf **Bestehendes Rezept verwenden** im Abschnitt **Rezept** eingestellt. Wählen Sie zum ersten Mal die Option **Neues Rezept erstellen**.
1. Wählen Sie im Abschnitt **Image-Typ** die Option **Amazon Machine Image (AMI)**, um eine Image-Pipeline zu erstellen, die ein AMI erstellt und verteilt.
1. Geben Sie im Abschnitt **Allgemein** die folgenden erforderlichen Felder ein:
+ **Name** — Ihr Rezeptname
+ **Version** — deine Rezeptversion (verwende das Format *. . *, wobei Major, Minor und Patch ganzzahlige Werte sind). Neue Rezepte beginnen in der Regel mit`1.0.0`.
1. Behalten Sie im Abschnitt **Quell-Image** die Standardwerte für **Select image**, **Image Operating System (OS)** und **Image-Ursprung** bei. Dies führt zu einer Liste von Linux-Systemen AMIs , die von Amazon verwaltet werden. Wählen Sie für dieses Tutorial das `Amazon Linux 2 x86` Bild aus.
1. Wählen Sie aus dem Drop-down-Menü **Bildname** ein Bild aus.
1. Behalten Sie die Standardeinstellungen für die **automatische Versionierung bei** (**verwenden Sie die neueste verfügbare Betriebssystemversion**).
**Anmerkung**
Diese Einstellung stellt sicher, dass Ihre Pipeline die semantische Versionierung für das Basis-Image verwendet, um Abhängigkeitsupdates für automatisch geplante Jobs zu erkennen. Weitere Informationen zur semantischen Versionierung für Image Builder Builder-Ressourcen finden Sie unter. [Semantische Versionierung in Image Builder](ibhow-semantic-versioning.md)
1. Behalten Sie im Abschnitt **Instanzkonfiguration** die Standardwerte für den **Systems Manager Manager-Agent** bei. Dies führt dazu, dass Image Builder den Systems Manager Manager-Agenten nach Abschluss des Builds und der Tests beibehält, um den Systems Manager Manager-Agent in Ihr neues Image aufzunehmen.
Lassen Sie die **Benutzerdaten** für dieses Tutorial leer. Sie können diesen Bereich zu anderen Zeiten verwenden, um Befehle oder ein Befehlsskript bereitzustellen, das ausgeführt wird, wenn Sie Ihre Build-Instance starten. Es ersetzt jedoch alle Befehle, die Image Builder möglicherweise hinzugefügt hat, um sicherzustellen, dass Systems Manager installiert ist. Wenn Sie ihn verwenden, stellen Sie sicher, dass der Systems Manager Agent auf Ihrem Basis-Image vorinstalliert ist, oder dass Sie die Installation in Ihren Benutzerdaten angeben.
1. Im Abschnitt **Komponenten** können Sie festlegen, dass keine Komponenten hinzugefügt werden sollen, und dann fortfahren. Wenn Sie Komponenten hinzufügen möchten, wählen Sie im Bereich „**Komponenten erstellen“ die Option „Build-Komponenten** **hinzufügen**“ und wählen Sie dann in der Filterliste „Komponentenbesitzer“ eine Option `Amazon managed` aus. Dadurch wird auf der rechten Seite der Konsolenoberfläche ein Auswahlbereich geöffnet, in dem Sie die verfügbaren Komponenten durchsuchen und filtern können.
Wählen Sie für dieses Tutorial wie folgt eine Komponente aus, die Linux mit den neuesten Sicherheitsupdates aktualisiert:
1. Filtern Sie die Ergebnisse, indem Sie das Wort `update` in die Suchleiste eingeben, die sich oben im Bedienfeld befindet.
1. Aktivieren Sie das Kontrollkästchen für die `update-linux` Build-Komponente.
1. Behalten Sie die Standardeinstellung für die **Versionierungsoptionen bei** (**Verwenden Sie die neueste verfügbare Version**).
**Anmerkung**
Diese Einstellung stellt sicher, dass Ihre Pipeline die semantische Versionierung für die ausgewählte Komponente verwendet, um Abhängigkeitsupdates für automatisch geplante Jobs zu erkennen. Weitere Informationen zur semantischen Versionierung für Image Builder Builder-Ressourcen finden Sie unter. [Semantische Versionierung in Image Builder](ibhow-semantic-versioning.md)
1. Wählen Sie **Zum Rezept hinzufügen**, um die Komponente zu Ihrem Rezept hinzuzufügen. Dadurch wird das Bedienfeld zur Komponentenauswahl geschlossen.
1. Zurück im Bedienfeld „**Komponenten erstellen**“ wird die Komponente angezeigt, die Sie hinzugefügt haben.
1.
**Komponenten neu anordnen (optional)**
Wenn Sie mehr als eine Komponente ausgewählt haben, die in Ihr Image aufgenommen werden soll, können Sie die drag-and-drop Aktion verwenden, um sie in der Reihenfolge anzuordnen, in der sie während des Erstellungsprozesses ausgeführt werden sollen.
**Anmerkung**
CIS-Härtungskomponenten folgen nicht den Standardregeln für die Reihenfolge der Komponenten in den Image Builder Builder-Rezepten. Die CIS-Härtungskomponenten werden immer zuletzt ausgeführt, um sicherzustellen, dass die Benchmark-Tests anhand Ihres Ausgabebilds ausgeführt werden.
1. Wiederholen Sie die vorherigen Schritte, um die `update-linux-kernel-5` Komponente zu Ihrem Rezept hinzuzufügen.
1. Die Komponente, die Sie gerade hinzugefügt haben, hat einen Eingabeparameter für die Kernel-Version. Um die Einstellungen für **Versionierungsoptionen** oder **Eingabeparameter** zu erweitern, können Sie den Pfeil neben dem Namen der Einstellung wählen. Um alle Einstellungen für alle ausgewählten Komponenten zu erweitern, können Sie den Schalter **Alle erweitern** aus- und einschalten. Weitere Informationen zur Verwendung von Eingabeparametern in Ihren Komponenten und deren Einstellung in Ihren Rezepten finden Sie unter[Tutorial: Erstellen Sie eine benutzerdefinierte Komponente mit Eingabeparametern](tutorial-component-parameters.md).
1. Wählen Sie eine der Komponenten aus und ziehen Sie sie nach oben oder unten, um die Reihenfolge zu ändern, in der die Komponenten ausgeführt werden.
1. Um die `update-linux-kernel-5` Komponente zu entfernen, wählen Sie in der oberen rechten Ecke des Komponentenfeldes eine Option `X` aus.
Wiederholen Sie diesen Schritt, um alle anderen Komponenten zu entfernen, die Sie möglicherweise hinzugefügt haben, sodass nur die `update-linux` Komponente ausgewählt bleibt.
1. Wählen Sie **Weiter**, um mit dem nächsten Schritt fortzufahren.
## Schritt 3: Definieren Sie die Infrastrukturkonfiguration — optional
Image Builder startet EC2-Instances in Ihrem Konto, um Images anzupassen und Validierungstests durchzuführen. In den Infrastrukturkonfigurationseinstellungen werden die Infrastrukturdetails für die Instances angegeben, die AWS-Konto während des Build-Prozesses in Ihrem ausgeführt werden.
Im Abschnitt **Infrastrukturkonfiguration** sind die **Konfigurationsoptionen** standardmäßig auf eingestellt`Create infrastructure configuration using service defaults`. Dadurch werden eine IAM-Rolle und das zugehörige Instanzprofil für die EC2-Build- und Test-Instances erstellt, die zur Konfiguration Ihres Images verwendet werden. Weitere Informationen zu den Einstellungen für die Infrastrukturkonfiguration finden Sie [CreateInfrastructureConfiguration](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateInfrastructureConfiguration.html)in der *EC2 Image Builder API-Referenz.*
Für dieses Tutorial verwenden wir die Standardeinstellungen.
**Anmerkung**
Um ein Subnetz für eine private VPC anzugeben, können Sie Ihre eigene benutzerdefinierte Infrastrukturkonfiguration erstellen oder Einstellungen verwenden, die Sie bereits erstellt haben.
+ Wählen Sie **Weiter**, um mit dem nächsten Schritt fortzufahren.
## Schritt 4: Definieren Sie die Verteilungseinstellungen — optional
Zu den Verteilungskonfigurationen gehören der Name des Ausgabe-AMI, spezifische Regionseinstellungen für die Verschlüsselung, Startberechtigungen sowie Organisationen und Organisationseinheiten (OUs), die das Ausgabe-AMI starten können, sowie Lizenzkonfigurationen. AWS-Konten
Im Abschnitt **Verteilungseinstellungen** sind die **Konfigurationsoptionen** standardmäßig auf eingestellt`Create distribution settings using service defaults`. Diese Option verteilt das Ausgabe-AMI an die aktuelle Region. Weitere Informationen zur Konfiguration Ihrer Verteilungseinstellungen finden Sie unter[Image Builder Builder-Verteilungseinstellungen verwalten](manage-distribution-settings.md).
Für dieses Tutorial verwenden wir die Standardeinstellungen.
+ Wählen Sie **Weiter**, um mit dem nächsten Schritt fortzufahren.
## Schritt 5: Prüfen
Im Abschnitt **Überprüfen** werden alle Einstellungen angezeigt, die Sie konfiguriert haben. Um Informationen in einem bestimmten Abschnitt zu bearbeiten, wählen Sie die Schaltfläche **Bearbeiten** in der oberen rechten Ecke des Schrittabschnitts. Wenn Sie beispielsweise Ihren Pipeline-Namen ändern möchten, wählen Sie die Schaltfläche **Bearbeiten** in der oberen rechten Ecke des Abschnitts **Schritt 1: Pipeline-Details**.
1. Wenn Sie Ihre Einstellungen überprüft haben, wählen Sie **Pipeline erstellen**, um Ihre Pipeline zu erstellen.
1. Sie können Erfolgs- oder Fehlschlagsmeldungen oben auf der Seite sehen, während Ihre Ressourcen für die Verteilungseinstellungen, die Infrastrukturkonfiguration, Ihr neues Rezept und die Pipeline erstellt werden. Um Details zu einer Ressource, einschließlich der Ressourcen-ID, **anzuzeigen, wählen Sie Details anzeigen**.
1. Nachdem Sie die Details für eine Ressource angezeigt haben, können Sie Details zu anderen Ressourcen anzeigen, indem Sie den Ressourcentyp im Navigationsbereich auswählen. Um beispielsweise Details für Ihre neue Pipeline anzuzeigen, wählen Sie im Navigationsbereich **Image-Pipelines** aus. Wenn Ihr Build erfolgreich war, wird Ihre neue Pipeline in der Liste der **Image-Pipelines** angezeigt.
## Schritt 6: Bereinigen
Ihre Image Builder Builder-Umgebung muss, genau wie Ihr Zuhause, regelmäßig gewartet werden, damit Sie das finden, was Sie benötigen, und Ihre Aufgaben erledigen können, ohne sich durch Unordnung zu wühlen. Stellen Sie sicher, dass Sie die temporären Ressourcen, die Sie zu Testzwecken erstellt haben, regelmäßig bereinigen. Andernfalls könnten Sie diese Ressourcen vergessen und sich später nicht mehr daran erinnern, wofür sie verwendet wurden. Bis dahin ist möglicherweise nicht klar, ob Sie sie sicher loswerden können.
**Tipp**
Um Abhängigkeitsfehler beim Löschen von Ressourcen zu vermeiden, stellen Sie sicher, dass Sie Ihre Ressourcen in der folgenden Reihenfolge löschen:
Image-Pipeline
Bildrezept
Alle verbleibenden Ressourcen
Gehen Sie folgendermaßen vor, um die Ressourcen zu bereinigen, die Sie für dieses Tutorial erstellt haben:
**Löschen Sie die Pipeline**
1. Um eine Liste der Build-Pipelines anzuzeigen, die unter Ihrem Konto erstellt wurden, wählen Sie im Navigationsbereich **Image-Pipelines** aus.
1. Aktivieren Sie das Kontrollkästchen neben dem **Namen der Pipeline**, um die Pipeline auszuwählen, die Sie löschen möchten.
1. Wählen Sie oben im Bereich **Image-Pipelines** im Menü **Aktionen** die Option **Löschen** aus.
1. Um den Löschvorgang zu bestätigen, geben Sie den Text `Delete` in das Feld ein und wählen Sie „**Löschen**“.
**Lösche das Rezept**
1. Um eine Liste der unter Ihrem Konto erstellten Rezepte anzuzeigen, wählen Sie im Navigationsbereich **Bildrezepte** aus.
1. Aktivieren Sie das Kontrollkästchen neben **Rezeptname**, um das Rezept auszuwählen, das Sie löschen möchten.
1. Wählen Sie oben im Fenster **Bildrezepte** im Menü **Aktionen** die Option **Rezept löschen** aus.
1. Um den Löschvorgang zu bestätigen, geben Sie den `Delete` Text in das Feld ein und wählen Sie „**Löschen**“.
**Löschen Sie die Infrastrukturkonfiguration**
1. Um eine Liste der unter Ihrem Konto erstellten Infrastrukturkonfigurationen anzuzeigen, wählen Sie im Navigationsbereich **Infrastrukturkonfiguration** aus.
1. Aktivieren Sie das Kontrollkästchen neben **Konfigurationsname**, um die Infrastrukturkonfiguration auszuwählen, die Sie löschen möchten.
1. Wählen Sie oben im Bereich **Infrastrukturkonfigurationen** die Option **Löschen** aus.
1. Um den Löschvorgang zu bestätigen, geben Sie den Text `Delete` in das Feld ein und wählen Sie **Löschen**.
**Löschen Sie die Verteilungseinstellungen**
1. Um eine Liste der unter Ihrem Konto erstellten Verteilungseinstellungen anzuzeigen, wählen Sie im Navigationsbereich **Verteilungseinstellungen** aus.
1. Aktivieren Sie das Kontrollkästchen neben dem **Namen der Konfiguration**, um die Verteilungseinstellungen auszuwählen, die Sie für dieses Tutorial erstellt haben.
1. Wählen Sie oben im Bereich **„Verteilungseinstellungen**“ die Option **Löschen** aus.
1. Um den Löschvorgang zu bestätigen, geben Sie den Text `Delete` in das Feld ein und wählen Sie **Löschen**.
**Lösche das Bild**
Gehen Sie wie folgt vor, um sicherzustellen, dass Sie alle Bilder gelöscht haben, die in der Tutorial-Pipeline erstellt wurden. In diesem Tutorial wird wahrscheinlich kein Image erstellt, es sei denn, es ist genügend Zeit vergangen, seit Sie Ihre Pipeline erstellt haben, sodass sie gemäß dem Build-Zeitplan ausgeführt wird.
1. Um eine Liste der unter Ihrem Konto erstellten Images anzuzeigen, wählen Sie im Navigationsbereich **Images** aus.
1. Wählen Sie die **Image-Version** für das Bild aus, das Sie entfernen möchten. Dadurch wird die Seite mit den **Image-Build-Versionen** geöffnet.
1. Aktivieren Sie das Kontrollkästchen neben der **Version** für jedes Image, das Sie löschen möchten. Sie können mehrere Image-Versionen gleichzeitig auswählen.
1. Wählen Sie oben im Bereich **Image-Build-Versionen** die Option **Version löschen** aus.
1. Um den Löschvorgang zu bestätigen, geben Sie den Text `Delete` in das Feld ein und wählen Sie **Löschen**.