Pemberitahuan penghentian penggunaan berikut memengaruhi Container Registry. Lihat juga pemberitahuan penghentian Docker dan changelog-nya.
Docker Registry v1 API dan klien Docker di bawah versi 1.6
Pada 14 Desember 2016, kami mengumumkan bahwa, mulai 28 Februari 2017, dengan rilis Docker v1.13, Docker Engine tidak lagi mendukung protokol v1.
Akibatnya, Container Registry tidak lagi mendukung klien Docker di bawah versi 1.6. Setelah 28 Februari 2017, klien Docker di bawah versi 1.6 tidak dapat berkomunikasi dengan Container Registry API, dan image container apa pun dalam protokol v1 yang disimpan di Container Registry tidak dapat lagi ditayangkan.
Untuk melihat apakah perubahan ini memengaruhi gambar Anda, lakukan langkah-langkah berikut:
Periksa versi klien Docker yang Anda gunakan dengan menjalankan perintah berikut:
gcloud docker -- --version
Jika versi klien Anda lebih rendah dari versi 1.6, Anda harus mengupdate klien Docker. Kemudian, Anda harus mengupdate image ke protokol Docker Registry v2.
Menarik gambar v1 yang terpengaruh:
gcloud docker -- pull gcr.io/[PROJECT-ID]/[IMAGE]
Kirim gambar lagi:
gcloud docker -- push gcr.io/[PROJECT-ID]/[IMAGE]
Untuk mengetahui informasi selengkapnya tentang protokol v1 dan v2 Docker Registry, lihat Format Image Container.
Bucket Container Registry Non-Standar
Pada 28 Februari 2017, penggunaan registry "bring-your-own-bucket" seperti
b.gcr.io
dan bucket.gcr.io
tidak digunakan lagi. Container Registry tidak lagi
menayangkan image container apa pun yang dihosting di bucket tersebut.
Untuk terus menggunakan image, Anda harus memindahkannya ke lokasi
Container Registry standar seperti gcr.io
, us.gcr.io
, asia.gcr.io
, atau
eu.gcr.io
.
Untuk memigrasikan image container dari bucket non-standar ke bucket standar, lakukan langkah-langkah berikut:
Ambil gambar di bucket non-standar:
gcloud docker -- pull b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG]
Beri tag ulang pada image dengan nama lokasi registry standar:
gcloud docker -- tag b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG] [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]
Kirim ulang image ke Container Registry (menggunakan klien Docker versi 1.6 atau yang lebih baru) menggunakan ID project target:
gcloud docker -- push [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]
Perubahan Penyimpanan Metadata Image Container
Mulai 28 Februari 2017, Container Registry telah mengubah tempat penyimpanan file metadata image container. Metadata gambar mengacu pada informasi seperti nama gambar, tag gambar, dan manifes gambar yang mengidentifikasi file lapisan (dengan ringkasan) yang membentuk gambar.
Perubahan ini dapat memengaruhi Anda jika Anda langsung mengakses atau memanipulasi file metadata di bucket Cloud Storage, seperti histori perubahan atau pengelolaan siklus proses objek untuk penghapusan.
Sebelumnya, saat Anda mengirim image ke Container Registry, Container Registry API menyimpan metadata dan file lapisan untuk image tersebut di bucket Cloud Storage dalam project Anda. Mulai 28 Februari 2017, Container Registry menyimpan metadata image dalam database backend berperforma tinggi untuk meningkatkan performa dan fungsi. File lapisan gambar masih disimpan di Cloud Storage.
Akun layanan Container Registry otomatis ditambahkan ke project Anda dengan nama yang mirip dengan [PROJECT-NUMBER]@containerregistry.iam.gserviceaccount.com
.
Akun layanan ini mengaktifkan Container Registry API baru dan mengelola
migrasi. Jangan hapus atau downgrade akun layanan ini atau nonaktifkan
Container Registry API yang baru.
Perintah docker gcloud dan klien Docker di atas versi 18.03
Mulai 3 April 2018, gcloud docker
tidak didukung untuk versi klien Docker
di atas 18.03.
Untuk mengautentikasi permintaan ke Container Registry untuk versi klien di atas 18.03,
gunakan gcloud
sebagai helper kredensial Docker. Untuk melakukannya, jalankan perintah berikut:
gcloud auth configure-docker
Atau, gunakan salah satu metode autentikasi lanjutan lainnya.