Eine neue Version eines Bildrezepts erstellen

So erstellen Sie eine neue Image-Rezeptversion:

1. Wählen Sie oben auf der Seite mit den Rezeptdetails die Option Neue Version erstellen aus. Dadurch wird die Seite „Image-Rezept erstellen“ geöffnet.

2. Um die neue Version zu erstellen, nehmen Sie Ihre Änderungen vor und wählen Sie dann Create recipe.

   Ihr endgültiges Bild kann bis zu neun Produktcodes von AWS Marketplace Image-Produkten und -Komponenten enthalten. Image Builder gibt bei der Rezepterstellung einen Fehler zurück, wenn Ihr Basisimage und Ihre Komponenten diesen Grenzwert überschreiten.

1. Erstellen einer CLI-Eingabe-JSON-Datei

   Sie können alle Eingaben für den create-image-recipe Befehl mit Inline-Befehlsparametern bereitstellen. Der resultierende Befehl kann jedoch ziemlich lang sein. Um den Befehl zu optimieren, können Sie stattdessen eine JSON-Datei bereitstellen, die alle Rezepteinstellungen enthält.

   Anmerkung

   Die Benennungskonvention für die Datenwerte in der JSON-Datei folgt dem Muster, das für die Image Builder-API-Operationsanforderungsparameter angegeben ist. Informationen zur Überprüfung der Anforderungsparameter für API-Operationen finden Sie im CreateImageRecipe Befehl in der EC2 Image Builder-API-Referenz.

   Informationen zur Bereitstellung der Datenwerte als Befehlszeilenparameter finden Sie in den in der AWS CLI Befehlsreferenz angegebenen Parameternamen.

   Hier ist eine Zusammenfassung der Parameter, die in diesen Beispielen angegeben sind:

   • name (string, required) — Der Name des Bildrezepts.

   • description (string) — Die Beschreibung des Bildrezepts.

   • parentImage (string, erforderlich) — Das Bild, das das Bildrezept als Grundlage für Ihr benutzerdefiniertes Bild verwendet. Sie können das übergeordnete Image mithilfe einer der folgenden Optionen angeben:

     • AMI-ID — Wird verwendet, wenn Sie ein bestimmtes AMI haben (z. B.ami-1234567890abcdef1), das Sie anpassen möchten. Da eine AMI-ID statisch ist, empfehlen wir stattdessen einen Image Builder-Image-ARN oder einen SSM-Parameter, wenn Ihr Rezept neuere Basis-Images automatisch übernehmen soll.

     • ARN der Image Builder-Bildressource — Wird verwendet, wenn Sie auf einem Image Builder-Image aufbauen möchten. Dazu gehören Amazon-managed Images, die Image Builder für die gängigsten Betriebssysteme bereitstellt, sowie Images, die Sie zuvor erstellt haben. Geben Sie den Image-ARN mit einer semantischen Version an, oder verwenden Sie einen Versionsplatzhalter, um immer die neueste Version abzurufen.

     • AWS Systems Manager (SSM) Parameter Store-Parameter — Verwenden Sie diesen Parameter, wenn Ihr Rezept automatisch neue AMI-IDs übernehmen soll, ohne dass eine neue Rezeptversion erstellt werden muss. Stellen Sie dem Parameter ein Präfix vorssm:, gefolgt vom Parameternamen oder ARN. Dies ist ideal für Pipelines, die immer das neueste Amazon Linux- oder Windows-Basis-Image verwenden sollten.

     • AWS Marketplace Produkt-ID — Wird verwendet, wenn Sie ein AMI-Produkt abonnieren AWS Marketplace und es weiter anpassen möchten.

     Anmerkung

     • Wenn Sie eine AMI-ID oder einen SSM-Parameter verwenden, der in ein AMI aufgelöst wird, müssen Sie in Ihrem Konto Zugriff auf dieses AMI haben. Das AMI muss auch in derselben Region existieren, in der Image Builder den Build ausführt.

     • Die Linux- und macOS-Beispiele geben eine AMI-ID an, und das Windows-Beispiel verwendet einen Image Builder-Image-ARN.

   • <major>SemanticVersion (Zeichenfolge, erforderlich) — Geben Sie die Versionsnummer ein, die Sie im Format erstellen möchten. <minor>. <patch>. Image Builder unterstützt die automatische Versionsinkrementierung für Rezepte, sodass Sie Platzhaltermuster in Ihren Rezeptversionen verwenden können. Wenn Sie ein Rezept mit einer Platzhalterversion wie erstellen1.0.x, erhöht Image Builder automatisch die Version (z. B., 1.0.1 1.0.21.0.3, usw.). Dadurch müssen Rezeptversionen nicht mehr manuell nachverfolgt und inkrementiert werden. Weitere Informationen zur semantischen Versionierung für Image Builder-Ressourcen finden Sie unter. Semantische Versionierung in Image Builder

   • components (Array, optional) — Enthält ein Array von ComponentConfiguration Objekten. Komponenten sind optional. Sie können Rezepte ohne Komponenten für Test- oder Verteilungsworkflows erstellen:

     Anmerkung

     Image Builder installiert die Komponenten in der Reihenfolge, in der Sie sie im Rezept angegeben haben. CIS-Härtungskomponenten werden jedoch immer als letzte ausgeführt, um sicherzustellen, dass die Benchmark-Tests mit Ihrem Ausgabe-Image ausgeführt werden.

     • componentArn (string, erforderlich) — Der Komponenten-ARN.

       Tipp

       Um eines der Beispiele für die Erstellung Ihres eigenen Bildrezepts zu verwenden, müssen Sie die Beispiel-ARNs durch die ARNs der Komponenten ersetzen, die Sie für Ihr Rezept verwenden.

     • parameters (Array von Objekten) — Enthält ein Array von ComponentParameter Objekten. Wenn ein Eingabeparameter erforderlich ist, für den in der Komponente jedoch kein Standardwert definiert ist, müssen Sie einen Wert angeben. Image Builder erstellt die Rezeptversion nicht, wenn erforderliche Parameter fehlen und für die kein Standardwert definiert ist.

       Wichtig

       Komponentenparameter sind Klartextwerte und sind angemeldet AWS CloudTrail. Wir empfehlen, dass Sie AWS Secrets Manager oder den AWS Systems Manager Parameter Store verwenden, um Ihre Geheimnisse zu speichern. Weitere Informationen zu Secrets Manager finden Sie unter Was ist Secrets Manager? im AWS Secrets Manager Benutzerhandbuch. Weitere Informationen zum AWS Systems Manager Parameterspeicher finden Sie unter AWS Systems Manager Parameterspeicher im AWS Systems Manager Benutzerhandbuch.

       • name (string, required) — Der Name des zu setzenden Komponentenparameters.

       • value (Zeichenkettenarray, erforderlich) — Enthält ein Array von Zeichenketten, um den Wert für den benannten Komponentenparameter festzulegen. Wenn für die Komponente ein Standardwert definiert ist und kein anderer Wert angegeben wird, wird der Standardwert AWSTOE verwendet.

   • amiWatermarks (Array von Zeichenketten, optional) — Eine Liste von Wasserzeichennamen, die an Ausgabe-AMIs angehängt werden sollen, die nach diesem Rezept erstellt wurden. Wasserzeichen sind Abstammungsmarkierungen, mit denen Sie den Verlauf Ihrer Bilder nachvollziehen können. Geben Sie 1 bis 5 Namen an. Jeder Name muss 3 bis 128 Zeichen lang sein und kann Buchstaben, Zahlen, Leerzeichen und die folgenden Sonderzeichen enthalten:( ) [ ] . / - ' @ _. Weitere Informationen finden Sie unter Verfolgen Sie die AMI-Abstammung mit Wasserzeichen.

   • additional InstanceConfiguration (object) — Geben Sie zusätzliche Einstellungen an und starten Sie Skripts für Ihre Build-Instances.

     • systems ManagerAgent (Objekt) — Enthält Einstellungen für den Systems Manager-Agenten auf Ihrer Build-Instance.

       Anmerkung

       Windows-Rezepte unterstützen die systemsManagerAgent Konfiguration nicht. Wenn Sie es einem übergeordneten Windows-Image hinzufügen, schlägt die Anforderung fehl.

       • uninstall AfterBuild (Boolean) — Steuert, ob der Systems Manager-Agent vor der Erstellung des neuen AMI aus Ihrem endgültigen Build-Image entfernt wird. Wenn diese Option auf gesetzt isttrue, wird der Agent aus dem endgültigen Image entfernt. Wenn die Option auf gesetzt istfalse, bleibt der Agent im System, sodass er in das neue AMI aufgenommen wird. Der Standardwert ist false.

         Anmerkung

         Wenn das uninstallAfterBuild Attribut nicht in der JSON-Datei enthalten ist und die folgenden Bedingungen zutreffen, entfernt Image Builder den Systems Manager-Agenten aus dem endgültigen Image, sodass er im AMI nicht verfügbar ist:

         • Das userDataOverride ist leer oder wurde in der JSON-Datei weggelassen.

         • Image Builder installierte den Systems Manager-Agenten automatisch auf der Build-Instance für ein Betriebssystem, bei dem der Agent nicht auf dem Basisimage vorinstalliert war.

     • user DataOverride (string) — Geben Sie Befehle oder ein Befehlsskript an, das ausgeführt werden soll, wenn Sie Ihre Build-Instance starten.

       Anmerkung

       Die Benutzerdaten sind immer Basis-64-codiert.. Zum Beispiel sind die folgenden Befehle als IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg== codiert:

       #!/bin/bash
       mkdir -p /var/bb/
       touch /var

       Das Linux-Beispiel verwendet diesen codierten Wert.

   Linux

   Das Basisimage (die parentImage Eigenschaft) im folgenden Beispiel ist ein AMI. Wenn Sie ein AMI verwenden, müssen Sie Zugriff auf das AMI haben, und das AMI muss sich in der Quellregion befinden (derselben Region, in der Image Builder den Befehl ausführt). Speichern Sie die Datei create-image-recipe.json unter und verwenden Sie sie im create-image-recipe Befehl.

   {
   "name": "BB Ubuntu Image recipe",
   "description": "Hello World image recipe for Linux.",
   "parentImage": "ami-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   Das folgende Beispiel bezieht sich auf die neueste Version des Windows Server 2016 English Full Base-Images. Der ARN in diesem Beispiel verweist auf das neueste Bild, das auf den von Ihnen angegebenen semantischen Versionsfiltern basiert:arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x.

   {
   "name": "MyBasicRecipe",
   "description": "This example image recipe creates a Windows 2016 image.",
   "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   Anmerkung

   Weitere Informationen zur semantischen Versionierung für Image Builder-Ressourcen finden Sie unter. Semantische Versionierung in Image Builder

   macOS

   Das Basisimage (die parentImage Eigenschaft) im folgenden Beispiel ist ein AMI. Wenn Sie ein AMI verwenden, müssen Sie Zugriff auf das AMI haben, und das AMI muss sich in der Quellregion befinden (derselben Region, in der Image Builder den Befehl ausführt). Speichern Sie die Datei create-image-recipe.json unter und verwenden Sie sie im create-image-recipe Befehl.

   {
   "name": "macOS Catalina Image recipe",
   "description": "Hello World image recipe for macOS.",
   "parentImage": "ami-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Beispiel: Rezept ohne Komponenten

   Sie können Rezepte ohne Komponenten erstellen, um bestehende AMIs oder reine Vertriebs-Workflows zu testen. Das folgende Beispiel zeigt ein Rezept, das ein vorhandenes AMI verwendet, ohne zusätzliche Komponenten anzuwenden:

   {
   	"name": "Test Distribution Recipe",
   	"description": "Recipe for testing and distributing existing AMI without modifications.",
   	"parentImage": "ami-1234567890abcdef1",
   	"semanticVersion": "1.0.0",
   	"additionalInstanceConfiguration": {
   		"systemsManagerAgent": {
   		 	"uninstallAfterBuild": true
   		}
   	}
   }

2. Erstellen Sie das Rezept

   Verwenden Sie den folgenden Befehl, um das Rezept zu erstellen. Geben Sie den Namen der JSON-Datei, die Sie im vorherigen Schritt erstellt haben, in den --cli-input-json Parameter ein:

   aws imagebuilder create-image-recipe --cli-input-json file://create-image-recipe.json

   Anmerkung

   • Sie müssen diefile://-Notation am Anfang des JSON-Dateipfades.

   • Der Pfad für die JSON-Datei sollte der entsprechenden Konvention für das Basisbetriebssystem folgen, auf dem Sie den Befehl ausführen. Beispielsweise verwendet Windows den Backslash (\), um auf den Verzeichnispfad zu verweisen, während Linux und macOS den Schrägstrich (/) verwenden.

   Ihr endgültiges Bild kann bis zu neun Produktcodes von AWS Marketplace Image-Produkten und -Komponenten enthalten. Image Builder gibt bei der Rezepterstellung einen Fehler zurück, wenn Ihr Basisimage und Ihre Komponenten diesen Grenzwert überschreiten, wenn Sie den create-image-recipe Befehl ausführen.

   Der Befehl gibt den ARN des neuen Image-Rezepts zurück, wie in der folgenden Beispielausgabe gezeigt.

   {
   	"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
   	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
   	"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1"
   }

3. Verifizieren Sie Ihr Rezept

   Um zu bestätigen, dass Image Builder Ihr Rezept wie erwartet erstellt hat, führen Sie den get-image-recipe Befehl mit dem ARN aus, den Sie im vorherigen Schritt zurückgegeben haben.

   aws imagebuilder get-image-recipe --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1

1. Wählen Sie im Abschnitt Image auswählen für das Basis-Image die Option Basis-Image importieren aus.

2. Wählen Sie das Image-Betriebssystem (OS) und die Betriebssystemversion wie gewohnt aus.

1. Quelle — Dies kann entweder ein S3-Bucket oder ein EBS-Snapshot sein.

2. Wählen Sie den S3-Speicherort der Festplatte aus — Geben Sie den Speicherort in Amazon S3 ein, an dem Ihre Festplatten-Images gespeichert sind. Um nach dem Speicherort zu suchen, wählen Sie Browse S3.

3. Um einen Festplattencontainer hinzuzufügen, wählen Sie Festplattencontainer hinzufügen.

General

1. Geben Sie einen eindeutigen Namen für das Basisimage an. Wenn Sie keinen Wert eingeben, erbt das Basis-Image den Rezeptnamen.

2. Geben Sie eine Version für das Basisimage an. Verwenden Sie das folgende Format: <major>.<minor>.<patch>. Wenn Sie keinen Wert eingeben, erbt das Basis-Image die Rezeptversion.

3. Sie können auch eine Beschreibung für das Basis-Image eingeben.