Exemplos do Image Builder usando AWS CLI - AWS Command Line Interface

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

Exemplos do Image Builder usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with Image Builder.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

O código de exemplo a seguir mostra como usar create-component.

AWS CLI

Para criar um componente

O create-component exemplo a seguir cria um componente que usa um arquivo de JSON documento e faz referência a um documento de componente no YAML formato que é carregado em um bucket do Amazon S3.

aws imagebuilder create-component \ --cli-input-json file://create-component.json

Conteúdo de create-component.json:

{ "name": "MyExampleComponent", "semanticVersion": "2019.12.02", "description": "An example component that builds, validates and tests an image", "changeDescription": "Initial version.", "platform": "Windows", "uri": "s3://s3-bucket-name/s3-bucket-path/component.yaml" }

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte CreateComponentna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-distribution-configuration.

AWS CLI

Para criar uma configuração de distribuição

O create-distribution-configuration exemplo a seguir cria uma configuração de distribuição usando um JSON arquivo.

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

Conteúdo de create-distribution-configuration.json:

{ "name": "MyExampleDistribution", "description": "Copies AMI to eu-west-1", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "Name {{imagebuilder:buildDate}}", "description": "An example image name with parameter references", "amiTags": { "KeyName": "{{ssm:parameter_name}}" }, "launchPermission": { "userIds": [ "123456789012" ] } } }, { "region": "eu-west-1", "amiDistributionConfiguration": { "name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}", "amiTags": { "KeyName": "Value" }, "launchPermission": { "userIds": [ "123456789012" ] } } } ] }

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar create-image-pipeline.

AWS CLI

Para criar um pipeline de imagens

O create-image-pipeline exemplo a seguir cria um pipeline de imagens usando um JSON arquivo.

aws imagebuilder create-image-pipeline \ --cli-input-json file://create-image-pipeline.json

Conteúdo de create-image-pipeline.json:

{ "name": "MyWindows2016Pipeline", "description": "Builds Windows 2016 Images", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 60 }, "schedule": { "scheduleExpression": "cron(0 0 * * SUN)", "pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE" }, "status": "ENABLED" }

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar create-image-recipe.

AWS CLI

Para criar uma receita

O create-image-recipe exemplo a seguir cria uma receita de imagem usando um JSON arquivo. Os componentes são instalados na ordem em que são especificados.

aws imagebuilder create-image-recipe \ --cli-input-json file://create-image-recipe.json

Conteúdo de create-image-recipe.json:

{ "name": "MyBasicRecipe", "description": "This example image recipe creates a Windows 2016 image.", "semanticVersion": "2019.12.03", "components": [ { "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1" }, { "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myimportedcomponent/1.0.0/1" } ], "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/xxxx.x.x" }

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte CreateImageRecipena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-image.

AWS CLI

Para criar uma imagem

O create-image exemplo a seguir cria uma imagem.

aws imagebuilder create-image \ --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03 \ --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte CreateImagena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-infrastructure-configuration.

AWS CLI

Para criar uma configuração de infraestrutura

O create-infrastructure-configuration exemplo a seguir cria uma configuração de infraestrutura usando um JSON arquivo.

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

Conteúdo de create-infrastructure-configuration.json:

{ "name": "MyExampleInfrastructure", "description": "An example that will retain instances of failed builds", "instanceTypes": [ "m5.large", "m5.xlarge" ], "instanceProfileName": "EC2InstanceProfileForImageBuilder", "securityGroupIds": [ "sg-a1b2c3d4" ], "subnetId": "subnet-a1b2c3d4", "logging": { "s3Logs": { "s3BucketName": "bucket-name", "s3KeyPrefix": "bucket-path" } }, "keyPair": "key-pair-name", "terminateInstanceOnFailure": false, "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-topic-name" }

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar delete-component.

AWS CLI

Para excluir um componente

O delete-component exemplo a seguir exclui uma versão de compilação do componente especificando sua. ARN

aws imagebuilder delete-component \ --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte DeleteComponentna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-image-pipeline.

AWS CLI

Para excluir um pipeline de imagens

O delete-image-pipeline exemplo a seguir exclui um pipeline de imagem especificando seu. ARN

