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.

Schritt 1: Geben Sie die Pipeline-Details an

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

2. Um mit der Erstellung Ihrer Pipeline zu beginnen, wählen Sie Create Image Pipeline aus.

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

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

   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

5. Wählen Sie Weiter, um mit dem nächsten Schritt fortzufahren.

Schritt 2: Wählen Sie ein Rezept

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.

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

3. Geben Sie im Abschnitt Allgemein die folgenden erforderlichen Felder ein:

   • Name — Ihr Rezeptname

   • Version — Ihre Rezeptversion (verwenden Sie das Format <major>. <minor>. <patch>, wobei Major, Minor und Patch ganzzahlige Werte sind). Neue Rezepte beginnen in der Regel mit1.0.0.

4. 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 Amazon Linux 2-AMIs, die von Amazon verwaltet werden und aus der Sie für Ihr Basis-Image auswählen können.

   1. Wählen Sie aus der Drop-down-Liste mit dem Imagenamen ein Image aus.

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

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

6. Im Abschnitt Komponenten müssen Sie mindestens eine Build-Komponente auswählen.

   Im Bereich Komponenten erstellen — Amazon Linux können Sie die auf der Seite aufgelisteten Komponenten durchsuchen. Verwenden Sie die Seitennummerierung in der oberen rechten Ecke, um durch zusätzliche Komponenten zu navigieren, die für Ihr Basis-Image-Betriebssystem verfügbar sind. Sie können auch nach bestimmten Komponenten suchen oder mithilfe des Komponenten-Managers Ihre eigene Build-Komponente erstellen.

   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.

   2. Aktivieren Sie das Kontrollkästchen für die update-linux Build-Komponente.

   3. Scrollen Sie nach unten und wählen Sie in der oberen rechten Ecke der Liste Ausgewählte Komponenten die Option Alle erweitern aus.

   4. Behalten Sie die Standardeinstellung für die Versionierungsoptionen bei (Verwenden Sie die neueste verfügbare Komponentenversion).

      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

      Wenn Sie eine Komponente mit Eingabeparametern auswählen würden, würden Sie die Parameter auch in diesem Bereich sehen. Parameter werden in diesem Tutorial nicht behandelt. Weitere Informationen zur Verwendung von Eingabeparametern in Ihren Komponenten und deren Einstellung in Ihren Rezepten finden Sie unterTutorial: Erstellen Sie eine benutzerdefinierte Komponente mit Eingabeparametern aus EC2 Image Builder.

   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. Scrollen Sie zurück zur Liste der verfügbaren Komponenten.

   2. Aktivieren Sie das Kontrollkästchen für die update-linux-kernel-mainline Build-Komponente (oder eine andere Komponente Ihrer Wahl).

   3. Scrollen Sie nach unten zur Liste Ausgewählte Komponenten, um zu sehen, dass es mindestens zwei Ergebnisse gibt.

   4. Bei neu hinzugefügten Komponenten wurden die Versionierungs- oder Eingabeparametereinstellungen möglicherweise nicht erweitert. 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.

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

   6. Um die update-linux-kernel-mainline Komponente zu entfernen, wählen Sie in der oberen rechten Ecke des Komponentenfeldes eine Option X aus.

   7. Wiederholen Sie den vorherigen Schritt, um alle anderen Komponenten zu entfernen, die Sie möglicherweise hinzugefügt haben, sodass nur die update-linux Komponente ausgewählt bleibt.

7. 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 eingestelltCreate 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 CreateInfrastructureConfigurationin 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-AMIs, spezifische Regionseinstellungen für die Verschlüsselung, Startberechtigungen und AWS-Konten Organisationen und Organisationseinheiten (OUs), die das Ausgabe-AMI starten können, sowie Lizenzkonfigurationen.

Im Abschnitt Verteilungseinstellungen sind die Konfigurationsoptionen standardmäßig auf eingestelltCreate distribution settings using service defaults. Diese Option verteilt das Ausgabe-AMI an die aktuelle Region. Weitere Informationen zur Konfiguration Ihrer Verteilungseinstellungen finden Sie unterEC2 Image Builder Builder-Verteilungseinstellungen verwalten.

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.

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

3. 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:

1. Image-Pipeline

2. Bildrezept

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

2. Aktivieren Sie das Kontrollkästchen neben dem Namen der Pipeline, um die Pipeline auszuwählen, die Sie löschen möchten.

3. Wählen Sie oben im Bereich Image-Pipelines im Menü Aktionen die Option Löschen aus.

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

2. Aktivieren Sie das Kontrollkästchen neben Rezeptname, um das Rezept auszuwählen, das Sie löschen möchten.

3. Wählen Sie oben im Fenster Bildrezepte im Menü Aktionen die Option Rezept löschen aus.

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

2. Aktivieren Sie das Kontrollkästchen neben Konfigurationsname, um die Infrastrukturkonfiguration auszuwählen, die Sie löschen möchten.

3. Wählen Sie oben im Bereich Infrastrukturkonfigurationen die Option Löschen aus.

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

2. Aktivieren Sie das Kontrollkästchen neben dem Namen der Konfiguration, um die Verteilungseinstellungen auszuwählen, die Sie für dieses Tutorial erstellt haben.

3. Wählen Sie oben im Bereich „Verteilungseinstellungen“ die Option Löschen aus.

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

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

3. Aktivieren Sie das Kontrollkästchen neben der Version für jedes Image, das Sie löschen möchten. Sie können mehr als eine Image-Version gleichzeitig auswählen.

4. Wählen Sie oben im Bereich Image-Build-Versionen die Option Version löschen aus.

5. Um den Löschvorgang zu bestätigen, geben Sie den Text Delete in das Feld ein und wählen Sie Löschen.