

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
<a name="cli-update-container-pipeline"></a>

Você pode atualizar um pipeline de imagens de contêiner usando um arquivo JSON como entrada para o comando **[update-image-pipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-image-pipeline.html)** 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 (/).

1. 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}}
   ```