aws imagebuilder delete-image-pipeline \ --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar delete-image-recipe.

AWS CLI

Para excluir uma receita de imagem

O delete-image-recipe exemplo a seguir exclui uma receita de imagem especificando sua. ARN

aws imagebuilder delete-image-recipe \ --image-recipe-arn arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/mybasicrecipe/2019.12.03

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte DeleteImageRecipena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-image.

AWS CLI

Para excluir uma imagem

O delete-image exemplo a seguir exclui uma versão de criação de imagem especificando sua. ARN

aws imagebuilder delete-image \ --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.02/1

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte DeleteImagena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-infrastructure-configuration.

AWS CLI

Para excluir uma configuração de infraestrutura

O delete-infrastructure-configuration exemplo a seguir exclui um pipeline de imagem especificando seu. ARN

aws imagebuilder delete-infrastructure-configuration \ --infrastructure-configuration-arn arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/myexampleinfrastructure

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar get-component-policy.

AWS CLI

Para obter detalhes da política de componentes

O get-component-policy exemplo a seguir lista os detalhes de uma política de componentes especificando suaARN.

aws imagebuilder get-component-policy \ --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.03/1

Saída:

{ "Policy": "{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetComponent", "imagebuilder:ListComponents" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.03/1" ] } ] }" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de imagem do EC2 Image Builder usando o AWS CLI < https://docs.aws.amazon.com/imagebuilder/ latest/userguide/managing - image-builder-cli .html>`__ no Guia do usuário do Image BuilderEC2.

O código de exemplo a seguir mostra como usar get-component.

AWS CLI

Para obter detalhes do componente

O get-component exemplo a seguir lista os detalhes de um componente especificando seuARN.

aws imagebuilder get-component \ --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0/1

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "component": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0/1", "name": "component-name", "version": "1.0.0", "type": "TEST", "platform": "Linux", "owner": "123456789012", "data": "name: HelloWorldTestingDocument\ndescription: This is hello world testing document.\nschemaVersion: 1.0\n\nphases:\n - name: test\n steps:\n - name: HelloWorldStep\n action: ExecuteBash\n inputs:\n commands:\n - echo \"Hello World! Test.\"\n", "encrypted": true, "dateCreated": "2020-01-27T20:43:30.306Z", "tags": {} } }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte GetComponentna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-distribution-configuration.

AWS CLI

Para obter os detalhes de uma configuração de distribuição

O get-distribution-configuration exemplo a seguir exibe os detalhes de uma configuração de distribuição especificando suaARN.

aws imagebuilder get-distribution-configuration \ --distribution-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "distributionConfiguration": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "name": "MyExampleDistribution", "description": "Copies AMI to eu-west-1 and exports to S3", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "Name {{imagebuilder:buildDate}}", "description": "An example image name with parameter references", "amiTags": { "KeyName": "{{ssm:parameter_name}}" }, "launchPermission": { "userIds": [ "123456789012" ] } } }, { "region": "eu-west-1", "amiDistributionConfiguration": { "name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}", "amiTags": { "KeyName": "Value" }, "launchPermission": { "userIds": [ "123456789012" ] } } } ], "dateCreated": "2020-02-19T18:40:10.529Z", "tags": {} } }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar get-image-pipeline.

AWS CLI

Para obter detalhes do pipeline de imagens

O get-image-pipeline exemplo a seguir lista os detalhes de um pipeline de imagem especificando seuARN.

aws imagebuilder get-image-pipeline \ --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imagePipeline": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "name": "MyWindows2016Pipeline", "description": "Builds Windows 2016 Images", "platform": "Windows", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 60 }, "schedule": { "scheduleExpression": "cron(0 0 * * SUN)", "pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE" }, "status": "ENABLED", "dateCreated": "2020-02-19T19:04:01.253Z", "dateUpdated": "2020-02-19T19:04:01.253Z", "tags": {} } }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte GetImagePipelinena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-image-policy.

AWS CLI

Para obter detalhes da política de imagem

O get-image-policy exemplo a seguir lista os detalhes de uma política de imagem especificando suaARN.

aws imagebuilder get-image-policy \ --image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1

Saída:

