View a markdown version of this page

Atualizar uma configuração de infraestrutura - EC2 Image Builder

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

Atualizar uma configuração de infraestrutura

Esta seção aborda como você pode usar o console ou os imagebuilder comandos do Image Builder no AWS CLI para atualizar um recurso de configuração de infraestrutura. Para monitorar seus recursos, é possível aplicar tags da maneira a seguir. Insira tags como pares de valores-chave.

  • As tags de recursos atribuem tags de metadados à instância do Amazon EC2 que o Image Builder executa durante o processo de compilação.

  • Em Tags, atribua tags de metadados ao recurso de configuração de infraestrutura que o Image Builder cria como saída.

Console

Você pode editar os seguintes detalhes de configuração da infraestrutura no console do Image Builder:

  • A descrição da configuração da infraestrutura.

  • Associe o perfil do IAM para associar ao perfil de instância.

  • AWS infraestrutura, incluindo o tipo de instância e um tópico do SNS para notificações.

  • VPC, sub-rede e grupos de segurança.

  • Configurações de solução de problemas, incluindo Encerrar instância em caso de falha, o par de chaves para conexão e um local opcional do bucket S3 para os logs da instância.

Para atualizar um recurso de configuração de infraestrutura do console do Image Builder, siga estas etapas:

Escolha uma configuração de infraestrutura existente do Image Builder

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

  2. Para ver uma lista dos recursos de configuração de infraestrutura em sua conta, escolha Configuração de infraestrutura no painel de navegação.

  3. Para ver detalhes ou editar uma configuração de infraestrutura, escolha o link Nome da configuração. Isto abre a visualização detalhada da configuração da infraestrutura.

    nota

    Você também pode selecionar a caixa ao lado do nome da configuração e, em seguida, escolher Exibir detalhes.

  4. No canto superior direito do painel Detalhes da infraestrutura, escolha Editar.

  5. Quando estiver pronto para salvar as atualizações feitas na configuração da sua infraestrutura, escolha Salvar alterações .

AWS CLI

O exemplo a seguir mostra como atualizar a configuração da infraestrutura da sua imagem com o comando update-infrastructure-configuration do Image Builder na AWS CLI.

  1. Criar um arquivo JSON de entrada da CLI

    Neste exemplo, as configurações correspondem ao exemplo de criação, exceto que terminateInstanceOnFailure está definido comotrue. Depois de executar o update-infrastructure-configuration comando, os pipelines que usam essa configuração de infraestrutura encerram as instâncias de compilação e teste quando uma compilação falha.

    O exemplo a seguir define campos de infraestrutura comuns. Para exigir tokens IMDSv2 nas instâncias de construção e teste, adicione um instanceMetadataOptions bloco com httpTokens set to. required

    nota

    Recomendamos que você configure todas as instâncias do EC2 que o Image Builder executa a partir de um pipeline criado para usar o IMDSv2, de forma que as solicitações de recuperação de metadados da instância exijam um cabeçalho de token assinado.

    Use uma ferramenta de edição de arquivos para criar um arquivo JSON com as chaves mostradas no exemplo a seguir, além de valores válidos para seu ambiente. Este exemplo usa um arquivo denominado update-infrastructure-configuration.json:

    {
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
"description": "An example that will terminate instances of failed builds",
"instanceTypes": [
    "m7i.large", "m7i.2xlarge"
],
"instanceProfileName": "myIAMInstanceProfileName",
"securityGroupIds": [
    "sg-12345678"
],
"subnetId": "subnet-12345678",
"logging": {
    "s3Logs": {
        "s3BucketName": "my-logging-bucket",
        "s3KeyPrefix": "my-path"
    }
},
"terminateInstanceOnFailure": true,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:MyTopic"
}
  2. Use o arquivo que você criou como entrada quando executar o seguinte comando.
    aws imagebuilder update-infrastructure-configuration --cli-input-json file://update-infrastructure-configuration.json