Konsep container

Artifact Registry memungkinkan Anda menyimpan dan mengatur image container dan artefak lainnya di repositori sehingga Anda dapat mengelola dan men-deploy workload di berbagai lingkungan. Anda dapat menggunakan lapisan gambar, tag, dan ringkasan manifes untuk mengontrol pembuatan versi gambar dan mengelola deployment.

Contoh Artifact Registry di halaman ini terutama merujuk ke repositori berformat Docker. Untuk mengetahui informasi selengkapnya, lihat Format yang didukung dan Ringkasan repositori.

Registry

Registry menyimpan dan mendistribusikan image dan artefak container yang disusun berdasarkan nama dalam repositori. Registry dapat berisi satu repositori atau beberapa repositori dan dapat bersifat publik atau pribadi.

Layanan registry seperti Docker Hub dan Artifact Registry menyediakan opsi untuk membuat repositori publik atau pribadi. Saat menarik image publik, penting untuk memahami kemungkinan masalah keamanan. Baca tentang pengelolaan dependensi untuk mengetahui informasi selengkapnya tentang pemantauan kerentanan dan mengurangi jejak dependensi Anda.

Registry diatur ke dalam repositori yang menyimpan image container individual. Artifact Registry memungkinkan Anda membuat beberapa repositori dalam satu project dan mengaitkan lokasi regional atau multi-regional tertentu dengan setiap repositori. Repositori terkait dapat dikelompokkan berdasarkan label.

Pengelolaan repositori dan image Artifact Registry

Di repositori format Docker Artifact Registry, Anda dapat menyimpan beberapa image container dengan nama yang berbeda dalam repositori yang sama. Setiap versi image diidentifikasi oleh ringkasan image dan dapat dikaitkan dengan tag. Tag dapat berubah atau tidak dapat diubah. Untuk mengetahui informasi selengkapnya tentang versi dan tag image container, lihat Versi image container.

Artifact Registry biasanya merujuk pada bagian jalur ke image untuk mengidentifikasi project, lokasi regional atau multiregional, dan nama image beserta tag atau ringkasan manifes untuk mengidentifikasi versi yang benar.

Contoh:

docker push us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1

  • us-west1 adalah lokasi repositori
  • docker.pkg.dev adalah nama host untuk repositori berformat Docker.
  • PROJECT adalah namespace yang dibuat oleh Google Cloud project ID Anda.
  • quickstart-docker-repo adalah namespace di project tempat Anda menyimpan gambar. Di Artifact Registry, bagian jalur ini disebut repositori.
  • quickstart-image adalah nama untuk semua versi quickstart-image dan sering disebut sebagai image.
  • tag1 adalah tag yang menentukan versi image.

Gambar

Artefak dan image dapat disimpan dalam Artifact Registry. Artefak dapat berupa apa saja: file teks, image Docker, atau diagram Helm, sedangkan image biasanya merujuk pada image container. Image container adalah paket software yang berisi semua elemen yang diperlukan untuk dijalankan di lingkungan apa pun. Baca Apa itu container untuk mengetahui informasi selengkapnya.

Image dikirim atau diupload ke repositori dan ditarik atau didownload dari repositori. Untuk menentukan image dan versi yang benar, registry dan artefak unik harus ditentukan.

Untuk mengetahui informasi selengkapnya tentang nama repositori dan image di Artifact Registry, lihat Nama repositori dan image.

Lapisan

Image container yang disimpan di repositori dibuat secara inkremental menggunakan lapisan. Gambar yang berbeda dapat menggunakan beberapa lapisan yang sama. Lapisan ditentukan dengan cara yang berbeda, bergantung pada jenis gambar. Misalnya, setiap petunjuk dalam Dockerfile sesuai dengan lapisan dalam image Docker. Dalam registry, image dengan lapisan umum berbagi lapisan tersebut, sehingga meningkatkan efisiensi penyimpanan. Untuk keamanan, lapisan tidak dibagikan di berbagai registri.

Saat Anda menghapus image container, lapisan tidak akan langsung dihapus. Lapisan yang tidak dirujuk oleh gambar apa pun di registry akan dihapus setiap hari.

Tag

Pengguna menambahkan tag saat mengirim atau menarik image ke repositori untuk menentukan versi image. Gambar dapat memiliki satu atau beberapa tag, atau tidak memiliki tag sama sekali. Jika Anda menggunakan tag yang dapat diubah, dan Anda mengirimkan image dua kali dengan tag yang sama, tag akan dihapus dari image pertama dan dipindahkan ke image kedua, sehingga image pertama tidak memiliki tag. Gambar yang tidak diberi tag masih dapat diakses menggunakan ringkasan manifes.

Jika Anda menggunakan tag yang tidak dapat diubah, tindakan berikut tidak diizinkan:

  • Menghapus gambar yang diberi tag. Menghapus gambar yang tidak diberi tag masih diizinkan.
  • Menghapus tag dari gambar.
  • Mengirim image dengan tag yang sudah digunakan oleh versi image lain di repositori.

Tag latest adalah tag khusus yang ditambahkan saat gambar dikirim tanpa tag.

Contoh:

docker push us-west1-docker.pkg.dev/my-project/my-repo/hello-app

mendorong gambar ke hello-app:latest

docker pull us-west1-docker.pkg.dev/my-project/my-repo/hello-app

menarik gambar hello-app:latest.

Penting untuk diperhatikan bahwa saat image di-push ke repositori dengan tag selain latest, tag latest tidak ditambahkan, sehingga image latest mungkin tidak memiliki perubahan terbaru. Sebaiknya gunakan tag selain latest untuk rilis.

Manifes

Manifes Image mengidentifikasi dan menentukan lapisan dalam setiap image secara unik. Manifes diidentifikasi dengan hash SHA-256 unik yang disebut ringkasan manifes. Ringkasan manifes lebih andal dan aman daripada tag karena di repositori dengan tag yang dapat berubah, beberapa versi image yang sama dapat di-push ke tag yang sama, sehingga beberapa image tidak memiliki tag, sementara setiap image ditentukan secara unik oleh ringkasan manifesnya.

Jika Anda menggunakan alat untuk memindai atau menganalisis gambar, hasil dari alat ini hanya valid untuk gambar yang dipindai. Untuk memastikan bahwa Anda men-deploy image yang telah dipindai, Anda tidak dapat mengandalkan tag karena image yang dirujuk oleh tag mungkin berubah.

Untuk mempelajari lebih lanjut pemberian tag dan manifes khusus Artifact Registry, baca Mengelola Image dan Menggunakan image container.

Pemanasan awal gambar

Untuk aplikasi yang sensitif terhadap latensi yang menggunakan streaming image, menunggu image ditarik untuk pertama kalinya di node atau instance baru, yang sering disebut "cold start", dapat menyebabkan penundaan yang tidak diinginkan. Pemanasan awal memungkinkan Anda memulai download gambar secara eksplisit ke cache Image Streaming sebelum diminta. Proses ini membantu memastikan image Anda tersedia untuk pengiriman cepat saat cluster GKE Anda memintanya.

Untuk memanaskan image, gunakan Artifact Registry API. Untuk mengetahui petunjuknya, lihat Mengurangi latensi dengan pemanasan awal gambar.

Langkah berikutnya