{ "Policy": "{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImage", "imagebuilder:ListImages" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1" ] } ] }" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte GetImagePolicyna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-image-recipe-policy.

AWS CLI

Para obter detalhes da política de receitas de imagens

O get-image-recipe-policy exemplo a seguir lista os detalhes de uma política de receitas de imagens especificando suaARN.

aws imagebuilder get-image-recipe-policy \ --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-example-image-recipe/2019.12.03/1

Saída:

{ "Policy": "{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImageRecipe", "imagebuilder:ListImageRecipes" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-example-image-recipe/2019.12.03/1" ] } ] }" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar get-image.

AWS CLI

Para obter detalhes da imagem

O get-image exemplo a seguir lista os detalhes de uma imagem especificando suaARN.

aws imagebuilder get-image \ --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "image": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1", "name": "MyBasicRecipe", "version": "2019.12.03/1", "platform": "Windows", "state": { "status": "BUILDING" }, "imageRecipe": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "name": "MyBasicRecipe", "description": "This example image recipe creates a Windows 2016 image.", "platform": "Windows", "version": "2019.12.03", "components": [ { "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1" }, { "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myimportedcomponent/1.0.0/1" } ], "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/2019.12.17/1", "dateCreated": "2020-02-14T19:46:16.904Z", "tags": {} }, "infrastructureConfiguration": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "name": "MyExampleInfrastructure", "description": "An example that will retain instances of failed builds", "instanceTypes": [ "m5.large", "m5.xlarge" ], "instanceProfileName": "EC2InstanceProfileForImageFactory", "securityGroupIds": [ "sg-a1b2c3d4" ], "subnetId": "subnet-a1b2c3d4", "logging": { "s3Logs": { "s3BucketName": "bucket-name", "s3KeyPrefix": "bucket-path" } }, "keyPair": "Sam", "terminateInstanceOnFailure": false, "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-name", "dateCreated": "2020-02-14T21:21:05.098Z", "tags": {} }, "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 720 }, "dateCreated": "2020-02-14T23:14:13.597Z", "outputResources": { "amis": [] }, "tags": {} } }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte GetImagena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-infrastructure-configuration.

AWS CLI

Para obter detalhes da configuração da infraestrutura

O get-infrastructure-configuration exemplo a seguir lista os detalhes de uma configuração de infraestrutura especificando suaARN.

aws imagebuilder get-infrastructure-configuration \ --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "infrastructureConfiguration": { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "name": "MyExampleInfrastructure", "description": "An example that will retain instances of failed builds", "instanceTypes": [ "m5.large", "m5.xlarge" ], "instanceProfileName": "EC2InstanceProfileForImageBuilder", "securityGroupIds": [ "sg-a48c95ef" ], "subnetId": "subnet-a48c95ef", "logging": { "s3Logs": { "s3BucketName": "bucket-name", "s3KeyPrefix": "bucket-path" } }, "keyPair": "Name", "terminateInstanceOnFailure": false, "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-name", "dateCreated": "2020-02-19T19:11:51.858Z", "tags": {} } }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar import-component.

AWS CLI

Para importar um componente

O import-component exemplo a seguir importa um script preexistente usando um JSON arquivo.

aws imagebuilder import-component \ --cli-input-json file://import-component.json

Conteúdo de import-component.json:

{ "name": "MyImportedComponent", "semanticVersion": "1.0.0", "description": "An example of how to import a component", "changeDescription": "First commit message.", "format": "SHELL", "platform": "Windows", "type": "BUILD", "uri": "s3://s3-bucket-name/s3-bucket-path/component.yaml" }

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myimportedcomponent/1.0.0/1" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte ImportComponentna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-component-build-versions.

AWS CLI

Para listar as versões de compilação de componentes

O list-component-build-versions exemplo a seguir lista as versões de construção do componente com uma versão semântica específica.

aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "componentSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1", "name": "MyExampleComponent", "version": "2019.12.02", "platform": "Windows", "type": "BUILD", "owner": "123456789012", "description": "An example component that builds, validates and tests an image", "changeDescription": "Initial version.", "dateCreated": "2020-02-19T18:53:45.940Z", "tags": { "KeyName": "KeyValue" } } ] }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar list-components.

AWS CLI

Para listar todas as versões semânticas do componente

