Crea una nuova versione di una ricetta contenitore

Per creare una nuova versione della ricetta del contenitore:

1. Nella parte superiore della pagina dei dettagli della ricetta del contenitore, scegli Crea nuova versione. Verrai indirizzato alla pagina Crea ricetta per le ricette in contenitore.

2. Per creare la nuova versione, apporta le modifiche, quindi scegli Crea ricetta.

1. Creazione di un file JSON di input nella CLI

   È possibile fornire tutto l'input per il create-container-recipe comando con parametri di comando in linea. Tuttavia, il comando risultante può essere piuttosto lungo. Per semplificare il comando, puoi invece fornire un file JSON che contenga tutte le impostazioni delle ricette del contenitore

   Nota

   La convenzione di denominazione per i valori dei dati nel file JSON segue lo schema specificato per i parametri di richiesta operativa dell'API Image Builder. Per esaminare i parametri di richiesta dell'operazione API, vedere il CreateContainerRecipecomando nell'EC2 Image Builder API Reference.

   Per fornire i valori dei dati come parametri della riga di comando, fate riferimento ai nomi dei parametri specificati nel AWS CLI Command Reference.

   Ecco un riepilogo dei parametri di questo esempio:

   • components (array di oggetti, obbligatorio) — Contiene un array di ComponentConfiguration oggetti. È necessario specificare almeno un componente di build:

     Nota

     Image Builder installa i componenti nell'ordine specificato nella ricetta. Tuttavia, i componenti di protezione avanzata CIS funzionano sempre per ultimi per garantire che i test di benchmark vengano eseguiti rispetto all'immagine di output.

     • componentARN (stringa, obbligatorio) — L'ARN del componente.

       Suggerimento

       Per utilizzare l'esempio per creare la tua ricetta di contenitore, sostituisci l'esempio ARNs con la ARNs per i componenti che stai utilizzando per la tua ricetta,. Questi includono Regione AWS il nome e il numero di versione di ciascuno.

     • parametri (matrice di oggetti): contiene una matrice di ComponentParameter oggetti. Se un parametro di input è obbligatorio, ma non ha un valore predefinito definito nel componente, è necessario fornire un valore. Image Builder non creerà la versione della ricetta se mancano dei parametri obbligatori e non è stato definito un valore predefinito.

       Importante

       I parametri dei componenti sono valori di testo semplice e vengono registrati. AWS CloudTrail Ti consigliamo di utilizzare AWS Secrets Manager o il AWS Systems Manager Parameter Store per archiviare i tuoi segreti. Per ulteriori informazioni su Secrets Manager, vedi Cos'è Secrets Manager? nella Guida AWS Secrets Manager per l'utente. Per ulteriori informazioni su AWS Systems Manager Parameter Store, vedere AWS Systems Manager Parameter Store nella Guida AWS Systems Manager per l'utente.

       • name (string, required) — Il nome del parametro del componente da impostare.

       • value (array of string, obbligatorio) — Contiene una matrice di stringhe per impostare il valore per il parametro del componente denominato. Se è stato definito un valore predefinito per il componente e non viene fornito nessun altro valore, AWSTOE utilizza il valore predefinito.

   • containerType (string, required) — Il tipo di contenitore da creare. I valori validi includono. DOCKER

   • dockerfileTemplateData(stringa) — Il modello Dockerfile utilizzato per creare l'immagine, espresso come blob di dati in linea.

   • name (string, required) — Il nome della ricetta del contenitore.

   • description (string) — La descrizione della ricetta del contenitore.

   • parentImage (string, required): immagine utilizzata dalla ricetta del contenitore come base per l'immagine personalizzata. Il valore può essere l'ARN dell'immagine di base o un ID AMI.

   • platformOverride (string): specifica la piattaforma del sistema operativo quando si utilizza un'immagine di base personalizzata.

   • SemanticVersion <major>(string, required) — La versione semantica della ricetta del contenitore specificata nel formato seguente, con valori numerici in ogni posizione per indicare una versione specifica:. <minor>. <patch>. Ad esempio, sarebbe 1.0.0. Per ulteriori informazioni sul controllo delle versioni semantiche per le risorse di Image Builder, vedere. Versionamento semantico in Image Builder

   • tags (string map) — Tag allegati alla ricetta del contenitore.

   • instanceConfiguration (oggetto): un gruppo di opzioni che possono essere utilizzate per configurare un'istanza per la creazione e il test delle immagini dei container.

     • image (string) — L'ID AMI da utilizzare come immagine di base per un'istanza di compilazione e test del contenitore. Se non specifichi questo valore, Image Builder utilizza l'AMI ottimizzata Amazon ECS appropriata come immagine di base.

     • blockDeviceMappings(matrice di oggetti) — Definisce i dispositivi a blocchi da collegare per creare un'istanza dall'AMI Image Builder specificata nel image parametro.

       • deviceName (stringa) — Il dispositivo a cui si applicano queste mappature.

       • ebs (object) — Utilizzato per gestire la configurazione specifica di Amazon EBS per questa mappatura.

         • deleteOnTermination(Boolean) — Utilizzato per configurare l'eliminazione alla chiusura del dispositivo associato.

         • criptato (booleano) — Utilizzato per configurare la crittografia del dispositivo.

         • VolumeSize (numero intero): utilizzato per sovrascrivere la dimensione del volume del dispositivo.

         • volumeType (string) — Utilizzato per sovrascrivere il tipo di volume del dispositivo.

   • targetRepository (oggetto, obbligatorio): l'archivio di destinazione per l'immagine del contenitore se non è specificato nessun altro repository nella configurazione di distribuzione della pipeline per la regione in cui viene eseguita la pipeline (Regione 1).

     • repositoryName (stringa, obbligatorio) — Il nome del repository del contenitore in cui è archiviata l'immagine del contenitore di output. Questo nome ha come prefisso la posizione del repository.

     • service (string, required): specifica il servizio in cui è stata registrata l'immagine.

   • workingDirectory (string) — La directory di lavoro da utilizzare durante i flussi di lavoro di compilazione e test.

   {
   	"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. Crea la ricetta

   Usa il seguente comando per creare la ricetta. Fornisci il nome del file JSON che hai creato nel passaggio precedente nel --cli-input-json parametro:

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

   Nota

   • È necessario includere l'annotazione file:// all'inizio del percorso del file JSON.

   • Il percorso del file JSON deve seguire la convenzione appropriata per il sistema operativo di base in cui si esegue il comando. Ad esempio, Windows utilizza la barra rovesciata (\) per fare riferimento al percorso della directory, mentre Linux e macOS utilizzano la barra (/).