Transisi dari Container Registry

Container Registry tidak digunakan lagi. Mulai 18 Maret 2025, Container Registry dihentikan dan penulisan image ke Container Registry tidak tersedia.

URL gcr.io yang dihosting di Artifact Registry, termasuk image milik Google dengan URL gcr.io, tidak terpengaruh oleh penghentian Container Registry.

Artifact Registry adalah layanan yang direkomendasikan untuk penyimpanan dan pengelolaan image container di Google Cloud. Artifact Registry menyediakan fitur pengelolaan container yang sama dengan Container Registry dan menyertakan fitur dan manfaat tambahan. Sebagai layanan terkelola sepenuhnya dengan dukungan untuk image container dan artefak non-container, Artifact Registry memperluas kemampuan Container Registry.

Ringkasan fitur baru

Artifact Registry memperluas kemampuan Container Registry dengan fitur berikut:

Lihat perbandingan fitur untuk mengetahui detail selengkapnya tentang fitur ini.

Image Container Registry yang ada dan dikelola oleh Google

Sebagian besar image milik Google yang sebelumnya dihosting di Container Registry kini dihosting di Artifact Registry dalam repositori gcr.io. Anda tidak perlu mengubah URL untuk menarik gambar ini. Misalnya, Anda tetap dapat menggunakan image builder resmi Cloud Build.

Image Docker Hub yang di-cache di mirror.gcr.io

Artifact Registry menyimpan cache image Docker Hub publik yang sering diakses di mirror.gcr.io. Untuk mengetahui informasi selengkapnya tentang penggunaan mirror.gcr.io, lihat Mengambil image Docker Hub yang di-cache.

Perbandingan fitur

Tabel berikut merangkum perbedaan antara Container Registry dan Artifact Registry.

Fitur Container Registry Artifact Registry
Format yang didukung Hanya image container Beberapa format artefak, termasuk image container, paket bahasa, dan paket OS.
Nama domain gcr.io pkg.dev

Artifact Registry juga dapat menyimpan image untuk domain gcr.io jika Anda menyiapkan repositori gcr.io.
Mode repositori Tidak berlaku
  • Standar: Menyimpan artefak Anda.
  • Jarak jauh: Meng-cache artefak yang diminta dari sumber upstream seperti Docker Hub.
  • Virtual: Satu endpoint dengan beberapa repositori upstream.
Pembuatan registry Anda membuat host registry dengan mengirimkan image pertama ke host tersebut.

Container Registry menyimpan image di bucket Cloud Storage di project Anda dan tindakan seperti memberikan izin khusus registry harus diterapkan langsung ke bucket. Google Cloud

Membuat repositori adalah operasi terpisah dari mengirim dan menarik untuk memisahkan administrasi repositori dari penggunaan repositori secara jelas.
  • Untuk kompatibilitas mundur, Anda dapat menyiapkan repositori gcr.io. Penyiapan awal mencakup pembuatan otomatis repositori Artifact Registry untuk setiap host Container Registry di project Anda dan pengalihan gcr.io ke repositori Artifact Registry yang sesuai.
  • Untuk semua permintaan push dan pull ke domain pkg.dev, repositori harus sudah ada.

Di Artifact Registry, tidak ada bucket Cloud Storage yang dapat dikelola di Google Cloud project Anda. Anda melakukan tindakan pengelolaan gambar secara langsung di repositori.
Lokasi pendaftaran Hanya empat host registry multi-regional yang tersedia di project Google Cloud . Buat beberapa repositori yang dikontrol secara terpisah di region atau multi-region.
Access control
  • Berikan akses menggunakan peran Cloud Storage.
  • Anda dapat membatasi akses ke semua gambar yang disimpan di multi-region, tetapi tidak ke repositori individual. Misalnya, Anda dapat membatasi akses ke us.gcr.io di project my-project, tetapi Anda tidak dapat memberikan izin tertentu untuk gambar di us.gcr.io/my-project/team1 dan us.gcr.io/my-project/team2
  • Memberikan akses menggunakan peran Artifact Registry.
  • Anda dapat membatasi akses ke setiap repositori. Misalnya, Anda dapat mengontrol akses ke gambar di us-docker.pkg.dev/my-project/team1 dan us-docker.pkg.dev/my-project/team2 secara terpisah
  • Memberikan akses bersyarat dengan tag IAM dan repositori
Authentication Menyediakan beberapa metode autentikasi untuk mengirim dan menarik image dengan klien pihak ketiga. Artifact Registry mendukung metode autentikasi yang sama dengan Container Registry. Lihat Menyiapkan autentikasi untuk Docker untuk mengetahui detailnya.
Kunci enkripsi yang dikelola pelanggan (Customer-Managed Encryption Key/CMEK) Gunakan CMEK untuk mengenkripsi bucket penyimpanan yang berisi gambar Anda. Gunakan CMEK untuk mengenkripsi setiap repositori.
Menggunakan Google Cloud konsol Lihat dan kelola image Container Registry dari bagian Container Registry di konsol Google Cloud . Lihat daftar repositori Artifact Registry dan Container Registry di bagian Artifact Registry di konsol Google Cloud . Mengelola repositori dan image Artifact Registry dari halaman ini.

Jika Anda mengklik repositori Container Registry, Anda akan diarahkan ke daftar image di bagian Container Registry pada konsol Google Cloud .

Menggunakan perintah gcloud CLI dan API Menggunakan perintah gcloud container images. Perintah mendukung ringkasan yang disingkat. Jika Anda tidak menentukan string ringkasan lengkap, Container Registry akan mencoba menemukan image yang benar berdasarkan string parsial.

