Konsep container

Dokumen ini memperkenalkan konsep utama yang terkait dengan image container, termasuk registry, repositori, dan artefak. Beberapa informasi dasar tentang cara konsep ini diterapkan ke Artifact Registry dan Container Registry juga disertakan.

Contoh Artifact Registry di halaman ini terutama merujuk pada repositori format Docker dan gcr.io. Untuk mengetahui informasi selengkapnya, lihat Format yang didukung dan Ringkasan repositori.

Registry

Registry menyimpan dan mendistribusikan image container dan artefak yang diatur 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 mengambil image publik, penting untuk memahami kemungkinan masalah keamanan. Baca artikel tentang pengelolaan dependensi untuk mengetahui informasi selengkapnya tentang pemantauan kerentanan dan mengurangi jejak dependensi Anda.

Registry diatur ke dalam repositori yang menyimpan setiap image penampung. 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.

Repositori Artifact Registry dan pengelolaan image

Di repositori format Docker Artifact Registry, Anda dapat menyimpan beberapa image container dengan nama yang berbeda di repositori yang sama. Setiap versi gambar diidentifikasi oleh ringkasan gambarnya 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 ke bagian jalur ke image untuk mengidentifikasi project, lokasi regional atau multi-regional, 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 project ID Google CloudAnda.
  • quickstart-docker-repo adalah namespace dalam 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 gambar.

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 yang dimaksud dengan penampung 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 informasi selengkapnya tentang nama repositori dan image di Artifact Registry, lihat Nama repositori dan image.

Lapisan

Image container yang disimpan di repositori dibuat secara bertahap 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, gambar dengan lapisan umum akan berbagi lapisan tersebut, sehingga meningkatkan efisiensi penyimpanan. Untuk keamanan, lapisan tidak dibagikan di seluruh registry yang berbeda.

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

Tag

Pengguna menambahkan tag saat mendorong 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 mendorong gambar dua kali dengan tag yang sama, tag akan dihapus dari gambar pertama dan dipindahkan ke gambar kedua, sehingga gambar 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. Penghapusan gambar yang tidak diberi tag masih diizinkan.
  • Menghapus tag dari gambar.
  • Mendorong image dengan tag yang sudah digunakan oleh versi image lain di repositori.

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

Contoh:

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

mengirimkan 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 berada di belakang perubahan terbaru. Sebaiknya gunakan tag selain latest untuk rilis.

Manifes

Manifes Gambar mengidentifikasi dan menentukan lapisan dalam setiap gambar secara unik. Manifes diidentifikasi oleh hash SHA-256 unik yang disebut ringkasan manifes. Ringkasan manifes lebih andal dan aman daripada tag karena di repositori dengan tag yang dapat diubah, 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 dapat berubah.

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

Langkah berikutnya