Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Gestisci le ricette in Image Builder
Una ricetta EC2 Image Builder è il modello per creare un'immagine personalizzata della macchina. Una ricetta specifica tre elementi chiave:
-
Immagine base: il punto di partenza dell'immagine (un'AMI, un'immagine del contenitore o una VM importata).
-
Componenti: le fasi di creazione e test che consentono di personalizzare l'immagine. I componenti sono opzionali. Questo design supporta flussi di lavoro esclusivamente di test e distribuzione.
-
Configurazione: volumi di archiviazione, impostazioni delle istanze, directory di lavoro e altri parametri in fase di compilazione.
Image Builder supporta due tipi di ricette:
-
Le ricette di immagini producono Amazon Machine Images (AMI) che puoi utilizzare per avviare istanze Amazon EC2.
-
Le ricette dei contenitori producono immagini di Docker container archiviate nei repository Amazon ECR.
Le ricette sono immutabili. Dopo aver creato una ricetta, non puoi modificarla o sostituirla. Per aggiornare i componenti o qualsiasi altra configurazione, è necessario creare una nuova ricetta o versione della ricetta. Image Builder conserva tutte le versioni precedenti. Ciò consente di risalire all'origine dell'immagine fino alla ricetta esatta che ha prodotto ciascun output. Puoi sempre applicare tag alle tue ricette esistenti. Per ulteriori informazioni sull'etichettatura delle risorse utilizzando i comandi di Image Builder nel AWS CLI, consulta la Aggiunta di tag alle risorse sezione di questa guida.
Suggerimento
Puoi utilizzare i componenti gestiti da Amazon nelle tue ricette oppure puoi sviluppare componenti personalizzati. Per ulteriori informazioni, consulta Sviluppa componenti personalizzati per la tua immagine Image Builder. Per le ricette di immagini che creano AMI di output, puoi anche utilizzare prodotti e componenti di Marketplace AWS immagini. Per ulteriori informazioni sull'integrazione con Marketplace AWS i prodotti, vedereMarketplace AWS integrazione in Image Builder.
Usa gli argomenti di questa sezione per gestire le tue ricette EC2 Image Builder, incluso elencare le ricette esistenti, visualizzarne i dettagli e creare nuove versioni delle ricette.
Ricette con immagini confrontate con ricette in contenitori
La tabella seguente confronta le caratteristiche delle ricette con immagini e delle ricette in contenitori.
| Funzionalità | Ricetta illustrata | Ricetta del contenitore |
|---|---|---|
| Output | AMI | Dockerimmagine del contenitore in Amazon ECR |
| Fonti di immagini di base | ID AMI, Image Builder image ARN, parametro SSM, prodotto Marketplace AWS | Docker Hubimmagine, immagine Amazon ECR, immagine, Amazon-managed immagine Image Builder ARN |
| Dockerfile | Non applicabile | Obbligatorio (modello con variabili contestuali) |
| Repository di destinazione | Non applicabile | Amazon ECR (obbligatorio) |
| Configurazione di archiviazione | Blocca le mappature dei dispositivi per l'AMI di uscita | Blocca le mappature dei dispositivi per l'istanza di compilazione |
| Dati utente | Supportato (sostituisce l'impostazione predefinita di cloud-init) | Non supportato a livello di ricetta |
| Controllo tramite agente di Systems Manager | Configurabile (disinstallazione dopo la compilazione) | Non configurabile |
| Marketplace AWS componenti | Supportata | Non supportata |
| Sostituzione della piattaforma | Non applicabile (rilevato dall'AMI) | Disponibile per Amazon ECR e immagini Docker Hub |
Controllo delle versioni delle ricette
<major>Ogni ricetta utilizza il controllo semantico delle versioni nel formato. <minor>. <patch>. Ogni nodo di versione accetta valori da 0 a 1.073.741.823 (2^30 - 1).
È possibile utilizzare un carattere jolly (x) in una posizione per abilitare l'incremento automatico della versione. Quando si crea una ricetta con una versione con caratteri jolly, Image Builder la sostituisce x con il successivo numero disponibile per quella posizione.
| Pattern | Comportamento | Sequenza di esempio |
|---|---|---|
1.0.x |
Incrementa il numero di patch | 1.0.1, 1.0.2, 1.0.3,... |
1.x.0 |
Incrementa il numero secondario | 1.1.0, 1.2.0, 1.3.0,... |
x.0.0 |
Incrementa il numero principale | 1.0.0, 2.0.0, 3.0.0,... |
Le seguenti regole si applicano alle versioni con caratteri jolly:
-
È consentito un solo
xcarattere jolly per stringa di versione. -
Il carattere jolly può apparire in qualsiasi posizione (maggiore, secondaria o patch).
-
I valori numerici nelle posizioni rimanenti devono essere numeri interi espliciti.
Suggerimento
Usa le versioni con caratteri jolly nella tua CI/CD automazione in modo da non dover tracciare e incrementare manualmente le versioni delle ricette. Ogni volta che crei una ricetta con lo stesso carattere jolly, Image Builder risolve la successiva versione disponibile. Ad esempio, una ricetta che utilizza sempre 1.0.x risolve to1.0.1, then 1.0.2 e così via. Per ulteriori informazioni sul controllo semantico delle versioni per le risorse di Image Builder, vedere. Versionamento semantico in Image Builder
Vincoli e limiti delle ricette
Prima di creare una ricetta, esaminate i seguenti vincoli.
| Vincolo | Limite | Note |
|---|---|---|
| Componenti per ricetta | 20 (impostazione predefinita) | Include componenti di compilazione e di test. Puoi richiedere un aumento tramite Supporto AWS. |
| Dimensione massima della ricetta | 25 KB | La dimensione cumulativa di tutte le configurazioni dei componenti, inclusi i valori dei parametri. |
| Codici di prodotto per immagine di output | 9 | Combinato dall'immagine di base e dai Marketplace AWS componenti. |
| Unicità dei componenti | Uno per ricetta | Lo stesso componente (indipendentemente dalla versione) può apparire solo una volta. |
| Numero massimo di nodi di versione | 1.073.741.823 | Per nodo (principale, secondario o patch). |
| Nome ricetta | Non può essere modificato | Il nome viene corretto dopo la creazione. Crea una nuova ricetta con un nome diverso. |
I componenti devono inoltre soddisfare i seguenti requisiti di compatibilità:
-
I componenti devono corrispondere alla piattaforma della ricetta (Linux, Windows o macOS).
-
I componenti devono supportare la versione del sistema operativo dell'immagine principale, quando sono disponibili i metadati della versione del sistema operativo.
-
I componenti con
DISABLEDlo statoDEPRECATEDo non possono essere aggiunti a nuove ricette. -
I componenti di rafforzamento CIS richiedono un'immagine CIS-published principale.
Eseguire la pulizia delle risorse
Per evitare costi imprevisti, assicurati di ripulire le risorse e le pipeline che hai creato con gli esempi di questa guida. Per ulteriori informazioni sull'eliminazione delle risorse in Image Builder, consulta. Eliminare risorse Image Builder obsolete o inutilizzate
