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à.
# Configura la distribuzione AMI con un modello di lancio EC2
Per garantire un'esperienza di lancio coerente per l'AMI Image Builder negli account e nelle regioni di destinazione, puoi specificare un modello di lancio di Amazon EC2 nelle impostazioni di distribuzione, utilizzando. `launchTemplateConfigurations` Quando `launchTemplateConfigurations` sono presenti durante il processo di distribuzione, Image Builder crea una nuova versione del modello di lancio che include tutte le impostazioni originali del modello e il nuovo ID AMI della build. Per ulteriori informazioni sull'avvio di un'istanza EC2 utilizzando un modello di avvio, consulta uno dei seguenti link, a seconda del sistema operativo di destinazione.
+ [Avvia un'istanza Linux da un modello di avvio](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
+ [Avvia un'istanza Windows da un modello di avvio](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
**Nota**
Quando si include un modello di avvio per abilitare Windows Fast Launch nell'immagine, il modello di avvio deve includere il tag seguente in modo che Image Builder possa abilitare Windows Fast Launch per conto dell'utente.
`CreatedBy: EC2 Image Builder`
## Aggiungi un modello di avvio EC2 alle impostazioni di distribuzione AMI dalla console
Per fornire un modello di lancio con l'AMI di output, segui questi passaggi nella console:
1. Apri la console EC2 Image Builder [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)all'indirizzo.
1. Scegli **le impostazioni di distribuzione** dal pannello di navigazione. Questo mostra un elenco delle impostazioni di distribuzione create con il tuo account.
1. Nella parte superiore della pagina delle **impostazioni di distribuzione**, scegli **Crea impostazioni di distribuzione**. Si apre la pagina **Crea impostazioni di distribuzione**.
1. Nella sezione **Tipo di immagine**, scegli il **tipo di output** di **Amazon Machine Image (AMI)**. Questa è l'impostazione predefinita.
1. Nella sezione **Generale**, inserisci il **nome** della risorsa di impostazioni di distribuzione che desideri creare (*obbligatorio*).
1. Nella sezione **Impostazioni regionali**, seleziona il nome di un modello di lancio EC2 dall'elenco. Se non ci sono modelli di lancio nel tuo account, scegli **Crea nuovo modello di lancio**, che apre i **modelli di lancio** nella dashboard di **EC2**.
Seleziona la casella di controllo **Imposta la versione predefinita** per aggiornare la versione predefinita del modello di avvio alla nuova versione creata da Image Builder con l'AMI di output.
Per aggiungere un altro modello di avvio alla regione selezionata, scegli **Aggiungi configurazione del modello di avvio**.
Per rimuovere un modello di lancio, scegli **Rimuovi**.
1. Continua a specificare tutte le impostazioni aggiuntive di cui hai bisogno e scegli **Crea impostazioni per creare** la nuova risorsa per le impostazioni di distribuzione.
## Aggiungi un modello di avvio EC2 alle impostazioni di distribuzione AMI dal AWS CLI
Questa sezione descrive come configurare un file di impostazioni di distribuzione con un modello di avvio e utilizzare il **create-image** comando in AWS CLI per creare e distribuire un'AMI Image Builder e una nuova versione del modello di avvio che la utilizza.
1.
**Configurare un file delle impostazioni di distribuzione**
Prima di poter creare un'AMI Image Builder con un modello di avvio, utilizzando AWS CLI, è necessario creare una struttura JSON di configurazione della distribuzione che specifichi le impostazioni. `launchTemplateConfigurations` È necessario specificare almeno una `launchTemplateConfigurations` voce nella regione di origine.
Il seguente file di esempio, denominato`create-distribution-config-launch-template.json`, mostra alcuni possibili scenari per la configurazione del modello di avvio nella regione di origine.
```
{
"name": "NewDistributionConfiguration",
"description": "This is just a test",
"distributions": [
{
"region": "us-west-2",
"amiDistributionConfiguration": {
"name": "test-{{imagebuilder:buildDate}}-{{imagebuilder:buildVersion}}",
"description": "description"
},
"launchTemplateConfigurations": [
{
"launchTemplateId": "lt-0a1bcde2fgh34567",
"accountId": "935302948087",
"setDefaultVersion": true
},
{
"launchTemplateId": "lt-0aaa1bcde2ff3456"
},
{
"launchTemplateId": "lt-12345678901234567",
"accountId": "123456789012"
}
]
}
],
"clientToken": "clientToken1"
}
```
1.
**Create le impostazioni di distribuzione**
Per creare una risorsa per le impostazioni di distribuzione di Image Builder utilizzando il [create-distribution-configuration](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-distribution-configuration.html)comando in AWS CLI, fornire i seguenti parametri nel comando:
+ Immettete il nome della distribuzione nel `--name` parametro.
+ Allega il file JSON di configurazione della distribuzione che hai creato nel `--cli-input-json` parametro.
```
aws imagebuilder create-distribution-configuration --name my distribution name--cli-input-json file://create-distribution-config-launch-template.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 (\$1) per fare riferimento al percorso della directory, mentre Linux e macOS utilizzano la barra (/).
*È inoltre possibile fornire JSON direttamente nel comando, utilizzando il parametro. `--distributions`*