O list-components exemplo a seguir lista todas as versões semânticas do componente às quais você tem acesso. Opcionalmente, você pode filtrar se deseja listar componentes de sua propriedade, da Amazon ou que foram compartilhados com você por outras contas.

aws imagebuilder list-components

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "componentVersionList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0", "name": "component-name", "version": "1.0.0", "platform": "Linux", "type": "TEST", "owner": "123456789012", "dateCreated": "2020-01-27T20:43:30.306Z" } ] }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte ListComponentsna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-distribution-configurations.

AWS CLI

Para listar distribuições

O list-distribution-configurations exemplo a seguir lista todas as suas distribuições.

aws imagebuilder list-distribution-configurations

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "distributionConfigurationSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "name": "MyExampleDistribution", "description": "Copies AMI to eu-west-1 and exports to S3", "dateCreated": "2020-02-19T18:40:10.529Z", "tags": { "KeyName": "KeyValue" } } ] }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar list-image-build-versions.

AWS CLI

Para listar as versões de criação de imagens

O list-image-build-versions exemplo a seguir lista todas as versões de criação de imagem com uma versão semântica.

aws imagebuilder list-image-build-versions \ --image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/7", "name": "MyBasicRecipe", "version": "2019.12.03/7", "platform": "Windows", "state": { "status": "FAILED", "reason": "Can't start SSM Automation for arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/7 during building. Parameter \"iamInstanceProfileName\" has a null value." }, "owner": "123456789012", "dateCreated": "2020-02-19T18:56:11.511Z", "outputResources": { "amis": [] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/6", "name": "MyBasicRecipe", "version": "2019.12.03/6", "platform": "Windows", "state": { "status": "FAILED", "reason": "An internal error has occurred." }, "owner": "123456789012", "dateCreated": "2020-02-18T22:49:08.142Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "MyBasicRecipe 2020-02-18T22-49-38.704Z", "description": "This example image recipe creates a Windows 2016 image." }, { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "Name 2020-02-18T22-49-08.131Z", "description": "Copies AMI to eu-west-2 and exports to S3" }, { "region": "eu-west-2", "image": "ami-a1b2c3d4567890ab", "name": "My 6 image 2020-02-18T22-49-08.131Z", "description": "Copies AMI to eu-west-2 and exports to S3" } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/5", "name": "MyBasicRecipe", "version": "2019.12.03/5", "platform": "Windows", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2020-02-18T16:51:48.403Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "MyBasicRecipe 2020-02-18T16-52-18.965Z", "description": "This example image recipe creates a Windows 2016 image." } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/4", "name": "MyBasicRecipe", "version": "2019.12.03/4", "platform": "Windows", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2020-02-18T16:50:01.827Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "MyBasicRecipe 2020-02-18T16-50-32.280Z", "description": "This example image recipe creates a Windows 2016 image." } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/3", "name": "MyBasicRecipe", "version": "2019.12.03/3", "platform": "Windows", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2020-02-14T23:14:13.597Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-a1b2c3d4567890ab", "name": "MyBasicRecipe 2020-02-14T23-14-44.243Z", "description": "This example image recipe creates a Windows 2016 image." } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/2", "name": "MyBasicRecipe", "version": "2019.12.03/2", "platform": "Windows", "state": { "status": "FAILED", "reason": "SSM execution 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111' failed with status = 'Failed' and failure message = 'Step fails when it is verifying the command has completed. Command a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 returns unexpected invocation result: \n{Status=[Failed], ResponseCode=[1], Output=[\n----------ERROR-------\nfailed to run commands: exit status 1], OutputPayload=[{\"Status\":\"Failed\",\"ResponseCode\":1,\"Output\":\"\\n----------ERROR-------\\nfailed to run commands: exit status 1\",\"CommandId\":\"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\"}], CommandId=[a1b2c3d4-5678-90ab-cdef-EXAMPLE11111]}. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.'" }, "owner": "123456789012", "dateCreated": "2020-02-14T22:57:42.593Z", "outputResources": { "amis": [] }, "tags": {} } ] }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar list-image-pipeline-images.

AWS CLI

Para listar imagens do pipeline de imagens

O list-image-pipeline-images exemplo a seguir lista todas as imagens que foram criadas por um pipeline de imagens específico.

