Mengambil image dengan Docker

Ambil image dari project Harbor di klien Docker untuk mendownload image container yang ditentukan dari registry Harbor ke komputer lokal Anda. Dengan demikian, Anda dapat menjalankan aplikasi dalam container secara lokal atau menggunakannya sebagai image dasar untuk membangun image lain.

Sebelum memulai

Untuk mengambil image dengan Docker, Anda harus mengonfigurasi lingkungan dengan resource dan izin yang diperlukan, termasuk project Harbor yang ada dengan image container yang ingin Anda ambil. Untuk mengetahui informasi selengkapnya, lihat Membuat project Harbor.

Peran IAM yang diperlukan

Untuk mengambil image dari instance registry Harbor, hubungi Admin Project IAM Anda untuk meminta peran Harbor Instance Viewer (harbor-instance-viewer), yang memungkinkan Anda mendapatkan, membuat daftar, dan memantau instance Harbor di namespace project. Peran ini mencakup izin yang diperlukan untuk melihat detail instance Harbor yang ada sehingga Anda dapat mengambil URL registry yang diperlukan untuk mengambil image.

Peran RBAC Harbor yang diperlukan

Tidak seperti peran IAM GDC, mengambil image memerlukan izin khusus dalam sistem role-based access control (RBAC) internal Harbor. Minta izin yang diperlukan dari administrator Anda. Terapkan akses dengan hak istimewa terendah dengan hanya meminta peran yang diperlukan untuk tugas spesifik Anda.

Mengambil image

Ikuti langkah-langkah berikut untuk mengambil image dari project Harbor di klien Docker:

  1. Pastikan Anda telah diautentikasi ke instance Harbor.

  2. Ambil image dari project Harbor:

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG

    atau

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE@IMAGE_DIGEST

Ganti nilai berikut:

  • INSTANCE_URL: URL instance Harbor. Misalnya, harbor-1.org-1.zone1.google.gdc.test. Anda bisa mendapatkan URL instance Harbor menggunakan konsol GDC atau gdcloud CLI.
  • HARBOR_PROJECT_NAME: nama project Harbor. Contoh, my-project.
  • IMAGE: nama image. Contoh, nginx.
  • TAG: tag untuk versi image yang ingin Anda ambil. Contoh, staging.
  • IMAGE_DIGEST: nilai hash sha256 dari konten gambar. Setiap versi image memiliki ringkasan image yang unik. Di UI instance Harbor, klik image tertentu untuk melihat ringkasannya. Untuk mengetahui informasi selengkapnya, lihat Melihat instance registry Harbor.

Langkah berikutnya

Setelah mengonfirmasi koneksi dengan mengambil image, Anda dapat menggunakan artefak untuk meluncurkan aplikasi di lingkungan Anda: