Panduan Memulai untuk Container Registry

Panduan Memulai untuk Container Registry

Panduan memulai ini menjelaskan cara mengonfigurasi Docker untuk Container Registry, lalu mengirim dan mengambil image.

Google Cloud memiliki dua layanan untuk menyimpan dan mengelola image container:

Artifact Registry (Direkomendasikan)

Layanan untuk menyimpan dan mengelola artefak di repositori pribadi, termasuk image container, diagram Helm, dan paket bahasa. Container image registry yang direkomendasikan untuk Google Cloud.

Coba panduan memulai Docker untuk memahami Artifact Registry.

Container Registry

Registry image container pribadi yang mendukung format image Docker Image Manifest V2 dan OCI. Artifact Registry menyediakan subset fitur Artifact Registry.

Jika saat ini Anda tidak menggunakan Container Registry, gunakan Artifact Registry. Untuk perbandingan antara Container Registry dan Artifact Registry, serta informasi tentang transisi dari Container Registry ke Artifact Registry, lihat Bertransisi dari Container Registry.

Sebelum memulai

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Container Registry API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Container Registry API.

   Enable the API

Memilih shell

Untuk menyelesaikan panduan memulai ini, gunakan Cloud Shell atau shell lokal Anda.

Cloud Shell

Cloud Shell adalah lingkungan shell untuk mengelola resource yang dihosting di Google Cloud. Aplikasi ini dilengkapi dengan Docker dan Google Cloud CLI, antarmuka command line utama untuk Google Cloud.

Shell lokal

Jika lebih suka menggunakan shell lokal, Anda harus menginstal Docker dan gcloud CLI di lingkungan Anda.

Memulai Cloud Shell

Untuk meluncurkan Cloud Shell, lakukan langkah-langkah berikut:

1. Buka Konsol Google Cloud.

   Google Cloud console

2. Di panel menu, klik tombol Activate Cloud Shell: .

Sesi Cloud Shell akan terbuka di dalam frame yang lebih rendah di konsol. Anda menggunakan shell ini untuk menjalankan perintah gcloud.

Menyiapkan shell lokal

Untuk menginstal gcloud dan Docker, lakukan langkah-langkah berikut:

1. Instal gcloud CLI. Untuk mengupdate penginstalan yang sudah ada, jalankan perintah gcloud components update.

   Catatan: Di Ubuntu, gunakan paket Debian untuk menginstal gcloud CLI. Paket snap CLI gcloud tidak menyertakan kubectl atau ekstensi untuk melakukan autentikasi dengan Container Registry menggunakan gcloud CLI.

2. Instal Docker jika belum diinstal.

3. Docker memerlukan akses istimewa untuk berinteraksi dengan registry. Di Linux atau Windows, tambahkan pengguna yang Anda gunakan untuk menjalankan perintah Docker ke grup keamanan Docker. Langkah ini tidak diperlukan di MacOS karena Docker Desktop berjalan di virtual machine sebagai pengguna root.

   Linux

   Grup keamanan Docker disebut docker. Untuk menambahkan nama pengguna, jalankan perintah berikut:

   sudo usermod -a -G docker ${USER}
   

   Windows

   Grup keamanan Docker disebut docker-users. Untuk menambahkan pengguna dari command prompt Administrator, jalankan perintah berikut:

   net localgroup docker-users DOMAIN\USERNAME /add
   

   Dari mana

   • DOMAIN adalah domain Windows Anda.
   • USERNAME adalah nama pengguna Anda.
   Catatan: Grup keamanan Docker memiliki akses yang setara dengan pengguna root atau Administrator. Hanya tambahkan pengguna tepercaya yang memerlukan akses ke Docker. Untuk mengetahui detail tentang dampak keamanan, lihat Keamanan daemon Docker.

4. Logout dan login kembali agar perubahan keanggotaan grup diterapkan. Jika menggunakan mesin virtual, Anda mungkin perlu memulai ulang mesin virtual agar perubahan keanggotaan diterapkan.

5. Untuk memastikan Docker berjalan, jalankan perintah Docker berikut, yang menampilkan waktu dan tanggal saat ini:

docker run busybox date

