As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Configurar a distribuição da AMI com um modelo de execução do EC2
A fim de ajudar a garantir uma experiência de execução consistente para sua AMI do Image Builder nas contas e regiões de destino, você pode usar `launchTemplateConfigurations` para especificar um modelo de execução do Amazon EC2 em suas configurações de distribuição. Quando `launchTemplateConfigurations` estão presentes durante o processo de distribuição, o Image Builder cria uma nova versão do modelo de lançamento que inclui todas as configurações originais do modelo e a nova AMI ID da compilação. Para obter mais informações sobre a execução de uma instância do EC2 usando um modelo de execução, consulte um dos links a seguir dependendo do sistema operacional de destino.
+ [Executar uma instância Linux a partir de um modelo de execução](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
+ [Executar uma instância Windows a partir de um modelo de execução](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
**nota**
Quando você inclui um modelo de execução para habilitar a inicialização rápida do Windows em sua imagem, o modelo de execução deve incluir a tag a seguir para que o Image Builder possa habilitá-la em seu nome.
`CreatedBy: EC2 Image Builder`
## Adicionar um modelo de execução do EC2 às configurações de distribuição da AMI com o console
Para fornecer um modelo de execução com sua AMI de saída, siga estas etapas no console:
1. Abra o console [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)do EC2 Image Builder em.
1. Escolha **Configurações de distribuição** no painel de navegação. Isso mostra uma lista das configurações de distribuição criadas em sua conta.
1. Na parte superior da página **Configurações de distribuição**, escolha **Criar configurações de distribuição**. Isso abre a página **Criar configurações de distribuição**.
1. Na seção **Tipo de imagem**, escolha **imagem de máquina da Amazon (AMI)** como o **tipo de saída**. Essa é a configuração padrão.
1. Na seção **Geral**, insira o **Nome** do recurso de configurações de distribuição que você deseja criar (*obrigatório*).
1. Na seção **Configurações de região**, selecione o nome de um modelo de execução do EC2 na lista. Se não houver modelos de lançamento em sua conta, escolha **Criar novo modelo de lançamento**, que abre os **modelos de lançamento** no **painel do EC2**.
Selecione a caixa de seleção **Definir a versão padrão** para atualizar a versão padrão do modelo de execução para a nova versão que o Image Builder cria com sua AMI de saída.
Para adicionar outro modelo de lançamento à região selecionada, escolha **Adicionar configuração de modelo de lançamento**.
Para remover um modelo de lançamento, escolha **Remover**.
1. Continue especificando quaisquer configurações adicionais necessárias e escolha **Criar configurações** para criar seu novo recurso de configurações de distribuição.
## Adicione um modelo de execução do EC2 às configurações de distribuição da AMI a partir do AWS CLI
Esta seção descreve como definir um arquivo de configurações de distribuição com um modelo de execução e usar o **create-image** comando em AWS CLI para criar e distribuir uma AMI do Image Builder e uma nova versão do modelo de execução que a usa.
1.
**Configurar um arquivo de configurações de distribuição**
Antes de criar uma AMI do Image Builder com um modelo de execução, usando o AWS CLI, você deve criar uma estrutura JSON de configuração de distribuição que especifique as `launchTemplateConfigurations` configurações. Você deve especificar pelo menos uma entrada `launchTemplateConfigurations` na região de origem.
O arquivo de exemplo a seguir, denominado`create-distribution-config-launch-template.json`, mostra alguns cenários possíveis para a configuração do modelo de execução na região de origem.
```
{
"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.
**Criar as configurações de distribuição**
Para criar um recurso de configurações de distribuição do Image Builder usando o [create-distribution-configuration](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-distribution-configuration.html)comando no AWS CLI, forneça os seguintes parâmetros no comando:
+ Insira o nome da distribuição no parâmetro `--name`.
+ Anexe o arquivo JSON de configuração de distribuição que você criou no parâmetro `--cli-input-json`.
```
aws imagebuilder create-distribution-configuration --name my distribution name--cli-input-json file://create-distribution-config-launch-template.json
```
**nota**
É necessário incluir a notação `file://` no início do caminho do arquivo JSON.
O caminho para o arquivo JSON deve seguir a convenção apropriada para o sistema operacional de base no qual você está executando o comando. Por exemplo, o Windows usa a barra invertida (\$1) para se referir ao caminho do diretório, enquanto o Linux e o macOS usam a barra (/).
*Você também pode fornecer o JSON diretamente no comando, usando o parâmetro `--distributions`.*