本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建和更新容器映像的分配设置
<a name="cr-upd-container-distribution-settings"></a>

本章节介绍如何创建和更新 Image Builder 容器映像的分配设置。

**Topics**
+ [从 Image Builder 容器映像创建分发设置 AWS CLI](#cli-create-container-distribution-configuration)
+ [从中更新容器映像的分发设置 AWS CLI](#cli-update-container-distribution-configuration)

## 从 Image Builder 容器映像创建分发设置 AWS CLI
<a name="cli-create-container-distribution-configuration"></a>

分发配置使您可以指定输出容器映像的名称和描述，并将容器映像复制到其他 AWS 区域。您也可以对分配配置资源和每个区域内的容器映像应用单独的标签。

1. 

**创建 CLI 输入 JSON 文件**

   使用您常用的文件编辑工具创建一个 JSON 文件，其中包含以下示例中显示的密钥，以及对您的环境有效的值。此示例使用名为 `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"
   	}
   }
   ```

1. 

**使用创建的文件作为输入，运行以下命令。**

   ```
   aws imagebuilder create-distribution-configuration --cli-input-json file://{{create-container-distribution-configuration.json}}
   ```
**注意**  
JSON 文件路径开头必须包含 `file://` 符号。
JSON 文件的路径应遵循运行命令的基本操作系统的相应约定。例如，Windows 使用反斜杠 (\\) 引用目录路径，而 Linux 和 macOS 使用正斜杠 (/)。

   有关更多详细信息，请参阅 *AWS CLI 命令参考*中的 **[create-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)**。

## 从中更新容器映像的分发设置 AWS CLI
<a name="cli-update-container-distribution-configuration"></a>

以下示例说明如何采用 AWS CLI使用 **[update-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)** 命令为容器映像创建新的分配配置。您还可以在每个区域内更新容器映像的标签。

1. 

**创建 CLI 输入 JSON 文件**

   使用您常用的文件编辑工具创建一个 JSON 文件，其中包含以下示例所示的密钥以及对您的环境有效的值。此示例使用名为 `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"]
   			}
   		}
   	]
   }
   ```

1. 

**使用创建的文件作为输入，运行以下命令：**

   ```
   aws imagebuilder update-distribution-configuration --cli-input-json file://{{update-container-distribution-configuration.json}}
   ```
**注意**  
JSON 文件路径开头必须包含 `file://` 符号。
JSON 文件的路径应遵循运行命令的基本操作系统的相应约定。例如，Windows 使用反斜杠 (\\) 引用目录路径，而 Linux 和 macOS 使用正斜杠 (/)。

   有关更多详细信息，请参阅 *AWS CLI 命令参考*中的 **[update-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)**。要更新分配配置资源的标签，请参阅 [标记资源](tag-resources.md) 一节。