Crea una nuova versione di una ricetta di immagini

Per creare una nuova versione della ricetta di immagini:

1. Nella parte superiore della pagina dei dettagli della ricetta, scegli Crea nuova versione. Verrai indirizzato alla pagina Crea ricetta con immagine.

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

1. Create un JSON file CLI di input

   È possibile fornire tutto l'input per il create-image-recipe comando con parametri di comando in linea. Tuttavia, il comando risultante può essere piuttosto lungo. Per semplificare il comando, potete invece fornire un JSON file che contenga tutte le impostazioni della ricetta.

   Nota

   La convenzione di denominazione per i valori dei dati nel JSON file segue lo schema specificato per i parametri della richiesta di azione Image API Builder. Per esaminare i parametri di richiesta del API comando, vedere il CreateImageRecipecomando nell'EC2Image 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.

   Di seguito è riportato un riepilogo dei parametri specificati da questi esempi:

   • name (string, required) — Il nome della ricetta dell'immagine.

   • description (string) — La descrizione della ricetta dell'immagine.

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

     Nota

     L'esempio Linux utilizza un Image Builder e AMI l'esempio Windows utilizza un. ARN

   • semanticVersion<major>(string, required) — La versione semantica della ricetta dell'immagine, espressa nel seguente formato, con valori numerici in ogni posizione per indicare una versione specifica:. <minor>. <patch>. Ad esempio, un valore potrebbe essere1.0.0. Per ulteriori informazioni sul controllo delle versioni semantiche per le risorse di Image Builder, vedere. Versionamento semantico in Image Builder

   • components (array, obbligatorio): contiene una serie di oggetti. ComponentConfiguration È necessario specificare almeno un componente di build:

     Nota

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

     • component ARN (string, required) — Il componente. ARN

       Suggerimento

       Per utilizzare uno degli esempi per creare una ricetta personalizzata, è necessario sostituire l'esempio ARNs con quello relativo ai componenti utilizzati per la ricetta. ARNs

     • parameters (matrice di oggetti) — Contiene una serie 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.

   • additionalInstanceConfiguration(oggetto): specifica impostazioni aggiuntive e avvia gli script per le tue istanze di build.

     • systemsManagerAgent(oggetto) — Contiene le impostazioni per l'agente Systems Manager sull'istanza di build.

       • uninstallAfterBuild(Boolean) — Controlla se l'agente Systems Manager viene rimosso dall'immagine di build finale prima di creare la nuova. AMI Se questa opzione è impostata sutrue, l'agente viene rimosso dall'immagine finale. Se l'opzione è impostata sufalse, l'agente viene lasciato attivo in modo da essere incluso nella nuovaAMI. Il valore predefinito è false.

         Nota

         Se l'uninstallAfterBuildattributo non è incluso nel JSON file e sono soddisfatte le seguenti condizioni, Image Builder rimuove l'agente Systems Manager dall'immagine finale in modo che non sia disponibile in: AMI

         • userDataOverrideÈ vuoto o è stato omesso dal JSON file.

         • Image Builder ha installato automaticamente l'agente Systems Manager sull'istanza di build per un sistema operativo che non aveva l'agente preinstallato nell'immagine di base.

     • userDataOverride(stringa) — Fornisce comandi o uno script di comando da eseguire all'avvio dell'istanza di compilazione.

       Nota

       I dati utente sono sempre codificati in base 64. Ad esempio, i seguenti comandi sono codificati come IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg==:

       #!/bin/bash
       mkdir -p /var/bb/
       touch /var

       L'esempio Linux utilizza questo valore codificato.

   Linux

   L'immagine di base (parentImageproprietà) nell'esempio seguente è unAMI. Quando si utilizza unAMI, è necessario avere accesso a e AMI deve trovarsi nella regione di origine (la stessa regione in cui Image Builder esegue il comando). AMI Salvate il file con nome e utilizzatelo nel create-image-recipe comando. create-image-recipe.json

   {
   "name": "BB Ubuntu Image recipe",
   "description": "Hello World image recipe for Linux.",
   "parentImage": "ami-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   L'esempio seguente si riferisce alla versione più recente dell'immagine Full Base inglese di Windows Server 2016. ARNIn questo esempio fa riferimento all'immagine più recente in SKU base ai filtri della versione semantica che hai specificato:arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x.

   {
   "name": "MyBasicRecipe",
   "description": "This example image recipe creates a Windows 2016 image.",
   "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   Nota

   Per ulteriori informazioni sul controllo delle versioni semantiche per le risorse di Image Builder, vedere. Versionamento semantico in Image Builder

2. Crea la ricetta

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

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

   Nota

   • È necessario includere la file:// notazione all'inizio del percorso del JSON file.

   • Il percorso del JSON file deve seguire la convenzione appropriata per il sistema operativo di base su cui viene eseguito il comando. Ad esempio, Windows utilizza la barra rovesciata (\) per fare riferimento al percorso della directory e Linux usa la barra (/).

1. Nella sezione Seleziona immagine per l'immagine di base, seleziona l'opzione Importa immagine di base.

2. Scegliete il sistema operativo (OS) dell'immagine e la versione del sistema operativo come fareste normalmente.

1. Fonte: può essere un bucket S3 o un'istantanea. EBS

2. Seleziona la posizione S3 del disco: inserisci la posizione in Amazon S3 in cui sono archiviate le immagini del disco. Per cercare la posizione, scegli Browse S3.

3. Per aggiungere un contenitore per dischi, scegli Aggiungi contenitore disco.

Generali

1. Specificate un nome univoco per l'immagine di base. Se non si inserisce un valore, l'immagine di base eredita il nome della ricetta.

2. Specificate una versione per l'immagine di base. Utilizza il seguente formato: <major>.<minor>.<patch>. Se non si inserisce un valore, l'immagine di base eredita la versione della ricetta.

3. È inoltre possibile inserire una descrizione per l'immagine di base.