

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

# Isi ulang replikasi
<a name="replication-backfill"></a>

Anda dapat mereplikasi gambar yang sudah ada sebelumnya di registri pribadi Amazon ECR ke tujuan replikasi yang dikonfigurasi. Secara default, replikasi hanya berlaku untuk gambar yang didorong setelah konfigurasi replikasi diterapkan. Isi ulang replikasi memungkinkan Anda mereplikasi gambar yang Anda dorong sebelum mengonfigurasi replikasi.

## Cara kerja pengisian ulang replikasi
<a name="replication-backfill-how-it-works"></a>

Saat memulai pengisian ulang replikasi, Anda menentukan tujuan tunggal yang terdiri dari Region dan ID registri. Amazon ECR mengevaluasi konfigurasi replikasi Anda yang ada untuk menentukan gambar mana di registri Anda yang memenuhi syarat untuk diisi ulang ke tujuan yang ditentukan. Hanya gambar yang sesuai dengan aturan konfigurasi replikasi Anda saat ini yang disertakan dalam isi ulang.

Setiap pengisian ulang replikasi menargetkan satu tujuan. Untuk mengisi ulang gambar ke beberapa tujuan, mulai pengisian ulang replikasi terpisah untuk setiap tujuan. Masing-masing diidentifikasi oleh yang unik `replicationBackfillId` yang Anda gunakan untuk memantau kemajuan, melihat hasil, dan menghentikannya jika diperlukan.

## Siklus hidup pengisian ulang replikasi
<a name="replication-backfill-lifecycle"></a>

Transisi pengisian ulang replikasi melalui status berikut:
+ `PREPARING`: Amazon ECR mengidentifikasi gambar yang memenuhi syarat di registri Anda.
+ `IN_PROGRESS`: Amazon ECR secara aktif mereplikasi gambar ke tujuan.
+ `COMPLETE`: Semua gambar yang memenuhi syarat berhasil direplikasi.
+ `FAILED`: Isi ulang replikasi secara otomatis gagal jika 50% atau lebih dari ulangan yang mendasarinya gagal. Ambang batas ini hanya dievaluasi setelah setidaknya 100 ulangan diproses.
+ `STOPPING`: Pemberhentian diminta dan Amazon ECR sedang menunggu ulangan dalam penerbangan selesai.
+ `STOPPED`: Anda menghentikan pengisian ulang replikasi dan semua ulangan dalam penerbangan telah berakhir.

**catatan**  
Anda dapat menghentikan pengisian ulang replikasi hanya jika ada di `PREPARING` atau `IN_PROGRESS` status.

## Pertimbangan untuk pengisian ulang replikasi
<a name="replication-backfill-considerations"></a>

