本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立和更新容器映像的分佈設定
<a name="cr-upd-container-distribution-settings"></a>

本節涵蓋建立和更新映像建置器容器映像的分佈設定。

**Topics**
+ [從 建立映像建置器容器映像的分佈設定 AWS CLI](#cli-create-container-distribution-configuration)
+ [從 更新容器映像的分佈設定 AWS CLI](#cli-update-container-distribution-configuration)

## 從 建立映像建置器容器映像的分佈設定 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>

下列範例說明如何使用 **[update-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)**命令來更新容器映像的分佈設定 AWS CLI。您也可以更新每個區域中容器映像的標籤。

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)一節。