

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Membuat dan memperbarui pengaturan distribusi untuk gambar kontainer
<a name="cr-upd-container-distribution-settings"></a>

Bagian ini mencakup pembuatan dan pembaruan pengaturan distribusi untuk image kontainer Image Builder.

**Topics**
+ [Buat pengaturan distribusi untuk gambar kontainer Image Builder dari AWS CLI](#cli-create-container-distribution-configuration)
+ [Perbarui pengaturan distribusi untuk gambar kontainer Anda dari AWS CLI](#cli-update-container-distribution-configuration)

## Buat pengaturan distribusi untuk gambar kontainer Image Builder dari AWS CLI
<a name="cli-create-container-distribution-configuration"></a>

Konfigurasi distribusi memungkinkan Anda menentukan nama dan deskripsi gambar kontainer keluaran Anda dan mereplikasi gambar kontainer ke AWS Wilayah lain. Anda juga dapat menerapkan tag terpisah ke sumber daya konfigurasi distribusi dan ke gambar kontainer di setiap Wilayah.

1. 

**Buat file JSON input CLI**

   Gunakan alat pengeditan file favorit Anda untuk membuat file JSON dengan kunci yang ditunjukkan pada contoh berikut, ditambah nilai yang valid untuk lingkungan Anda. Contoh ini menggunakan file bernama `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. 

**Jalankan perintah berikut, menggunakan file yang Anda buat sebagai input.**

   ```
   aws imagebuilder create-distribution-configuration --cli-input-json file://create-container-distribution-configuration.json
   ```
**catatan**  
Anda harus menyertakan notasi `file://` pada awal jalur file JSON.
Jalur untuk file JSON harus mengikuti konvensi yang sesuai untuk sistem operasi dasar tempat Anda menjalankan perintah. Misalnya, Windows menggunakan garis miring terbalik (\$1) untuk merujuk ke jalur direktori, sedangkan Linux dan macOS menggunakan garis miring maju (/).

   Untuk informasi lebih rinci, lihat **[create-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)** di *AWS CLI Command Reference*.

## Perbarui pengaturan distribusi untuk gambar kontainer Anda dari AWS CLI
<a name="cli-update-container-distribution-configuration"></a>

Contoh berikut menunjukkan cara menggunakan **[update-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)** perintah untuk memperbarui pengaturan distribusi untuk gambar kontainer Anda, menggunakan AWS CLI. Anda juga dapat memperbarui tag untuk gambar kontainer di setiap Wilayah.

1. 

**Buat file JSON input CLI**

   Gunakan alat pengeditan file favorit Anda untuk membuat file JSON dengan kunci yang ditunjukkan pada contoh berikut, ditambah nilai yang valid untuk lingkungan Anda. Contoh ini menggunakan file bernama `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. 

**Jalankan perintah berikut, menggunakan file yang Anda buat sebagai input:**

   ```
   aws imagebuilder update-distribution-configuration --cli-input-json file://update-container-distribution-configuration.json
   ```
**catatan**  
Anda harus menyertakan notasi `file://` pada awal jalur file JSON.
Jalur untuk file JSON harus mengikuti konvensi yang sesuai untuk sistem operasi dasar tempat Anda menjalankan perintah. Misalnya, Windows menggunakan garis miring terbalik (\$1) untuk merujuk ke jalur direktori, sedangkan Linux dan macOS menggunakan garis miring maju (/).

   Untuk informasi lebih rinci, lihat **[update-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)** di *AWS CLI Command Reference*. Untuk memperbarui tag untuk sumber daya konfigurasi distribusi Anda, lihat [Memberi tanda pada sumber daya](tag-resources.md) bagian.