Criar e atualizar configurações de distribuição para imagens de contêiner - EC2Image 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 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 JSON arquivo CLI de entrada

    Use sua ferramenta de edição de arquivos favorita para criar um JSON arquivo 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

    • Você deve incluir a file:// notação no início do caminho do JSON arquivo.

    • O caminho para o JSON arquivo deve seguir a convenção apropriada para o sistema operacional básico em que 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 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 JSON arquivo CLI de entrada

    Use sua ferramenta de edição de arquivos favorita para criar um JSON arquivo 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

    • Você deve incluir a file:// notação no início do caminho do JSON arquivo.

    • O caminho para o JSON arquivo deve seguir a convenção apropriada para o sistema operacional básico em que 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.