Membuat permintaan ke pendaftar Amazon ECR

Anda dapat mendorong, menarik, menghapus, melihat, dan mengelola gambar OCI, gambar Docker, dan OCI-compatible artefak di pendaftar pribadi Amazon ECR menggunakan IPv4-only endpoint atau dual-stack (IPv4 dan IPv6) endpoint. Untuk membuat permintaan dari jaringan IPv4, Anda dapat menggunakan titik akhir dual-stack atau IPv4. Untuk membuat permintaan dari jaringan IPv6, gunakan endpoint dual-stack. Untuk informasi selengkapnya tentang membuat permintaan ke pendaftar Publik Amazon ECR menggunakan IPv4 dan titik akhir tumpukan ganda, lihat Membuat permintaan ke pendaftar Publik Amazon ECR. Tidak ada biaya tambahan untuk mengakses Amazon ECR melalui IPv6. Untuk informasi selengkapnya tentang harga, lihat harga Amazon Elastic Container Registry.

Endpoint Amazon ECR ditetapkan oleh atribut di luar dukungan IPv4-only endpoint atau dual-stack endpoint. Atribut ini dapat mencakup:

Untuk informasi selengkapnya tentang titik akhir layanan yang didukung oleh klien IPv4, dual-stack, Docker, dan OCI, yang menangani panggilan Amazon ECR API dari AWS CLI dan SDK, lihat, titik akhir Layanan. AWS

Memulai dengan membuat permintaan melalui IPv6

Untuk membuat permintaan ke registri Amazon ECR melalui IPv6, Anda perlu menggunakan endpoint dual-stack. Sebelum mengakses registri Amazon ECR melalui IPv6, verifikasi persyaratan berikut:

Menguji kompatibilitas alamat IP

Jika Anda menggunakan use Linux/Unix atau Mac OS X, Anda dapat menguji apakah Anda dapat mengakses titik akhir dual-stack melalui IPv6 dengan menggunakan curl perintah seperti yang ditunjukkan pada contoh berikut:

curl --verbose https://ecr.us-west-2.api.aws

* About to connect() to ecr.us-west-2.api.aws port 443 (#0)
* Trying IPv6 address... connected
* Connected to ecr.us-west-2.api.aws (IPv6 address) port 443 (#0)
> Host: ecr.us-west-2.api.aws
* Request completely sent off

Jika Anda menggunakan Microsoft Windows 7 atau Windows 10, Anda dapat menguji apakah Anda dapat mengakses titik akhir dual-stack melalui IPv4 atau IPv6 dengan menggunakan ping perintah seperti yang ditunjukkan pada contoh berikut.

ping ecr.us-west-2.api.aws

Membuat permintaan melalui IPv6 dengan menggunakan titik akhir tumpukan ganda

Anda dapat membuat panggilan Amazon ECR API melalui IPv6 menggunakan titik akhir dual-stack. Fungsionalitas dan kinerja operasi Amazon ECR API tetap konsisten baik Anda menggunakan IPv4 atau IPv6.

Bila Anda menggunakan AWS Command Line Interface (AWS CLI) dan AWS SDK, Anda dapat mengaktifkan IPv6 baik dengan menggunakan parameter atau flag untuk beralih ke titik akhir dual-stack, atau dengan langsung menentukan titik akhir dual-stack dalam file konfigurasi Anda untuk mengganti endpoint Amazon ECR default. Anda juga dapat membuat perubahan konfigurasi dengan menggunakan perintah, yang disetel use_dualstack_endpoint ke true di profil default. Untuk informasi selengkapnya tentanguse_dualstack_endpoint, lihat Dual-stack dan titik akhir FIPS.

Menggunakan titik akhir Amazon ECR dari docker CLI

Setelah Anda masuk ke repositori Amazon ECR Anda dan menandai gambar Anda, Anda dapat mendorong dan menarik gambar OCI dan gambar Docker ke dan dari pendaftar Amazon ECR. Contoh berikut menunjukkan perintah docker push dan Docker pull dengan kedua titik akhir dual-stack.

Menggunakan alamat IPv6 di kebijakan IAM

Sebelum Anda mengakses registri menggunakan IPv6, pastikan bahwa pengguna IAM dan kebijakan registri Amazon ECR Anda yang menggunakan pemfilteran alamat IP menyertakan rentang alamat IPv6. Jika kebijakan pemfilteran alamat IP tidak diperbarui untuk menangani alamat IPv6, klien mungkin salah kehilangan atau mendapatkan akses ke registri ketika mereka mulai menggunakan IPv6. Untuk informasi selengkapnya tentang mengelola izin akses, lihat Identity and Access Management untuk Amazon Elastic Container Registry.

Kebijakan IAM yang memfilter alamat IP menggunakan Operator Kondisi Alamat IP. Contoh kebijakan registri berikut menunjukkan cara mengidentifikasi 54.240.143.* rentang alamat IPv4 yang diizinkan dengan menggunakan operator kondisi alamat IP. Alamat IP apa pun di luar rentang ini ditolak akses ke registri (exampleregistry). Karena semua alamat IPv6 berada di luar rentang yang diizinkan, kebijakan ini mencegah akses alamat IPv6. exampleregistry

Untuk mengizinkan rentang alamat IPv4 (54.240.143.0/24) dan IPv6 (2001:DB8:1234:5678::/64), ubah elemen Kondisi kebijakan registri seperti yang ditunjukkan pada contoh berikut. Anda dapat menggunakan format Condition blok ini untuk memperbarui kebijakan pengguna dan registri IAM Anda.

       "Condition": {
         "IpAddress": {
            "aws:SourceIp": [
              "54.240.143.0/24",
               "2001:DB8:1234:5678::/64"
             ]
          }
        }

Anda dapat meninjau kebijakan pengguna IAM menggunakan konsol IAM di. https://console.aws.amazon.com/iam/ Untuk informasi lebih lanjut tentang IAM, lihat Panduan Pengguna IAM.