Erstellen Sie eine neue Version eines Bildrezepts

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 gelangen Sie zur Seite „Bildrezept erstellen“.

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

1. Erstellen einer CLI-Eingabe-JSON-Datei

   Sie können die gesamte Eingabe für den create-image-recipe Befehl mit Inline-Befehlsparametern bereitstellen. Der resultierende Befehl kann jedoch ziemlich lang sein. Um den Befehl zu vereinfachen, 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 Aktionsanforderungsparameter der Image Builder Builder-API angegeben ist. Informationen zu den API-Befehlsanforderungsparametern finden Sie unter dem CreateImageRecipeBefehl in der EC2 Image Builder API-Referenz.

   Informationen zur Bereitstellung der Datenwerte als Befehlszeilenparameter finden Sie in den Parameternamen, die in der AWS CLI Befehlsreferenz angegeben sind.

   Im Folgenden finden Sie eine Zusammenfassung der Parameter, die in diesen Beispielen angegeben werden:

   • name (string, erforderlich) — 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. Der Wert kann der ARN des Basis-Images oder eine AMI-ID sein.

     Anmerkung

     Das Linux-Beispiel verwendet ein Image Builder Builder-AMI und das Windows-Beispiel verwendet einen ARN.

   • SemanticVersion <major>(string, erforderlich) — Die semantische Version des Bildrezepts, ausgedrückt im folgenden Format, mit numerischen Werten an jeder Position, um eine bestimmte Version anzugeben:. <minor>. <patch>. Zum Beispiel könnte ein Wert sein1.0.0. Weitere Informationen zur semantischen Versionierung für Image Builder Builder-Ressourcen finden Sie unter. Semantische Versionierung in Image Builder

   • components (Array, erforderlich) — Enthält ein Array von ComponentConfiguration Objekten. Es muss mindestens eine Build-Komponente angegeben werden:

     Anmerkung

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

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

       Tipp

       Um eines der Beispiele zu verwenden, um Ihr eigenes Bildrezept zu erstellen, müssen Sie die Beispiel-ARNs durch die ARNs für die Komponenten ersetzen, die Sie für Ihr Rezept verwenden.

     • Parameter (Array von Objekten) — Enthält ein Array von ComponentParameter Objekten. Wenn ein Eingabeparameter erforderlich ist, aber in der Komponente 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

       Bei den Komponentenparametern handelt es sich um reine Textwerte, die angemeldet sind 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, erforderlich) — Der Name des festzulegenden 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.

   • additionalInstanceConfiguration(Objekt) — Geben Sie zusätzliche Einstellungen und Startskripts für Ihre Build-Instances an.

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

       • uninstallAfterBuild(Boolean) — Steuert, ob der Systems Manager 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 aktiviert, 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 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 Manager-Agenten automatisch auf der Build-Instanz für ein Betriebssystem, bei dem der Agent nicht auf dem Basis-Image vorinstalliert war.

     • userDataOverride(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 Basis-Image (parentImageEigenschaft) 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 (dieselbe 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-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   Das folgende Beispiel bezieht sich auf die neueste Version des englischen Full Base-Images von Windows Server 2016. Der ARN in diesem Beispiel verweist auf das neueste Bild in der SKU, basierend auf den von Ihnen angegebenen semantischen Versionsfiltern: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:123456789012:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   Anmerkung

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

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. Windows verwendet beispielsweise den umgekehrten Schrägstrich (\), um auf den Verzeichnispfad zu verweisen, und Linux verwendet den Schrägstrich (/).

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

Allgemeines

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

2. Geben Sie eine Version für das Basis-Image 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.