Eine neue Version eines Containerrezepts erstellen

So erstellen Sie eine neue Container-Rezeptversion:

1. Wählen Sie auf der Seite mit den Container-Rezeptdetails oben auf der Seite die Option Neue Version erstellen aus. Die Konsole öffnet die Seite „Rezept erstellen“ für Container-Rezepte.

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

1. Erstellen einer CLI-Eingabe-JSON-Datei

   Sie können die gesamte Eingabe für den create-container-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 Container-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 CreateContainerRecipe 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 in diesem Beispiel:

   • components (Array von Objekten, optional) — Enthält ein Array von ComponentConfiguration Objekten. Komponenten sind für Container-Rezepte optional. Sie können das Ausgabebild mit BUILD-Komponenten, mit Anweisungen in Ihrer Dockerfile-Vorlage (z. B. RUN oder COPY Anweisungen) oder mit beidem anpassen. TEST-Komponenten validieren das Image, ändern es jedoch nicht.

     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 das Beispiel zu verwenden, um Ihr eigenes Container-Rezept zu erstellen, ersetzen Sie die Beispiel-ARNs durch die ARNs für die Komponenten, die Sie für Ihr Rezept verwenden. Dazu gehören jeweils der AWS-Region Name und die Versionsnummer.

     • Parameter (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.

   • containerType (string, erforderlich) — Der Typ des zu erstellenden Containers. Zu den gültigen Werten gehören. DOCKER

   • dockerfile TemplateData (string) — Die Inline-Dockerfile-Vorlage zum Erstellen Ihres Images. Inline-Daten sind auf 16.000 Zeichen begrenzt. Sie müssen entweder dockerfileTemplateData oder dockerfileTemplateUri angeben, aber nicht beides.

     Ihre Dockerfile-Vorlage kann kontextbezogene Variablen enthalten (Platzhalter, die Image Builder zur Laufzeit durch Build-Informationen ersetzt). Schließen Sie mindestens die Variable ein. parentImage Wenn Ihr Rezept Komponenten enthält, fügen Sie auch die environments Variable und die components Variable hinzu.

     ParentImage (erforderlich)

     Zum Zeitpunkt der Erstellung wird diese Variable in das Basis-Image für Ihr Rezept aufgelöst.

     Beispiel:

     FROM
     {{{ imagebuilder:parentImage }}}

     Umgebungen (erforderlich, wenn Komponenten angegeben sind)

     Zur Build-Zeit wird diese Variable in die Dockerfile-Direktiven aufgelöst, die Ihre Komponenten im Build-Kontext bereitstellen. Diese Direktiven kopieren die Komponentenskripte in das Image und legen die Umgebungsvariablen fest, die diese Skripts verwenden. Es bereitet die Umgebung vor, führt aber nicht die von Ihnen angegebenen Komponenten aus. Platzieren Sie diese Variable vor der components Variablen.

     Beispiel:

     {{{ imagebuilder:environments }}}

     Komponenten (optional)

     Bei der Erstellung wird diese Variable in den Befehl aufgelöst, der die Build- und Testkomponentenskripts für die Komponenten ausführt, die das Container-Rezept enthält, und diese Skripts dann aus dem Image entfernt. Dies ist die Variable, die Ihre Komponenten ausführt. Platzieren Sie sie hinter der environments Variablen.

     Beispiel:

     {{{ imagebuilder:components }}}

     Um die Vorlage stattdessen in Amazon S3 zu speichern, verwenden Sie den TemplateUri Parameter dockerfile mit einer gültigen Amazon S3-URI (z. B.s3://my-bucket/templates/Dockerfile).

   • name (string, required) — Der Name des Container-Rezepts.

   • description (string) — Die Beschreibung des Containerrezepts.

   • parentImage (string, erforderlich) — Das Docker Container-Image, das im Container-Rezept als Grundlage für Ihr benutzerdefiniertes Image verwendet werden soll.

     • Öffentliche Bilder, gehostet auf DockerHub

     • Bestehende Container-Images in Amazon ECR

     • Amazon-managed Container-Bilder

   • platformOverride (string) — Gibt die Betriebssystemplattform an, wenn Sie ein benutzerdefiniertes Basisimage verwenden. Wir empfehlen, diesen Wert festzulegen, wenn Sie ein Docker Hub oder ein Amazon ECR-Image verwenden. Wenn Sie ihn weglassen, versucht Image Builder, die Plattform anhand des Container-Manifests zu erkennen, das möglicherweise nicht immer verfügbar ist. Sie können nicht angebenplatformOverride, wann Ihr übergeordnetes Image ein Image Builder-Image-ARN ist. Gültige Werte sind Linux und Windows. Container-Rezepte unterstützen die macOS-Plattform nicht.

   • <major>SemanticVersion (string, erforderlich) — Die semantische Version des Container-Rezepts, angegeben im folgenden Format, mit numerischen Werten an jeder Position, um eine bestimmte Version anzuzeigen:. <minor>. <patch>. Ein Beispiel wäre 1.0.0. Weitere Informationen zur semantischen Versionierung für Image Builder-Ressourcen finden Sie unter. Semantische Versionierung in Image Builder

   • tags (string map) — Tags, die an das Container-Rezept angehängt sind.

   • instanceConfiguration (object) — Eine Gruppe von Optionen, die verwendet werden können, um eine Instanz zum Erstellen und Testen von Container-Images zu konfigurieren.

     • image (string) — Das Basis-Image für eine Container-Build- und Testinstanz. Dies kann eine AMI-ID enthalten oder einen AWS Systems Manager (SSM) Parameter Store-Parameter angeben, dem der Parametername oder der ARN vorangestellt istssm:, gefolgt vom Parameternamen oder ARN. Wenn Sie einen SSM-Parameter verwenden, muss der Parameterwert eine AMI-ID enthalten. Wenn Sie kein Basis-Image angeben, verwendet Image Builder das entsprechende Amazon ECS-optimierte AMI als Basis-Image.

     • Block DeviceMappings (Array von Objekten) — Definiert die Blockgeräte, die angehängt werden sollen, um eine Instance aus dem im image Parameter angegebenen Image Builder-AMI zu erstellen.

       • deviceName (string) — Das Gerät, für das diese Zuordnungen gelten.

       • ebs (object) — Wird verwendet, um die Amazon EBS-spezifische Konfiguration für diese Zuordnung zu verwalten.

         • delete OnTermination (Boolean) — Wird verwendet, um das Löschen beim Beenden des zugehörigen Geräts zu konfigurieren.

         • verschlüsselt (Boolean) — Wird zur Konfiguration der Geräteverschlüsselung verwendet.

         • volumeSize (integer) — Wird verwendet, um die Volume-Größe des Geräts zu überschreiben.

         • volumeType (string) — Wird verwendet, um den Volumetyp des Geräts zu überschreiben.

   • targetRepository (Objekt, erforderlich) — Das Ziel-Repository für das Container-Image, wenn in der Distributionskonfiguration Ihrer Pipeline für die Region, in der die Pipeline läuft (Region 1), kein anderes Repository angegeben ist.

     • repositoryName (string, erforderlich) — Der Name des Container-Repositorys, in dem das Ausgabe-Container-Image gespeichert ist. Diesem Namen wird der Speicherort des Repositorys vorangestellt.

     • service (string, erforderlich) — Gibt den Repository-Service an, der das Ausgabebild speichert. Der gültige Wert lautet ECR. Das Ziel-Repository muss bereits existieren.

   • workingDirectory (string) — Das Arbeitsverzeichnis, das bei Build- und Test-Workflows verwendet wird.

   Das folgende Beispiel zeigt eine vollständige Container-Rezept-Eingabedatei, die einen Docker Linux-Container mit Build-Komponenten definiert. Speichern Sie es create-container-recipe.json unter und verwenden Sie es im create-container-recipe Befehl.

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/helloworldal2/x.x.x"
   	  }
   	],
   	"containerType": "DOCKER",
   	"description": "My Linux Docker container image",
   	"dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
   	"name": "amazonlinux-container-recipe",
   	"parentImage": "amazonlinux:latest",
   	"platformOverride": "Linux",
   	"semanticVersion": "1.0.2",
   	"tags": { 
   	  "sometag" : "Tag detail" 
   	},
   	"instanceConfiguration": {
   	  "image": "ami-1234567890abcdef1",
   	  "blockDeviceMappings": [
   		 {
   			"deviceName": "/dev/xvda",
   			"ebs": {
   				"deleteOnTermination": true,
   				"encrypted": false,
   				"volumeSize": 8,
   				"volumeType": "gp2"
   			 }
   		  }			
   	  ]
   	},
   	"targetRepository": { 
   	  "repositoryName": "myrepo",
   	  "service": "ECR"
   	},
   	"workingDirectory": "/tmp"
   }

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-container-recipe --cli-input-json file://create-container-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.

   Die folgende Beispielausgabe zeigt den ARN des neu erstellten Container-Rezepts zusammen mit der Anforderungs-ID und dem Client-Token für die Anfrage.

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