Criar uma configuração de infraestrutura

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

No painel de navegação, escolha Configuração de infraestrutura.

Escolha Criar configuração de infraestrutura.

Na seção Geral, insira as seguintes informações obrigatórias:

No painel de AWS infraestrutura, defina as configurações de infraestrutura restantes. Insira as seguintes informações obrigatórias:

Se você não fornecer valores para as configurações a seguir, elas usarão padrões específicos do serviço, quando aplicável.

Na seção Tags de infraestrutura (opcional), você pode atribuir tags de metadados à instância do Amazon EC2 que o Image Builder executa durante o processo de compilação. Insira tags como pares de valores-chave.

Na seção Tags (opcional), você pode atribuir tags de metadados ao recurso de configuração de infraestrutura que o Image Builder cria como saída. Insira tags como pares de valores-chave.

Criar um arquivo JSON de entrada da CLI

Os exemplos a seguir mostram variações do arquivo JSON que você pode criar para a configuração da infraestrutura. Use uma ferramenta de edição de arquivos para criar seu próprio arquivo JSON.

Exemplo 1: configuração para reter uma instância de uma compilação com falha

Este exemplo especifica dois tipos de instância: m7i.large e m7i.xlarge. Recomendamos que você especifique mais de um tipo de instância, pois isso permite que o Image Builder execute uma instância a partir de um grupo com capacidade suficiente. Isto pode reduzir suas falhas transitórias de compilação.

O instanceProfileName especifica o perfil de instância que fornece à instância as permissões que o perfil exige para realizar atividades de personalização. Por exemplo, se você tem um componente que recupera recursos do Amazon S3, o perfil de instância exige permissões para acessar esses arquivos. O perfil de instância também exige um conjunto mínimo de permissões para que o EC2 Image Builder se comunique com sucesso com a instância. Para obter mais informações, consulte Configurar compilação de imagens personalizadas com o Image Builder.

{
    "name": "ExampleInfraConfigDontTerminate",
    "description": "An example that will retain instances of failed builds",
    "instanceTypes": [
        "m7i.large", "m7i.xlarge"
    ],
    "instanceProfileName": "myIAMInstanceProfileName",
    "securityGroupIds": [
        "sg-12345678"
    ],
    "subnetId": "subnet-12345678",
    "logging": {
        "s3Logs": {
            "s3BucketName": "my-logging-bucket",
            "s3KeyPrefix": "my-path"
        }
    },
    "keyPair": "myKeyPairName",
    "terminateInstanceOnFailure": false,
    "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:MyTopic"
}

Exemplo 2: configuração do macOS com posicionamento automático

Este exemplo especifica os tipos de instância e o posicionamento de uma instância do Mac em que o host dedicado tem o posicionamento automático habilitado.

{
   "name": "macOSInfraConfigAutoPlacement",
   "description": "An example infrastructure configuration for macOS.",
   "instanceProfileName": "EC2InstanceProfileForImageBuilder",
   "instanceTypes": ["mac1.metal", "mac2.metal"],
   "terminateInstanceOnFailure": false,
   "placement": {
      "tenancy": "host"
   }
}

Exemplo 3: configuração do macOS com o ID do host especificado

Este exemplo especifica o tipo de instância e o posicionamento de uma instância do Mac que tem como destino um host dedicado específico.

{
   "name": "macOSInfraConfigHostPlacement",
   "description": "An example infrastructure configuration for macOS.",
   "instanceProfileName": "EC2InstanceProfileForImageBuilder",
   "instanceTypes": ["mac2-m1ultra.metal"],
   "terminateInstanceOnFailure": false,
   "placement": {
      "tenancy": "host",
      "hostId" : "h-1234567890abcdef0"
   }
}

Exemplo 4: VPC personalizada com registro em log do IMDSv2 e do Amazon S3

Este exemplo inicia instâncias em uma sub-rede e um grupo de segurança específicos, exige tokens IMDSv2 e grava registros de aplicativos no Amazon S3. Como o exemplo definesubnetId, ele também deve ser definidosecurityGroupIds.

{
    "name": "VpcInfraConfigWithLogging",
    "description": "Build in a custom VPC with IMDSv2 and S3 logging",
    "instanceTypes": ["m7i.large", "m8i.large"],
    "instanceProfileName": "EC2InstanceProfileForImageBuilder",
    "subnetId": "subnet-12345678",
    "securityGroupIds": ["sg-12345678"],
    "instanceMetadataOptions": {
        "httpTokens": "required",
        "httpPutResponseHopLimit": 2
    },
    "logging": {
        "s3Logs": {
            "s3BucketName": "my-logging-bucket",
            "s3KeyPrefix": "image-builder-logs"
        }
    },
    "resourceTags": {
        "Project": "golden-ami"
    },
    "terminateInstanceOnFailure": true
}

Exemplo 5: Colocação de host dedicado com um grupo de recursos de host

Este exemplo tem como alvo um grupo de recursos de host em vez de um ID de host específico. Por tenancy issohost, você pode especificar um ARN do grupo de recursos do host. Também não especifique umhostId.

{
    "name": "HostResourceGroupInfraConfig",
    "instanceProfileName": "EC2InstanceProfileForImageBuilder",
    "instanceTypes": ["mac2.metal"],
    "terminateInstanceOnFailure": false,
    "placement": {
        "tenancy": "host",
        "hostResourceGroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/my-host-group"
    }
}

Use o arquivo que você criou como entrada quando executar o seguinte comando.

aws imagebuilder create-infrastructure-configuration --cli-input-json file://create-infrastructure-configuration.json