aws imagebuilder list-image-pipeline-images \ --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imagePipelineList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "name": "MyWindows2016Pipeline", "description": "Builds Windows 2016 Images", "platform": "Windows", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 60 }, "schedule": { "scheduleExpression": "cron(0 0 * * SUN)", "pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE" }, "status": "ENABLED", "dateCreated": "2020-02-19T19:04:01.253Z", "dateUpdated": "2020-02-19T19:04:01.253Z", "tags": { "KeyName": "KeyValue" } }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/sam", "name": "PipelineName", "platform": "Linux", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/recipe-name-a1b2c3d45678/1.0.0", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/infrastructureconfiguration-name-a1b2c3d45678", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 720 }, "status": "ENABLED", "dateCreated": "2019-12-16T18:19:02.068Z", "dateUpdated": "2019-12-16T18:19:02.068Z", "tags": { "KeyName": "KeyValue" } } ] }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar list-image-recipes.

AWS CLI

Para listar receitas de imagens

O list-image-recipes exemplo a seguir lista todas as suas receitas de imagens.

aws imagebuilder list-image-recipes

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageRecipeSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "name": "MyBasicRecipe", "platform": "Windows", "owner": "123456789012", "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/2019.x.x", "dateCreated": "2020-02-19T18:54:25.975Z", "tags": { "KeyName": "KeyValue" } }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/recipe-name-a1b2c3d45678/1.0.0", "name": "recipe-name-a1b2c3d45678", "platform": "Linux", "owner": "123456789012", "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/amazon-linux-2-x86/2019.11.21", "dateCreated": "2019-12-16T18:19:00.120Z", "tags": { "KeyName": "KeyValue" } } ] }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte ListImageRecipesna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-images.

AWS CLI

Para listar imagens

O list-images exemplo a seguir lista todas as versões semânticas às quais você tem acesso.

aws imagebuilder list-images

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageVersionList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03", "name": "MyBasicRecipe", "version": "2019.12.03", "platform": "Windows", "owner": "123456789012", "dateCreated": "2020-02-14T21:29:18.810Z" } ] }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte ListImagesna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-infrastructure-configurations.

AWS CLI

Para listar as configurações de infraestrutura

O list-infrastructure-configurations exemplo a seguir lista todas as suas configurações de infraestrutura.

aws imagebuilder list-infrastructure-configurations

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "infrastructureConfigurationSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "name": "MyExampleInfrastructure", "description": "An example that will retain instances of failed builds", "dateCreated": "2020-02-19T19:11:51.858Z", "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/infrastructureconfiguration-name-a1b2c3d45678", "name": "infrastructureConfiguration-name-a1b2c3d45678", "dateCreated": "2019-12-16T18:19:01.038Z", "tags": { "KeyName": "KeyValue" } } ] }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar list-tags-for-resource.

AWS CLI

Para listar tags para um recurso específico

O list-tags-for-resource exemplo a seguir lista todas as tags de um recurso específico.

aws imagebuilder list-tags-for-resource \ --resource-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline

Saída:

{ "tags": { "KeyName": "KeyValue" } }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar put-component-policy.

AWS CLI

Para aplicar uma política de recursos a um componente

O put-component-policy comando a seguir aplica uma política de recursos a um componente de compilação para permitir o compartilhamento entre contas de componentes de compilação. Recomendamos que você use o RAM CLI comandocreate-resource-share. Se você usar o CLI comando EC2 Image Builderput-component-policy, também deverá usar o RAM CLI comando promote-resource-share-create-from-policy para que o recurso fique visível para todos os diretores com quem o recurso é compartilhado.

aws imagebuilder put-component-policy \ --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1 \ --policy '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetComponent", "imagebuilder:ListComponents" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1" ] } ] }'

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar put-image-policy.

AWS CLI

Para aplicar uma política de recursos a uma imagem

O put-image-policy comando a seguir aplica uma política de recursos a uma imagem para permitir o compartilhamento de imagens entre contas. Recomendamos que você use o RAM CLI comando create-resource-share. Se você usar o CLI comando EC2 Image Builder put-image-policy, também deverá usar o RAM CLI comando promote-resource-share-create -from-policy para que o recurso fique visível para todos os diretores com quem o recurso é compartilhado.

