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

# Menandai ulang gambar di Amazon ECR
<a name="image-retag"></a>

Dengan citra Docker Image Manifest V2 Skema 2, Anda dapat menggunakan opsi `--image-tag` printah **put-image** untuk menandai ulang citra yang tersedia. Anda dapat menandai ulang tanpa menarik atau mendorong citra dengan Docker. Untuk citra yang lebih besar, proses ini menghemat sejumlah besar bandwidth jaringan dan waktu yang diperlukan untuk menandai ulang citra.

## Untuk menandai ulang citra (AWS CLI)
<a name="retag-aws-cli"></a>

**Untuk menandai ulang gambar dengan AWS CLI**

1. Gunakan **batch-get-image** perintah untuk mendapatkan manifes gambar untuk gambar untuk retag dan menulis ke file. Dalam contoh ini, manifes untuk gambar dengan tag*latest*,, di repositori*amazonlinux*, ditulis ke variabel lingkungan bernama. *MANIFEST*

   ```
   MANIFEST=$(aws ecr batch-get-image --repository-name amazonlinux --image-ids imageTag=latest --output text --query 'images[].imageManifest')
   ```

1. Gunakan opsi `--image-tag` perintah **put-image** untuk menempatkan manifes citra ke Amazon ECR dengan tanda baru. Dalam contoh ini, gambar ditandai sebagai*2017.03*.
**catatan**  
Jika `--image-tag` opsi tidak tersedia di versi Anda AWS CLI, tingkatkan ke versi terbaru. Untuk informasi selengkapnya, lihat [Menginstal AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) dalam *Panduan Pengguna AWS Command Line Interface *.

   ```
   aws ecr put-image --repository-name amazonlinux --image-tag 2017.03 --image-manifest "$MANIFEST"
   ```

1. Verifikasi bahwa tanda citra baru Anda terpasang pada citra Anda. Pada output berikut, citra memiliki tanda `latest` dan ` 2017.03`.

   ```
   aws ecr describe-images --repository-name amazonlinux
   ```

   Outputnya adalah sebagai berikut:

   ```
   {
       "imageDetails": [
           {
               "imageSizeInBytes": 98755613,
               "imageDigest": "sha256:8d00af8f076eb15a33019c2a3e7f1f655375681c4e5be157a26EXAMPLE",
               "imageTags": [
                   "latest",
                   "2017.03"
               ],
               "registryId": "aws_account_id",
               "repositoryName": "amazonlinux",
               "imagePushedAt": 1499287667.0
           }
       ]
   }
   ```

## Untuk menandai ulang citra (AWS Tools for Windows PowerShell)
<a name="retag-powershell"></a>

**Untuk menandai ulang gambar dengan AWS Tools for Windows PowerShell**

1. Gunakan **Get-ECRImageBatch** **cmdlet** untuk mendapatkan deskripsi gambar untuk retag dan menuliskannya ke variabel lingkungan. Dalam contoh ini, gambar dengan tag,* latest*, di repositori*amazonlinux*, ditulis ke variabel lingkungan,. *\$1Image*
**catatan**  
Jika Anda tidak memiliki yang **Get-ECRImageBatch** ** cmdlet** tersedia di sistem Anda, lihat [Menyiapkan AWS Tools for Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) di *Panduan Alat AWS untuk PowerShell Pengguna*.

   ```
   $Image = Get-ECRImageBatch -ImageId @{ imageTag="latest" } -RepositoryName amazonlinux
   ```

1. Tulis manifes gambar ke variabel *\$1Manifest* lingkungan.

   ```
   $Manifest = $Image.Images[0].ImageManifest
   ```

1. Gunakan `-ImageTag` opsi **Write-ECRImage** ** cmdlet** untuk menempatkan manifes gambar ke Amazon ECR dengan tag baru. Dalam contoh ini, gambar ditandai sebagai*2017.09*.

   ```
   Write-ECRImage -RepositoryName amazonlinux -ImageManifest $Manifest -ImageTag 2017.09
   ```

1. Verifikasi bahwa tanda citra baru Anda terpasang pada citra Anda. Pada output berikut, citra memiliki tanda `latest` dan ` 2017.09`.

   ```
   Get-ECRImage -RepositoryName amazonlinux
   ```

   Output adalah sebagai berikut:

   ```
   ImageDigest                                                             ImageTag
   -----------                                                             --------
   sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 latest
   sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 2017.09
   ```