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à.
# Crea immagini personalizzate con Image Builder
Esistono diversi modi per creare una nuova immagine di Image Builder. Ad esempio, è possibile utilizzare uno dei seguenti metodi per creare un'immagine con Console di gestione AWS o AWS CLI. Puoi anche utilizzare l'azione [CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html)API o eseguire una pipeline di compilazione per creare l'immagine. Per la richiesta SDK associata all'azione API, puoi fare riferimento al link [Vedi anche](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html#API_CreateImage_SeeAlso) per quel comando nel riferimento all'API *EC2 Image* Builder.
------
#### [ Console di gestione AWS ]
Per creare una nuova immagine da una pipeline esistente, puoi eseguire manualmente la pipeline, come segue. È inoltre possibile utilizzare la procedura guidata per la pipeline per creare una nuova immagine partendo da zero. Vedi [Procedura guidata per la pipeline: crea AMI](start-build-image-pipeline.md) o[Pipeline Wizard: crea un'immagine del contenitore](start-build-container-pipeline.md), a seconda del tipo di immagine che desideri creare.
1. Apri la console EC2 Image Builder [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)all'indirizzo.
1. Scegli **Image pipelines dal pannello** di navigazione.
1. Seleziona la casella di controllo accanto al **nome della pipeline** che desideri eseguire.
1. Per creare l'immagine, selezionate **Esegui pipeline** dal menu **Azioni**. Questo avvia la pipeline.
Puoi anche specificare una pianificazione per eseguire la pipeline o utilizzare Amazon EventBridge per eseguire la pipeline in base a regole che configuri.
------
#### [ AWS CLI ]
Prima di eseguire il **[create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)** comando in AWS CLI, devi creare le seguenti risorse se non esistono già:
**Risorse obbligatorie**
+ **Ricetta**: è necessario specificare esattamente una ricetta per l'immagine, come segue:
Immagine (ricetta)
Specificate l'Amazon Resource Name (ARN) per la risorsa di ricette di immagini con il `--image-recipe-arn` parametro.
Ricetta del contenitore
Specificate l'ARN per la risorsa della ricetta del contenitore con il `--container-recipe-arn` parametro.
+ **Configurazione dell'infrastruttura**: specifica l'ARN per la risorsa di configurazione dell'infrastruttura con il `--infrastructure-configuration-arn` parametro.
È inoltre possibile specificare una delle seguenti risorse richieste dall'immagine:
**Risorse e configurazione opzionali**
+ **Configurazione della distribuzione**: per impostazione predefinita, Image Builder distribuisce la risorsa dell'immagine di output all'account dell'utente nella regione in cui viene eseguito il comando. **create-image** Per fornire destinazioni o configurazioni aggiuntive per la tua distribuzione, specifica l'ARN per la risorsa di configurazione della distribuzione con il `--distribution-configuration-arn` parametro.
+ **Scansione delle immagini**: per configurare le istantanee dei risultati di Amazon Inspector sull'istanza di test dell'immagine o del contenitore, utilizza `--image-scanning-configuration` il parametro. Per le immagini dei contenitori, specifica anche l'archivio ECR che Amazon Inspector utilizza per le sue scansioni.
+ **Test delle immagini** — Per sopprimere la fase di test di Image Builder, utilizzate `--image-tests-configuration` il parametro. In alternativa, è possibile impostare un timeout per quanto tempo può durare.
+ **Tag di immagine**: utilizzate il `--tags` parametro per aggiungere tag alla risorsa di immagini di output.
+ **Flussi di lavoro di immagini**: se non specificate alcun flusso di lavoro di compilazione o test, Image Builder crea l'immagine con il relativo flusso di lavoro predefinito. Per specificare i flussi di lavoro che hai creato, utilizza il parametro. `--workflows`
**Nota**
Se specifichi flussi di lavoro basati su immagini, devi anche fornire il nome o l'ARN del ruolo IAM utilizzato da Image Builder per eseguire le azioni del flusso di lavoro nel parametro. `--execution-role`
[L'esempio seguente mostra come creare un'immagine con il comando create-image.](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html) AWS CLI Per ulteriori informazioni, consulta la sezione relativa alle *informazioni di riferimento ai comandi di AWS CLI *.
**Esempio: creare un'immagine di base con distribuzione predefinita**
```
aws imagebuilder create-image --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/simple-recipe-linux/1.0.0 --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/simple-infra-config-linux
```
**Output:**
```
{
"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0",
"name": "simple-recipe-linux",
...
}
]
}
```
------
## Annulla la creazione dell'immagine da AWS CLI
Per annullare la creazione di un'immagine in corso, utilizzate il **cancel-image-creation** comando seguente:
```
aws imagebuilder cancel-image-creation --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-recipe/2019.12.03/1
```