View a markdown version of this page

Atualize os pipelines de imagens do contêiner a partir do AWS CLI - 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á.

Atualize os pipelines de imagens do contêiner a partir do AWS CLI

Você pode atualizar um pipeline de imagens de contêiner usando um arquivo JSON como entrada para o comando update-image-pipeline na AWS CLI. Para configurar o arquivo JSON, você deve ter nomes do recurso da Amazon (ARNs) para referenciar os seguintes recursos existentes:

  • Pipeline de imagens a ser atualizado

  • Fórmula do contêiner

  • Configuração de infraestrutura

  • Configurações de distribuição (se incluídas no pipeline atual)

nota

Se o recurso de configurações de distribuição estiver incluído, o repositório ECR especificado como repositório de destino nas configurações de distribuição da região em que o comando é executado (Região 1) terá precedência sobre o repositório de destino especificado na fórmula do contêiner.

Siga estas etapas para atualizar um pipeline de imagem de contêiner usando o comando update-image-pipeline na AWS CLI:

nota

O update-image-pipeline comando substitui toda a configuração do pipeline. Você deve especificar todas as propriedades necessárias na solicitação de atualização. Inclua todas as propriedades — tanto as propriedades que você deseja alterar quanto as propriedades que devem permanecer as mesmas. As propriedades que você omite são redefinidas para os valores padrão ou são removidas.

Para evitar a remoção não intencional das configurações existentes, use o get-image-pipeline comando para recuperar a configuração atual. Em seguida, modifique somente os campos que você deseja alterar:

aws imagebuilder get-image-pipeline --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-container-pipeline

Use a saída como base para seu arquivo JSON de solicitação de atualização.

  1. Criar um arquivo JSON de entrada da CLI

    Use a sua ferramenta favorita de edição de arquivos para criar um arquivo JSON com as chaves a seguir, além de valores válidos para seu ambiente. Este exemplo usa um arquivo denominado create-component.json:

    {
	"imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline",
	"containerRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-example-recipe/2020.12.08",
	"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/my-example-distribution-configuration",
	"imageTestsConfiguration": {
		"imageTestsEnabled": true,
		"timeoutMinutes": 120
	},
	"schedule": {
		"scheduleExpression": "cron(0 0 * * MON *)",
		"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
	},
	"status": "DISABLED"
}
    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 (/).

  2. Execute o seguinte comando, usando o arquivo que você criou como entrada.

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