Eine neue Version eines Container-Rezepts 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 Rezept erstellen.

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 vereinfachen, können Sie stattdessen eine JSON-Datei bereitstellen, die alle Rezepteinstellungen des Containers enthält

   Anmerkung

   Die Benennungskonvention für die Datenwerte in der JSON-Datei folgt dem Muster, das für die Image Builder Builder-API-Operationsanforderungsparameter angegeben ist. Informationen zu den Anforderungsparametern für API-Operationen finden Sie im CreateContainerRecipeBefehl 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 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 aber nicht.

     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 Ausgabebilds ausgeführt werden.

     • componentArn (string, required) — 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 Name AWS-Region, der Name und die Versionsnummer.

     • Parameter (Anordnung von Objekten) — Enthält eine Reihe 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.

   • containerType (string, required) — 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 Kontextvariablen enthalten (Platzhalter, die Image Builder zur Laufzeit durch Build-Informationen ersetzt). Geben Sie mindestens die Variable an. parentImage Wenn Ihr Rezept Komponenten enthält, fügen Sie auch die environments Variable und die components Variable hinzu.

     ParentImage (erforderlich)

     Bei 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 Komponentenskripts 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, mit der Ihre Komponenten ausgeführt werden. Platzieren Sie es 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 S3-URI (z. B.s3://my-bucket/templates/Dockerfile).

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

   • description (string) — Die Beschreibung des Container-Rezepts.

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

     • Öffentliche Bilder, die gehostet werden auf DockerHub

     • Bestehende Container-Images in Amazon ECR

     • Amazon-managed Container-Bilder

   • PlatformOverride (Zeichenfolge) — Gibt die Betriebssystemplattform an, wenn Sie ein benutzerdefiniertes Basisimage verwenden. Wir empfehlen, diesen Wert festzulegen, wenn Sie ein Docker Hub oder Amazon ECR-Image verwenden. Wenn Sie es 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 Builder-Image-ARN ist. Gültige Werte sind Linux und Windows. Container-Rezepte unterstützen die macOS-Plattform nicht.

   • SemanticVersion <major>(string, erforderlich) — Die semantische Version des Container-Rezepts, angegeben im folgenden Format, mit numerischen Werten an jeder Position, um eine bestimmte Version anzugeben:. <minor>. <patch>. Ein Beispiel wäre 1.0.0. Weitere Informationen zur semantischen Versionierung für Image Builder 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 wird. ssm: 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 of Objects) — Definiert die Blockgeräte, die zum Erstellen einer Instanz aus dem im image Parameter angegebenen Image Builder Builder-AMI angeschlossen werden sollen.

       • 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 bei Beendigung des zugehörigen Geräts zu konfigurieren.

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

         • volumeSize (Ganzzahl) — Wird verwendet, um die Volumengröße des Geräts zu überschreiben.

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

   • targetRepository (object, required) — Das Ziel-Repository für das Container-Image, falls in der Verteilungskonfiguration Ihrer Pipeline für die Region, in der die Pipeline ausgeführt wird (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 vorhanden sein.

   • workingDirectory (string) — Das Arbeitsverzeichnis zur Verwendung bei Build- und Test-Workflows.

   Das folgende Beispiel zeigt eine vollständige Eingabedatei für Container-Rezepte, 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. Windows verwendet beispielsweise den umgekehrten Schrägstrich (\), 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"
   }