Mengonfigurasi autentikasi

Sebelum dapat mengirim atau mengambil image, Anda harus mengonfigurasi Docker agar menggunakan Google Cloud CLI untuk mengautentikasi permintaan ke Container Registry.

Jalankan perintah berikut:

gcloud auth configure-docker

Perintah ini memperbarui konfigurasi Docker Anda. Sekarang Anda dapat terhubung dengan Container Registry di project Google Cloud untuk mengirim dan mengambil image.

Catatan: Jika menggunakan pengelola paket untuk menginstal gcloud CLI, Anda harus menggunakan helper kredensial Docker mandiri atau metode autentikasi lainnya. Baca Metode autentikasi untuk mengetahui detailnya.

Mendapatkan gambar untuk dikirim

Untuk panduan memulai ini, Anda akan mengirim gambar contoh bernama hello-app.

1. Ubah ke direktori tempat Anda ingin menyimpan gambar

2. Jalankan perintah berikut untuk menarik image versi 1.0.

   docker pull gcr.io/google-samples/hello-app:1.0
   

Menambahkan image ke Container Registry

Untuk menambahkan image ke Container Registry, beri tag pada image, lalu kirimkan ke registry.

Memberi tag pada image dengan nama registry

Memberi tag pada image Docker dengan nama registry akan mengonfigurasi perintah docker push untuk mengirim image ke lokasi tertentu. Untuk panduan memulai ini, lokasi host-nya adalah gcr.io.

Jalankan perintah berikut untuk memberi tag pada image sebagai quickstart-image:tag1:

docker tag gcr.io/google-samples/hello-app:1.0 gcr.io/PROJECT_ID/quickstart-image:tag1

Ganti kode berikut:

• PROJECT-ID adalah project ID Google Cloud Console Anda, yang perlu ditambahkan ke perintah. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.
• gcr.io adalah nama host
• quickstart-image adalah nama image Docker
• tag1 adalah tag yang Anda tambahkan ke image Docker. Jika Anda tidak menentukan tag, Docker akan menerapkan tag default latest.

Sekarang Anda siap mengirim image ke Container Registry.

Menerapkan image ke Container Registry

Setelah mengonfigurasi autentikasi dan memberi tag pada image lokal, Anda dapat mengirim image ke repositori yang Anda buat.

Untuk mengirim image Docker, jalankan perintah berikut:

docker push gcr.io/PROJECT_ID/quickstart-image:tag1

dengan PROJECT_ID adalah project ID Google Cloud Console Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.

Saat Anda mengirim image ke lokasi host baru, layanan akan membuat bucket penyimpanan dasar yang unik untuk project Anda. Anda dapat melihat image yang dihosting oleh Container Registry melalui Konsol Google Cloud, atau dengan membuka nama registry gambar di browser web Anda: http://gcr.io/PROJECT_ID/quickstart-image.

Mengambil image dari Container Registry

Untuk mengambil image dari Container Registry ke komputer lokal, jalankan perintah berikut:

docker pull gcr.io/PROJECT_ID/quickstart-image:tag1

Ganti PROJECT_ID dengan project ID Google Cloud Console Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.

Anda akan melihat output yang mirip dengan berikut ini:

latest: Pulling from my-project/quickstart-image:tag1
Digest: sha256:70c42...
Status: Image is up to date for gcr.io/my-project/quickstart-image:tag1

Pembersihan

Agar akun Google Cloud Anda tidak dikenakan biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Jalankan perintah berikut untuk menghapus image Docker dari Container Registry.

gcloud container images delete gcr.io/PROJECT_ID/quickstart-image:tag1 --force-delete-tags

Ganti PROJECT_ID dengan project ID Google Cloud Console Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.

Langkah selanjutnya

• Pelajari lebih lanjut cara mengirim dan mengambil image Docker dengan Container Registry.
• Pelajari lebih lanjut cara mengelola image Docker di Container Registry.
• Pelajari cara menggunakan Container Registry dengan layanan Google Cloud lainnya.
• Pelajari lebih lanjut fitur Container Registry.
• Pelajari Docker lebih lanjut.
• Baca sumber daya kami tentang DevOps dan jelajahi program penelitian kami.