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 contenitori.

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 tutti gli 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 contiene tutte le impostazioni della ricetta del contenitore

   Nota

   La convenzione di denominazione per i valori dei dati nel file JSON segue lo schema specificato per i parametri di richiesta di operazione dell'API Image Builder. Per esaminare i parametri della richiesta di operazione API, consulta il CreateContainerRecipe comando nell'API Reference di 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:

   • componenti (matrice di oggetti, opzionale): contiene una serie di ComponentConfiguration oggetti. I componenti sono opzionali per le ricette in contenitori. Puoi personalizzare l'immagine di output con i componenti BUILD, con le istruzioni nel tuo modello Dockerfile (ad esempio, RUN o COPY istruzioni) o entrambi. I componenti TEST convalidano l'immagine ma non la modificano.

     Nota

     Image Builder installa i componenti nell'ordine in cui li hai specificati nella ricetta. Tuttavia, i componenti CIS hardening vengono sempre eseguiti per ultimi per garantire che i test di benchmark vengano eseguiti sull'immagine di output.

     • componentArn (string, obbligatorio) — L'ARN del componente.

       Suggerimento

       Per utilizzare l'esempio per creare una ricetta di contenitore personalizzata, sostituite gli ARN di esempio con gli ARN dei componenti che state utilizzando per la 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 è richiesto un parametro di input, ma non è definito un valore predefinito nel componente, è necessario fornire un valore. Image Builder non creerà la versione della ricetta se mancano dei parametri obbligatori e non è 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 il nostro 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, obbligatorio) — Il nome del parametro del componente da impostare.

       • value (matrice di stringhe, obbligatorio) — Contiene una matrice di stringhe per impostare il valore del parametro del componente denominato. Se è 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 la creazione dell'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 (segnaposto che Image Builder sostituisce con le informazioni di compilazione in fase di esecuzione). Includi almeno la variabile. parentImage Se la ricetta include dei componenti, includi anche la environments variabile e la components variabile.

     ParentImage (obbligatorio)

     In fase di compilazione, questa variabile si risolve nell'immagine di base per la tua ricetta.

     Esempio:

     FROM
     {{{ imagebuilder:parentImage }}}

     ambienti (obbligatorio 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. Posiziona questa variabile prima della components variabile.

     Esempio:

     {{{ imagebuilder:environments }}}

     componenti (opzionali)

     In fase di compilazione, questa variabile si risolve nel 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. Posizionala 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 dei contenitori esistenti in Amazon ECR

     • Amazon-managed immagini dei contenitori

   • platformOverride (string) — Specifica la piattaforma del sistema operativo quando si utilizza un'immagine di base personalizzata. Ti consigliamo di impostare questo valore quando usi un'immagine Docker Hub o Amazon ECR. Se lo ometti, Image Builder tenta di rilevare la piattaforma dal manifest del contenitore, che potrebbe non essere sempre disponibile. Non è possibile specificare platformOverride quando l'immagine principale è un'immagine ARN di Image Builder. I valori validi sono Linux e Windows. Le ricette in contenitori non supportano la piattaforma macOS.

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

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

   • instanceConfiguration (object) — Un gruppo di opzioni che possono essere utilizzate per configurare un'istanza per la creazione e il test delle immagini dei contenitori.

     • image (string) — L'immagine di base per un'istanza di compilazione e test di un contenitore. Può contenere un ID AMI oppure può specificare un parametro AWS Systems Manager (SSM) Parameter Store, preceduto e seguito dal ssm: 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 per 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 (string) — 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.

         • crittografato (booleano): utilizzato per configurare la crittografia del dispositivo.

         • volumeSize (numero intero): utilizzato per sovrascrivere le dimensioni del volume del dispositivo.

         • volumeType (string): utilizzato per sovrascrivere il tipo di volume del dispositivo.

   • targetRepository (object, required) — Il repository 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 (string, 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 create-container-recipe.json con nome 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

   Usate il comando seguente 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 rovesciata (/).

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