Crea una nuova versione di una ricetta di immagini

Per creare una nuova versione della ricetta dell'immagine:

1. Nella parte superiore della pagina dei dettagli della ricetta, scegli Crea nuova versione. Si apre la pagina Crea immagine della ricetta.

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

   L'immagine finale può contenere fino a nove codici prodotto tratti da Marketplace AWS prodotti e componenti illustrati. Image Builder restituisce un errore durante la creazione della ricetta se l'immagine di base e i componenti superano questo limite.

1. Creazione di un file JSON di input nella CLI

   È possibile fornire tutti gli 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, puoi invece fornire un file JSON che contiene tutte le impostazioni della ricetta.

   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 CreateImageRecipe 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 specificati da questi esempi:

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

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

   • parentImage (string, required) — L'immagine che la ricetta dell'immagine utilizza come base per l'immagine personalizzata. È possibile specificare l'immagine principale utilizzando una delle seguenti opzioni:

     • ID AMI: da utilizzare quando si dispone di un'AMI specifica (ad esempioami-1234567890abcdef1) che si desidera personalizzare. Poiché un ID AMI è statico, consigliamo invece un ARN di immagine Image Builder o un parametro SSM quando desideri che la ricetta raccolga automaticamente le immagini di base più recenti.

     • Risorsa di immagini Image Builder ARN: da utilizzare quando si desidera creare su un'immagine Image Builder. Ciò include Amazon-managed le immagini fornite da Image Builder per i sistemi operativi più diffusi, nonché le immagini create in precedenza. Specifica l'ARN dell'immagine con una versione semantica o utilizza un carattere jolly per ottenere sempre la versione più recente.

     • AWS Systems Manager (SSM) Parametro Store: da utilizzare quando si desidera che la ricetta raccolga automaticamente nuovi ID AMI senza creare una nuova versione della ricetta. Inserite il prefisso del parametro conssm:, seguito dal nome del parametro o dall'ARN. È ideale per le pipeline che devono sempre utilizzare l'immagine base Amazon Linux o Windows più recente.

     • Marketplace AWS ID prodotto: da utilizzare quando ti abboni a un prodotto AMI Marketplace AWS e desideri personalizzarlo ulteriormente.

     Nota

     • Quando utilizzi un ID AMI o un parametro SSM che si risolve in un'AMI, devi avere accesso a quell'AMI nel tuo account. L'AMI deve inoltre esistere nella stessa regione in cui Image Builder esegue la build.

     • Gli esempi Linux e macOS specificano un ID AMI e l'esempio Windows utilizza un ARN di immagine Image Builder.

   • <major>SemanticVersion (string, obbligatorio): inserisci il numero di versione che desideri creare nel formato. <minor>. <patch>. Image Builder supporta l'incremento automatico delle versioni per le ricette, consentendo di utilizzare modelli di caratteri jolly nelle versioni delle ricette. Quando si crea una ricetta con una versione con caratteri jolly, ad esempio1.0.x, Image Builder incrementa automaticamente la versione (ad esempio,, 1.0.1 1.0.21.0.3, e così via). Ciò elimina la necessità di tracciare e incrementare manualmente le versioni delle ricette. Per ulteriori informazioni sul controllo semantico delle versioni per le risorse di Image Builder, vedere. Versionamento semantico in Image Builder

   • componenti (array, opzionale): contiene una serie di ComponentConfiguration oggetti. I componenti sono opzionali: puoi creare ricette senza componenti per i flussi di lavoro di test o distribuzione:

     Nota

     Image Builder installa i componenti nell'ordine in cui sono stati 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 uno degli esempi per creare una ricetta di immagini personalizzata, è necessario sostituire gli ARN di esempio con gli ARN per i componenti utilizzati per la ricetta.

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

   • amiWatermarks (array of strings, opzionale) — Un elenco di nomi di filigrana da allegare alle AMI di output create con questa ricetta. Le filigrane sono marcatori di derivazione che consentono di tracciare la cronologia delle immagini. Specificate da 1 a 5 nomi. Ogni nome deve contenere da 3 a 128 caratteri e può includere lettere, numeri, spazi e i seguenti caratteri speciali:( ) [ ] . / - ' @ _. Per ulteriori informazioni, consulta Tieni traccia del lignaggio AMI con filigrane.

   • additional InstanceConfiguration (object): specifica le impostazioni aggiuntive e avvia gli script per le istanze di build.

     • systems ManagerAgent (object) — Contiene le impostazioni per l'agente Systems Manager sull'istanza di compilazione.

       Nota

       Le ricette di Windows non supportano la systemsManagerAgent configurazione. Se la includi con un'immagine principale di Windows, la richiesta non riesce.

       • uninstall AfterBuild (Boolean): controlla se l'agente di 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 acceso in modo da essere incluso nella nuova AMI. Il valore predefinito è false.

         Nota

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

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

         • Image Builder ha installato automaticamente l'agente Systems Manager sull'istanza di compilazione di un sistema operativo in cui l'agente non era preinstallato nell'immagine di base.

     • user DataOverride (string): 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 di Linux utilizza questo valore codificato.

   Linux

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

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

   Windows

   L'esempio seguente si riferisce alla versione più recente dell'immagine Windows Server 2016 English Full Base. L'ARN in questo esempio fa riferimento all'immagine più recente in 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:111122223333:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   Nota

   Per saperne di più sul controllo delle versioni semantiche per le risorse di Image Builder, vedi. Versionamento semantico in Image Builder

   macOS

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

   {
   "name": "macOS Catalina Image recipe",
   "description": "Hello World image recipe for macOS.",
   "parentImage": "ami-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Esempio: ricetta senza componenti

   È possibile creare ricette senza componenti per testare le AMI esistenti o i flussi di lavoro solo per la distribuzione. L'esempio seguente mostra una ricetta che utilizza un'AMI esistente senza applicare componenti aggiuntivi:

   {
   	"name": "Test Distribution Recipe",
   	"description": "Recipe for testing and distributing existing AMI without modifications.",
   	"parentImage": "ami-1234567890abcdef1",
   	"semanticVersion": "1.0.0",
   	"additionalInstanceConfiguration": {
   		"systemsManagerAgent": {
   		 	"uninstallAfterBuild": true
   		}
   	}
   }

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-image-recipe --cli-input-json file://create-image-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'immagine finale può contenere fino a nove codici prodotto tratti da prodotti e componenti di Marketplace AWS immagine. Image Builder restituisce un errore durante la creazione della ricetta se l'immagine di base e i componenti superano questo limite quando si esegue il create-image-recipe comando.

   Il comando restituisce l'ARN della nuova ricetta di immagini, come mostrato nell'output di esempio seguente.

   {
   	"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
   	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
   	"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1"
   }

3. Verifica la tua ricetta

   Per confermare che Image Builder abbia creato la ricetta come previsto, esegui il get-image-recipe comando con l'ARN restituito dal passaggio precedente.

   aws imagebuilder get-image-recipe --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1

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

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

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

2. Seleziona la posizione del disco in S3: 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.

Ambito generale

1. Specificate un nome univoco per l'immagine di base. Se non inserite 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 inserite un valore, l'immagine di base eredita la versione della ricetta.

3. Puoi anche inserire una descrizione per l'immagine di base.