Menyimpan image container Docker di Artifact Registry

Menyimpan image container Docker di Artifact Registry

Artifact Registry menyediakan satu lokasi untuk mengelola paket pribadi dan image container Docker.

Panduan memulai ini menunjukkan cara:

• Membuat repositori Docker pribadi di Artifact Registry
• Menyiapkan autentikasi
• Mengirim image ke repositori
• Menarik image dari repositori

---

Jika ingin mengikuti panduan langkah demi langkah untuk tugas ini langsung di Konsol Google Cloud, klik Pandu saya:

Pandu saya

---

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 Artifact 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 Artifact 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. Cloud Shell telah diinstal lebih dulu 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.

   Konsol Google Cloud

2. Klik tombol Aktifkan 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 CLI dan Docker, lakukan langkah-langkah berikut:

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

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

2. Instal Docker jika belum diinstal.

3. Docker memerlukan akses dengan hak 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 virtual machine, Anda mungkin perlu memulai ulang virtual machine agar perubahan keanggotaan diterapkan.

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

   docker run --rm busybox date
   

   Flag --rm menghapus instance penampung saat keluar.

Membuat repositori Docker

Buat repositori Docker untuk menyimpan image sampel untuk panduan memulai ini.

Konsol

1. Buka halaman Repositories di konsol Google Cloud.

   Buka halaman Repositori

2. Klik add Create Repository.

3. Tentukan quickstart-docker-repo sebagai nama repositori.

4. Pilih Docker sebagai format dan Standar sebagai mode.

5. Di bawah Jenis Lokasi, pilih Region dan kemudian pilih lokasi us-west1.

6. Klik Buat.

Repositori ditambahkan ke daftar repositori.

gcloud

1. Jalankan perintah berikut untuk membuat repositori Docker baru bernama quickstart-docker-repo di lokasi us-west1 dengan deskripsi "repositori docker".

   gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \
       --location=us-west1 --description="Docker repository" \
       --project=PROJECT
   

   Dengan PROJECT sebagai project ID Google Cloud Anda.

2. Jalankan perintah berikut untuk memverifikasi bahwa repositori Anda telah dibuat.

   gcloud artifacts repositories list \
       --project=PROJECT
   

Untuk mengetahui informasi selengkapnya tentang perintah Artifact Registry, jalankan perintah gcloud artifacts.

Mengonfigurasi autentikasi

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

Untuk menyiapkan autentikasi ke repositori Docker di region us-west1, jalankan perintah berikut:

gcloud auth configure-docker us-west1-docker.pkg.dev

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

Untuk informasi tentang metode autentikasi lainnya, lihat Metode autentikasi.

Mendapatkan image untuk dikirim

Untuk panduan memulai ini, Anda akan mendorong image contoh bernama hello-app.

Jalankan perintah berikut untuk mengambil image versi 1.0.

   docker pull us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

Jalur image di Artifact Registry mencakup beberapa bagian. Untuk gambar contoh ini:

• us-docker.pkg.dev adalah nama host untuk image container yang disimpan di repositori Docker Artifact Registry, yang mencakup lokasi repositori (us).
• google-samples adalah project ID.
• containers adalah ID repositori.
• /gke/hello-app adalah jalur ke image di repositori containers.

Menambahkan gambar ke repositori

Sebelum mengirim image Docker ke Artifact Registry, Anda harus memberinya tag dengan nama repositori.

Memberi tag pada image dengan nama registry

Memberi tag pada image Docker dengan nama repositori akan mengonfigurasi perintah docker push untuk mendorong image ke lokasi tertentu. Untuk panduan memulai ini, lokasi host adalah us-west1-docker.pkg.dev.

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

docker tag us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0 \
us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1

Dengan keterangan:

• us-west1 adalah lokasi repositori.
• us-west1.docker.pkg.dev adalah nama host untuk repositori Docker yang Anda buat.
• PROJECT adalah project ID Google Cloud Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.
• quickstart-docker-repo adalah ID repositori yang Anda buat.
• quickstart-image adalah nama image yang ingin Anda gunakan di repositori. Nama gambar dapat berbeda dengan nama gambar lokal. Untuk panduan memulai ini, Anda akan menyimpan gambar langsung di bawah ID repositori quickstart-docker-repo.
• tag1 adalah tag yang Anda tambahkan ke image Docker. Jika Anda tidak menentukan tag, Docker akan menerapkan tag default latest.

Sekarang Anda siap untuk mengirim image ke repositori yang telah dibuat.

Mengirim image ke Artifact 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 us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1

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

Mengambil image dari Artifact Registry

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

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

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

latest: Pulling from [PROJECT-ID]/quickstart-image:tag1
Digest: sha256:70c42...
Status: Image is up to date for us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1

Pembersihan

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

Sebelum menghapus repositori, pastikan semua gambar yang ingin disimpan tersedia di lokasi lain.

Untuk menghapus repositori:

Konsol

1. Buka halaman Repositories di konsol Google Cloud.

   Buka halaman Repositori

2. Dalam daftar repositori, pilih repositori quickstart-docker-repo.

3. Klik Hapus.

gcloud

Untuk menghapus repositori quickstart-docker-repo, jalankan perintah berikut:

gcloud artifacts repositories delete quickstart-docker-repo --location=us-west1

Langkah selanjutnya

• Pelajari lebih lanjut cara menggunakan image container.
• Pelajari Docker lebih lanjut.
• Baca referensi kami tentang DevOps dan jelajahi program riset DevOps Research and Assessment (DORA).