Configurar a AMI distribuição com um modelo de EC2 lançamento - EC2Image Builder
Adicionar um modelo de EC2 lançamento às configurações de AMI distribuição do consoleAdicione um modelo de EC2 lançamento às configurações de AMI distribuição 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 AMI distribuição com um modelo de EC2 lançamento

Para ajudar a garantir uma experiência de lançamento consistente para seu Image Builder AMI em 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 o Windows Fast Launch em sua imagem, o modelo de execução deve incluir a seguinte tag para que o Image Builder possa habilitar o Windows Fast Launch em seu nome.

CreatedBy: EC2 Image Builder

Adicionar um modelo de EC2 lançamento às configurações de AMI distribuição do console

Para fornecer um modelo de lançamento com sua saídaAMI, 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 o tipo de saída Amazon Machine Image (AMI). 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.

    Marque 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 saídaAMI.

    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 AMI distribuição 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 no AWS CLI para criar e distribuir um Image Builder AMI e uma nova versão do modelo de execução que o usa.

  1. Configurar um arquivo de configurações de distribuição

    Antes de criar um Image Builder AMI com um modelo de execução, usando o AWS CLI, você deve criar uma JSON estrutura 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 JSON arquivo de configuração de distribuição que você criou no --cli-input-json parâmetro.

    aws imagebuilder create-distribution-configuration --name my distribution name--cli-input-json file://create-distribution-config-launch-template.json
    nota

    • Você deve incluir a file:// notação no início do caminho do JSON arquivo.

    • O caminho para o JSON arquivo deve seguir a convenção apropriada para o sistema operacional básico em que você está executando o comando. Por exemplo, o Windows usa a barra invertida (\) para se referir ao caminho do diretório e o Linux usa a barra (/).

Você também pode fornecer JSON diretamente no comando, usando o --distributions parâmetro.