Crea una nuova versione di una ricetta contenitore

Per creare una nuova versione della ricetta del contenitore:

1. Nella pagina dei dettagli della ricetta del contenitore, scegli Crea nuova versione nella parte superiore della pagina. La console apre la 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 delle operazioni API, consulta il CreateContainerRecipecomando nel riferimento all'API EC2 Image Builder.

   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, opzionale) — Contiene un array di ComponentConfiguration oggetti. I componenti sono opzionali per le ricette in contenitore. Puoi personalizzare l'immagine di output con i componenti BUILD, con le istruzioni nel modello Dockerfile (ad esempio, RUN o COPY le istruzioni) o entrambi. I componenti TEST convalidano l'immagine ma non la modificano.

     Nota

     Image Builder installa i componenti nell'ordine specificato nella ricetta. Tuttavia, i componenti di protezione 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 gli ARN di esempio con gli ARN per i componenti che stai utilizzando per la tua ricetta,. Questi includono il Regione AWS 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 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

   • dockerfile TemplateData (string) — Il modello Dockerfile in linea per creare la tua immagine. I dati in linea sono limitati a 16.000 caratteri. È necessario specificare dockerfileTemplateData o dockerfileTemplateUri, ma non entrambi.

     Il modello Dockerfile può includere variabili contestuali (segnaposti che Image Builder sostituisce con informazioni di build in fase di esecuzione). parentImageIncludi almeno la variabile. Se la tua ricetta include componenti, includi anche la environments variabile e la components variabile.

     parentImage (obbligatorio)

     In fase di compilazione, questa variabile diventa l'immagine di base della ricetta.

     Esempio:

     FROM
     {{{ imagebuilder:parentImage }}}

     ambienti (richiesti se vengono specificati i componenti)

     In fase di compilazione, questa variabile si risolve nelle direttive Dockerfile che inseriscono i componenti nel contesto di compilazione. Queste direttive copiano gli script dei componenti nell'immagine e impostano le variabili di ambiente utilizzate da tali script. Prepara l'ambiente ma non esegue i componenti specificati. Posizionate questa variabile prima della components variabile.

     Esempio:

     {{{ imagebuilder:environments }}}

     componenti (opzionali)

     In fase di compilazione, questa variabile viene sostituita dal comando che esegue gli script dei componenti di compilazione e test per i componenti inclusi nella ricetta del contenitore, quindi rimuove tali script dall'immagine. Questa è la variabile che esegue i componenti. Posizionatela dopo la environments variabile.

     Esempio:

     {{{ imagebuilder:components }}}

     Per archiviare il modello in Amazon S3, utilizza invece il TemplateUri parametro dockerfile con un URI Amazon S3 valido (ad esempio,). s3://my-bucket/templates/Dockerfile

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

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

   • parentImage (string, required) — L'immagine del Docker contenitore da utilizzare nella ricetta del contenitore come base per l'immagine personalizzata.

     • Immagini pubbliche ospitate su DockerHub

     • Immagini di container esistenti in Amazon ECR

     • Amazon-managed immagini dei contenitori

   • platformOverride (stringa): specifica la piattaforma del sistema operativo quando si utilizza un'immagine di base personalizzata. Ti consigliamo di impostare questo valore quando usi un'Docker Hubimmagine Amazon ECR. Se lo ometti, Image Builder tenta di rilevare la piattaforma dal manifesto del contenitore, che potrebbe non essere sempre disponibile. Non è possibile specificare platformOverride se l'immagine principale è un'immagine ARN di Image Builder. I valori validi sono Linux e Windows. Le ricette dei container non supportano la piattaforma macOS.

   • SemanticVersion <major>(stringa, obbligatoria): la versione semantica della ricetta del contenitore specificata nel seguente formato, con valori numerici in ciascuna 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'immagine di base per un'istanza di compilazione e test di un container. Può contenere un ID AMI o specificare un parametro AWS Systems Manager (SSM) Parameter Store, preceduto dassm:, seguito dal nome del parametro o dall'ARN. Se si utilizza un parametro SSM, il valore del parametro deve contenere un ID AMI. Se non specifichi un'immagine di base, Image Builder utilizza l'AMI ottimizzata Amazon ECS appropriata come immagine di base.

     • block DeviceMappings (array of objects) — 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.

         • delete OnTermination (Boolean): utilizzato per configurare l'eliminazione alla chiusura del dispositivo associato.

         • encrypted (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 di repository che memorizza l'immagine di output. Il valore valido è ECR. Il repository di destinazione deve già esistere.

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

   L'esempio seguente mostra un file di input completo della ricetta del contenitore che definisce un Docker contenitore Linux con componenti di compilazione. Salvalo come create-container-recipe.json e usalo nel create-container-recipe comando.

   {
   	"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. 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 (/).

   L'output di esempio seguente mostra l'ARN della ricetta del contenitore appena creata, insieme all'ID della richiesta e al token client per la richiesta.

   {
   	"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"
   }