Berikut ini harus dipertimbangkan saat menggunakan isi ulang replikasi.
+ Hanya gambar yang sesuai dengan konfigurasi replikasi Anda saat ini untuk tujuan yang ditentukan yang disertakan dalam isi ulang. Jika Anda perlu mengisi ulang gambar ke tujuan yang tidak ada dalam konfigurasi replikasi Anda, Anda harus terlebih dahulu menambahkan tujuan tersebut ke aturan replikasi Anda.
+ Anda dapat menjalankan hingga 10 isi ulang replikasi secara bersamaan per registri. Jika Anda memulai lebih banyak, Amazon ECR mengembalikan `LimitExceededException` kesalahan.
+ Anda hanya dapat memiliki satu pengisian ulang replikasi aktif untuk Wilayah tujuan tertentu pada satu waktu. Permintaan kedua untuk Wilayah tujuan yang sama mengembalikan a `ReplicationBackfillInProgressException` kesalahan.
+ Amazon ECR mempertahankan isi ulang replikasi dalam status terminal (`COMPLETE`, `FAILED`, atau `STOPPED`) selama 90 hari setelah selesai. Selama waktu itu, mereka tetap terlihat di `ListReplicationBackfills` tanggapan.
+ Menghentikan pengisian ulang replikasi tidak mengembalikan gambar yang sudah direplikasi. Gambar-gambar tersebut tetap berada di registri tujuan.
+ Isi ulang replikasi menggunakan peran terkait layanan yang sama dengan yang dibuat Amazon ECR saat Anda pertama kali mengonfigurasi replikasi untuk registri pribadi Anda.
+ Sebagian besar pendaftar diharapkan menyelesaikan pengisian ulang dalam waktu satu jam. Namun, registri yang berisi sejumlah besar data dapat memakan waktu berjam-jam atau bahkan berhari-hari untuk mengisi ulang sepenuhnya.
+ Isi ulang replikasi melewatkan gambar yang repositori sumbernya dihapus. Gambar-gambar tersebut muncul dengan `FAILED` status dalam hasil isi ulang.
+ Amazon ECR mengirimkan EventBridge peristiwa ketika pengisian ulang replikasi mencapai status terminal. Untuk informasi selengkapnya, lihat [Contoh kejadian dari Amazon ECR](ecr-eventbridge.md#ecr-eventbridge-bus).

## Memulai pengisian ulang replikasi
<a name="replication-backfill-start"></a>

### Untuk memulai pengisian ulang replikasi (Konsol Manajemen AWS)
<a name="replication-backfill-start-console"></a>

1. Buka konsol Amazon ECR di [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories).

1. Dari bilah navigasi, pilih Wilayah registri sumber untuk diisi ulang.

1. Di panel navigasi, pilih **Pendaftaran pribadi**.

1. Pada **Pendaftaran pribadi** halaman, pilih ** Pengaturan** dan kemudian memilih **Sunting** di bawah **Konfigurasi replikasi**.

1. Pada **Replikasi** halaman, pilih **Lowongan kerja Backfill** tab.

1. Memilih **Mulai pekerjaan pengisian ulang**.

1. Pilih hingga 10 tujuan yang ingin Anda isi ulang.

1. Memilih **Mulai pekerjaan isi ulang**.

### Untuk memulai pengisian ulang replikasi (AWS CLI)
<a name="replication-backfill-start-cli"></a>
+ Mulai pengisian ulang replikasi.

  ```
  aws ecr start-replication-backfill \
      --region {{us-west-2}} \
      --registry-id {{aws_account_id}} \
      --destination region={{destination_region}},registryId={{destination_aws_account_id}}
  ```

## Memantau kemajuan pengisian ulang replikasi dan melihat hasil
<a name="replication-backfill-monitor"></a>

### Untuk memantau kemajuan pengisian ulang replikasi dan melihat hasil pengisian ulang replikasi (Konsol Manajemen AWS)
<a name="replication-backfill-monitor-console"></a>

1. Buka konsol Amazon ECR di [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories).

1. Dari bilah navigasi, pilih Wilayah yang berisi isi ulang replikasi Anda.

1. Di panel navigasi, pilih **Pendaftaran pribadi**.

1. Pada **Pendaftaran pribadi** halaman, pilih ** Pengaturan** dan kemudian memilih **Sunting** di bawah **Konfigurasi replikasi**.

1. Pada **Replikasi** halaman, pilih **Lowongan kerja Backfill** tab untuk memantau kemajuan dan melihat hasil pengisian ulang replikasi Anda.

### Untuk memantau kemajuan pengisian ulang replikasi dan melihat hasil pengisian ulang replikasi (AWS CLI)
<a name="replication-backfill-monitor-cli"></a>

1. Untuk memantau kemajuan atau melihat hasil pengisian ulang replikasi, jalankan perintah berikut. Sementara pengisian ulang replikasi sedang berlangsung, respons hanya berisi jumlah kemajuan. Per-image hasil dan pagination hanya tersedia setelah selesai.

   ```
   aws ecr describe-replication-backfill-results \
       --region {{us-west-2}} \
       --registry-id {{aws_account_id}} \
       --replication-backfill-id {{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}} \
       --max-results 1000 \
       --result-status-filter COMPLETE
   ```

1. Untuk melihat informasi ringkasan dari semua isi ulang replikasi, jalankan perintah berikut.

   ```
   aws ecr list-replication-backfills \
       --region {{us-west-2}} \
       --registry-id {{aws_account_id}} \
       --max-results 50
   ```

## Menghentikan pengisian ulang replikasi
<a name="replication-backfill-stop"></a>

### Untuk menghentikan pengisian ulang replikasi (Konsol Manajemen AWS)
<a name="replication-backfill-stop-console"></a>

1. Buka konsol Amazon ECR di [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories).

1. Dari bilah navigasi, pilih Wilayah yang berisi isi ulang replikasi Anda.

1. Di panel navigasi, pilih **Pendaftaran pribadi**.

1. Pada **Pendaftaran pribadi** halaman, pilih ** Pengaturan** dan kemudian memilih **Sunting** di bawah **Konfigurasi replikasi**.

1. Pada **Replikasi** halaman, pilih **Lowongan kerja Backfill** tab.

1. Pilih isi ulang replikasi yang ingin Anda hentikan.

1. Memilih **Hentikan pekerjaan pengisian ulang**.

### Untuk menghentikan pengisian ulang replikasi (AWS CLI)
<a name="replication-backfill-stop-cli"></a>
+ Untuk menghentikan pengisian ulang replikasi, jalankan perintah berikut.

  ```
  aws ecr stop-replication-backfill \
      --region {{us-west-2}} \
      --registry-id {{aws_account_id}} \
      --replication-backfill-id {{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}}
  ```