Configurar a distribuição da AMI com um modelo de EC2 lançamento - EC2 Image Builder
Adicione um modelo de EC2 lançamento às configurações de distribuição da AMI a partir do consoleAdicione um modelo de EC2 lançamento às configurações de distribuição da AMI a partir do AWS CLI

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 EC2 lançamento

Para ajudar a garantir uma experiência de lançamento consistente para sua AMI do Image Builder nas contas e regiões de destino, você pode especificar um modelo de EC2 lançamento da Amazon em suas configurações de distribuição, usandolaunchTemplateConfigurations. 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 como iniciar uma EC2 instância usando um modelo de execução, consulte um dos links a seguir, dependendo do sistema operacional de destino.

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

Adicione um modelo de EC2 lançamento às configurações de distribuição da AMI a partir do console

Para fornecer um modelo de execução com sua AMI de saída, siga estas etapas no console:

  1. Abra o console do EC2 Image Builder em https://console.aws.amazon.com/imagebuilder/.

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

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

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

  5. Na seção Geral, insira o Nome do recurso de configurações de distribuição que você deseja criar (obrigatório).

  6. Na seção Configurações da região, selecione o nome de um modelo de EC2 lançamento 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 EC2painel.

    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.

  7. 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 EC2 lançamento à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, denominadocreate-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"
}
  2. Criar as configurações de distribuição

    Para criar um recurso de configurações de distribuição do Image Builder usando o create-distribution-configurationcomando 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 (\) 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.