aws imagebuilder put-image-policy \ --image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1 \ --policy '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImage", "imagebuilder:ListImages" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1" ] } ] }'

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte PutImagePolicyna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar put-image-recipe-policy.

AWS CLI

Para aplicar uma política de recursos a uma receita de imagem

O put-image-recipe-policy comando a seguir aplica uma política de recursos a uma receita de imagem para permitir o compartilhamento entre contas de receitas de imagens. Recomendamos que você use o RAM CLI comandocreate-resource-share. Se você usar o CLI comando EC2 Image Builderput-image-recipe-policy, também deverá usar o RAM CLI comando promote-resource-share-create-from-policy para que o recurso fique visível para todos os diretores com quem o recurso é compartilhado.

aws imagebuilder put-image-recipe-policy \ --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02 \ --policy '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImageRecipe", "imagebuilder:ListImageRecipes" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02" ] } ] }'

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02/1" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar start-image-pipeline-execution.

AWS CLI

Para iniciar um pipeline de imagens manualmente

O start-image-pipeline-execution exemplo a seguir inicia manualmente um pipeline de imagens.

aws imagebuilder start-image-pipeline-execution \ --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar tag-resource.

AWS CLI

Para marcar um recurso

O tag-resource exemplo a seguir adiciona e marca um recurso no EC2 Image Builder usando um JSON arquivo.

aws imagebuilder tag-resource \ --cli-input-json file://tag-resource.json

Conteúdo de tag-resource.json:

{ "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "tags": { "KeyName: "KeyValue" } }

Este comando não produz saída.

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte TagResourcena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar untag-resource.

AWS CLI

Para remover uma tag de um recurso

O untag-resource exemplo a seguir remove uma tag de um recurso usando um JSON arquivo.

aws imagebuilder untag-resource \ --cli-input-json file://tag-resource.json

Conteúdo de untag-resource.json:

{ "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "tagKeys": [ "KeyName" ] }

Este comando não produz saída.

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

  • Para API obter detalhes, consulte UntagResourcena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-distribution-configuration.

AWS CLI

Para atualizar uma configuração de distribuição

O update-distribution-configuration exemplo a seguir atualiza uma configuração de distribuição usando um JSON arquivo.

aws imagebuilder update-distribution-configuration \ --cli-input-json file://update-distribution-configuration.json

Conteúdo de update-distribution-configuration.json:

{ "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "description": "Copies AMI to eu-west-2 and exports to S3", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "Name {{imagebuilder:buildDate}}", "description": "An example image name with parameter references" } }, { "region": "eu-west-2", "amiDistributionConfiguration": { "name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}" } } ] }

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar update-image-pipeline.

AWS CLI

Para atualizar um pipeline de imagens

O update-image-pipeline exemplo a seguir atualiza um pipeline de imagem usando um JSON arquivo.

aws imagebuilder update-image-pipeline \ --cli-input-json file://update-image-pipeline.json

Conteúdo de update-image-pipeline.json:

{ "imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline", "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 120 }, "schedule": { "scheduleExpression": "cron(0 0 * * MON)", "pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE" }, "status": "DISABLED" }

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.

O código de exemplo a seguir mostra como usar update-infrastructure-configuration.

AWS CLI

Para atualizar uma configuração de infraestrutura

O update-infrastructure-configuration exemplo a seguir atualiza uma configuração de infraestrutura usando um JSON arquivo.

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

Conteúdo de update-infrastructure-configuration.json:

{ "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure", "description": "An example that will terminate instances of failed builds", "instanceTypes": [ "m5.large", "m5.2xlarge" ], "instanceProfileName": "EC2InstanceProfileForImageFactory", "securityGroupIds": [ "sg-a48c95ef" ], "subnetId": "subnet-a48c95ef", "logging": { "s3Logs": { "s3BucketName": "bucket-name", "s3KeyPrefix": "bucket-path" } }, "terminateInstanceOnFailure": true, "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-name" }

Saída:

{ "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

Para obter mais informações, consulte Configurando e gerenciando um pipeline de EC2 imagem do Image Builder usando o AWS CLI no Guia do EC2 Usuário do Image Builder.