Criar e atualizar configurações de distribuição para imagens de contêiner - EC2 Image Builder
Crie configurações de distribuição para imagens de contêiner do Image Builder a partir do AWS CLIAtualize as configurações de distribuição da imagem do seu contêiner a partir do AWS CLI

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

Criar e atualizar configurações de distribuição para imagens de contêiner

Esta seção aborda a criação e a atualização de configurações de distribuição de imagens de contêiner do Image Builder.

Crie configurações de distribuição para imagens de contêiner do Image Builder a partir do AWS CLI

Uma configuração de distribuição permite que você especifique o nome e a descrição da imagem do contêiner de saída e replique a imagem do contêiner para outras AWS regiões. Você também pode aplicar tags separadas ao recurso de configuração de distribuição e às imagens do contêiner em cada região.

  1. Criar um arquivo JSON de entrada da CLI

    Use a sua ferramenta de edição de arquivos favorita 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 create-container-distribution-configuration.json:

    {
	"name": "distribution-configuration-name",
	"description": "Distributes container image to Amazon ECR repository in two regions.",
	"distributions": [
	    {
	        "region": "us-west-2",
	        "containerDistributionConfiguration": {
	            "description": "My test image.",
	            "targetRepository": {
	                "service": "ECR",
	                "repositoryName": "testrepo"
	            },
	            "containerTags": ["west2", "image1"]
	        }
	    },
	    {
	        "region": "us-east-1",
	        "containerDistributionConfiguration": {
	            "description": "My test image.",
	            "targetRepository": {
	                "service": "ECR",
	                "repositoryName": "testrepo"
	            },
	           "containerTags": ["east1", "imagedist"]
	        }
	    }
	],
	"tags": {
	   "DistributionConfigurationTestTagKey1": "DistributionConfigurationTestTagValue1",
	   "DistributionConfigurationTestTagKey2": "DistributionConfigurationTestTagValue2"
	}
}
  2. Execute o seguinte comando, usando o arquivo que você criou como entrada.
    aws imagebuilder create-distribution-configuration --cli-input-json file://create-container-distribution-configuration.json
    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 (/).

    Para obter mais informações detalhadas, consulte create-distribution-configuration na Referência de comandos da AWS CLI .

Atualize as configurações de distribuição da imagem do seu contêiner a partir do AWS CLI

O exemplo a seguir mostra como usar o comando update-distribution-configuration para atualizar as configurações de distribuição da imagem de contêiner usando a AWS CLI. Você também pode atualizar as tags das imagens de contêiner em cada região.

  1. Criar um arquivo JSON de entrada da CLI

    Use a sua ferramenta de edição de arquivos favorita 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-container-distribution-configuration.json:

    {
    "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/update-container-distribution-configuration.json",
	"description": "Distributes container image to Amazon ECR repository in two regions.",
	"distributions": [
	    {
	        "region": "us-west-2",
	        "containerDistributionConfiguration": {
	            "description": "My test image.",
	            "targetRepository": {
	                "service": "ECR",
	                "repositoryName": "testrepo"
	            },
	            "containerTags": ["west2", "image1"]
	        }
	    },
	    {
	        "region": "us-east-2",
	        "containerDistributionConfiguration": {
	            "description": "My test image.",
	            "targetRepository": {
	                "service": "ECR",
	                "repositoryName": "testrepo"
	            },
	           "containerTags": ["east2", "imagedist"]
	        }
	    }
	]
}
  2. Execute o seguinte comando, usando o arquivo que você criou como entrada:
    aws imagebuilder update-distribution-configuration --cli-input-json file://update-container-distribution-configuration.json
    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 (/).

    Para obter mais informações detalhadas, consulte update-distribution-configuration na Referência de comandos da AWS CLI . Para atualizar as tags do seu recurso de configuração de distribuição, consulte a seção Marcar recursos.