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. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Aktifkan API Container Registry.

    Mengaktifkan API

  5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  6. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  7. Aktifkan API Container Registry.

    Mengaktifkan 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.

  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.
  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:

  6. 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.

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