Tidak ada REST API atau RPC API untuk Container Registry.

 Menggunakan perintah gcloud artifacts docker. Perintah tidak mendukung ringkasan yang disingkat.

Untuk perbandingan perintah gcloud CLI Container Registry dan Artifact Registry, lihat perbandingan perintah gcloud CLI.

Artifact Registry menyediakan REST API dan RPC API untuk mengelola repositori dan artefak.
Notifikasi Pub/Sub Memublikasikan perubahan ke topik gcr. Memublikasikan perubahan ke topik gcr. Jika Anda membuat repositori dalam project yang sama dengan layanan Container Registry yang ada, konfigurasi Pub/Sub yang ada akan berfungsi secara otomatis.

Untuk mempelajari lebih lanjut, lihat Mengonfigurasi notifikasi Pub/Sub.
Logging audit Container Registry tidak menyediakan log audit untuk aktivitas registry. Gunakan Cloud Logging untuk melacak perubahan pada repositori Anda.
Image Docker Hub yang di-cache mirror.gcr.io adalah cache pull-through yang menyimpan image Docker Hub yang paling sering diminta oleh semua pengguna. mirror.gcr.io kini dihosting di Artifact Registry. mirror.gcr.io kini dihosting di Artifact Registry. Anda tidak perlu melakukan tindakan apa pun kecuali jika Anda menggunakan mirror.gcr.io di perimeter Kontrol Layanan VPC. Untuk mengetahui informasi selengkapnya tentang penggunaan mirror.gcr.io dalam perimeter Kontrol Layanan VPC, lihat Menggunakan Artifact Registry dengan Kontrol Layanan VPC.
Kontrol Layanan VPC Anda dapat menambahkan Container Registry ke perimeter layanan. Anda dapat menambahkan Artifact Registry ke perimeter layanan.
Penyimpanan dan analisis metadata dengan Analisis Artefak Memindai kerentanan OS dan paket bahasa dengan pemindaian sesuai permintaan dalam image dengan OS yang didukung. Pemindaian otomatis hanya menampilkan informasi kerentanan OS. Pelajari lebih lanjut jenis pemindaian.
Pemindaian on-demand
Pemindaian otomatis
  • Perintah Google Cloud CLI gcloud container images menyertakan flag untuk melihat hasil pemindaian, termasuk kerentanan dan metadata lainnya.
  • Pemindaian hanya menampilkan informasi kerentanan OS untuk image di Container Registry dengan sistem operasi yang didukung.
Memindai kerentanan paket OS dan bahasa dengan pemindaian on-demand dan otomatis. Pelajari lebih lanjut jenis pemindaian.
Pemindaian on-demand
Pemindaian otomatis
  • Perintah Google Cloud CLI gcloud artifacts docker images menyertakan flag untuk melihat hasil pemindaian, termasuk kerentanan dan metadata lainnya.
  • Pemindaian menampilkan informasi kerentanan OS untuk image di Artifact Registry dengan sistem operasi yang didukung dan informasi kerentanan paket bahasa untuk sistem operasi yang didukung dan tidak didukung.
Streaming image Tidak tersedia Streaming image di Artifact Registry ke GKE atau Google Cloud Serverless for Apache Spark untuk penskalaan otomatis yang lebih cepat, startup pod yang lebih cepat, dan latensi yang lebih rendah saat menarik image besar.
Deployment sumber Cloud Run Tidak tersedia Deployment sumber memungkinkan Anda menggunakan satu perintah gcloud CLI untuk membangun image container dari kode sumber, menyimpan image di Artifact Registry, dan men-deploy-nya ke Cloud Run.
Harga Harga Container Registry didasarkan pada penggunaan Cloud Storage, termasuk transfer data jaringan dan penyimpanan. Karena host registri hanya tersedia di multi-region, biaya transfer data mencakup deployment image ke Google Cloud Artifact Registry memiliki harga sendiri, berdasarkan penyimpanan dan transfer data jaringan.
Kuota Container Registry memiliki batas permintaan tetap. Kuota Cloud Storage juga berlaku. Artifact Registry memiliki kuota per project dan per pengguna. Kuota per pengguna tidak terbatas secara default, tetapi Anda dapat mengonfigurasi batas per pengguna sehingga satu pengguna tidak menggunakan terlalu banyak kuota tingkat project.

Perbandingan perintah gcloud

Tabel berikut meringkas perintah Container Registry dan perintah Artifact Registry yang setara di gcloud CLI. Klik link dalam tabel untuk melihat halaman referensi perintah.

Tabel tidak menyertakan semua perintah Artifact Registry yang tersedia yang tidak memiliki perintah yang setara di Container Registry. Lihat dokumentasi gcloud artifacts untuk referensi perintah Artifact Registry selengkapnya.

Operasi Container Registry Artifact Registry
Membuat repositori Tidak berlaku. gcloud artifacts repositories create
Menghapus repositori Tidak berlaku. gcloud artifacts repositories delete
Membuat daftar gambar gcloud container images list gcloud artifacts docker images list
Mencantumkan tag gcloud container images list-tags gcloud artifacts docker tags list
Tambahkan tag gcloud container images add-tag gcloud artifacts docker tags add
Menghapus tag gcloud container images untag gcloud artifacts docker tags delete
Mendeskripsikan gambar gcloud container images describe gcloud artifacts docker images list --include-tags