Eine neue Version eines Container-Rezepts erstellen

So erstellen Sie eine neue Container-Rezeptversion:

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

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

1. Erstellen Sie eine CLI JSON Eingabedatei

   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 API Builder-Aktionsanforderungsparameter angegeben ist. Informationen zu den API Befehlsanforderungsparametern finden Sie unter dem CreateContainerRecipeBefehl in der EC2Image Builder API Builder-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, 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. Die CIS Härtungskomponenten werden jedoch immer zuletzt ausgeführt, um sicherzustellen, dass die Benchmark-Tests anhand Ihres Ausgabebilds ausgeführt werden.

     • component ARN (string, erforderlich) — Die KomponenteARN.

       Tipp

       Wenn Sie das Beispiel verwenden möchten, um Ihr eigenes Container-Rezept zu erstellen, ersetzen Sie das Beispiel ARNs durch das ARNs für die Komponenten, die Sie für Ihr Rezept verwenden,. Dazu gehören jeweils der AWS-Region 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, erforderlich) — Der Typ des zu erstellenden Containers. Zu den gültigen Werten gehörenDOCKER.

   • dockerfileTemplateData(string) — Die Dockerfile-Vorlage, die zum Erstellen Ihres Images verwendet wird, ausgedrückt als Inline-Datenblob.

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

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

   • parentImage(string, erforderlich) — Bild, das das Container-Rezept als Grundlage für Ihr benutzerdefiniertes Bild verwendet. Der Wert kann das Basis-Image ARN oder eine AMI ID sein.

   • platformOverride(Zeichenfolge) — Gibt die Betriebssystemplattform an, wenn Sie ein benutzerdefiniertes Basisimage verwenden.

   • 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(Objekt) — Eine Gruppe von Optionen, die verwendet werden können, um eine Instanz zum Erstellen und Testen von Container-Images zu konfigurieren.

     • image (string) — Die AMI ID, die als Basisimage für eine Container-Build- und Testinstanz verwendet werden soll. Wenn Sie diesen Wert nicht angeben, verwendet Image Builder das entsprechende Amazon, das AMI als Basis-Image ECS optimiert ist.

     • blockDeviceMappings(Array von Objekten) — Definiert die Blockgeräte, die angeschlossen werden sollen, um eine Instanz aus dem im image Parameter AMI angegebenen Image Builder zu erstellen.

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

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

         • deleteOnTermination(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, erforderlich) — Das Ziel-Repository für das Container-Image, falls in der Verteilungskonfiguration 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 Dienst an, in dem dieses Image registriert wurde.

   • workingDirectory(string) — Das Arbeitsverzeichnis für die Verwendung bei Build- und Test-Workflows.

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-east-1:123456789012: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-1234567890",
   	  "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 die file:// Notation am Anfang des JSON Dateipfads angeben.

   • Der Pfad für die JSON Datei sollte der entsprechenden Konvention für das Basisbetriebssystem entsprechen, 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 (/).