Membuat project Harbor

Dokumen ini memandu developer dan administrator tentang cara membuat dan memverifikasi project Harbor menggunakan konsol GDC atau gdcloud CLI.

Anda dapat menyimpan, mengamankan, dan mendistribusikan image container di appliance air gap Google Distributed Cloud (GDC) dengan mengaturnya ke dalam project Harbor di dalam instance tear-harbor yang telah dikonfigurasi sebelumnya. Di Harbor, project berfungsi sebagai unit logis untuk mengelompokkan artefak terkait, mengelola image, dan menerapkan kebijakan, kontrol akses, serta aturan replikasi tertentu.

Project sistem tear menyediakan tear-harbor sebagai satu-satunya instance Harbor yang tersedia—satu registry yang telah dikonfigurasi sebelumnya untuk seluruh appliance Anda—sehingga Anda tidak perlu menyediakan, mengupgrade, atau memelihara instance Harbor terpisah untuk setiap project pelanggan. Arsitektur terpusat ini menghilangkan overhead infrastruktur dan memungkinkan Anda mengelola namespace image, kontrol akses, dan pemindaian kerentanan dari satu registry bersama. Untuk menggunakan registry bersama ini untuk beban kerja di project pelanggan mana pun, Anda harus membuat peran Harbor di project tear dan membuat project Harbor secara langsung di project tear.

Sebelum memulai

Sebelum memulai, pastikan Anda memenuhi persyaratan berikut:

  • Pengetahuan yang direkomendasikan: Pastikan Anda memahami konsep dan arsitektur yang dibahas dalam Ringkasan Managed Harbor Service. Memahami bahwa Harbor adalah resource bersama yang dihosting di project tear sangat penting, karena semua tugas penetapan peran Harbor dan pembuatan project harus menargetkan project tear.

  • Lakukan inisialisasi identitas Harbor Anda: Anda harus login ke UI Harbor setidaknya sekali sebelum mencoba membuat project di konsol. Login awal menginisialisasi identitas Anda dengan Harbor Registry. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan URL instance Harbor dan Melakukan inisialisasi identitas Harbor.

Peran IAM yang diperlukan

Untuk membuat project Harbor—termasuk project Harbor yang ingin Anda gunakan dalam project pelanggan—Anda harus memiliki peran Identity and Access Management (IAM) Project Creator Harbor (harbor-project-creator) yang dibuat dan diberikan dalam project tear untuk mengakses instance tear-harbor. Peran ini memberikan izin buat, dapatkan, dan pantau untuk resource kustom project Harbor dalam instance tear-harbor di project tear, yang memungkinkan Anda menentukan namespace gambar baru dan menetapkan batas keamanan untuk aplikasi yang di-container.

Untuk meminta akses di project tear, hubungi Admin IAM Project Anda.

Mendapatkan URL instance Harbor

Untuk login ke UI Harbor atau menggunakan gdcloud CLI untuk mengelola image, Anda memerlukan URL endpoint eksternal instance registry:

  1. Menggunakan gdcloud CLI, dapatkan URL instance Harbor:

    gdcloud harbor instances describe tear-harbor --project=tear

    Outputnya mirip dengan berikut ini, yang biasanya berisi kolom externalEndpoint:

    externalEndpoint: https://harbor.tear.example.com

  2. Salin URL externalEndpoint untuk mengakses UI Harbor melalui browser dan untuk menetapkan autentikasi kepercayaan klien.

Jika Anda tidak memiliki akses gdcloud CLI, hubungi Operator Infrastruktur (IO) Anda untuk mendapatkan dukungan.

Menginisialisasi identitas Harbor Anda

Login ke UI Harbor setidaknya sekali untuk menyinkronkan identitas Anda. Login awal ini mendaftarkan profil pengguna Anda di database Harbor sehingga sistem mengenali izin Anda:

  1. Di browser, buka URL registri.
  2. Login menggunakan kredensial GDC Anda.

Membuat project Harbor

Karena tear-harbor di project tear adalah satu-satunya instance Harbor yang tersedia dan berfungsi sebagai registry bersama untuk seluruh appliance, Anda harus membuat semua project Harbor di project tear—termasuk project Harbor yang menyimpan image untuk beban kerja di project pelanggan lain. Buat project Harbor menggunakan konsol GDC atau gdcloud CLI.

Konsol

Di konsol GDC, ikuti langkah-langkah berikut di project tear:

  1. Pilih project tear.
  2. Klik link Harbor Container Registry di bagian CI/CD di menu navigasi.
  3. Klik Create a Harbor project.
  4. Masukkan nama project Harbor.
  5. Opsional: Pemindaian kerentanan diaktifkan secara default. Untuk menonaktifkan pemindaian kerentanan otomatis untuk project Harbor, klik tombol Aktifkan pemindaian kerentanan untuk project. Untuk mengetahui informasi selengkapnya, lihat Memindai kerentanan.
  6. Klik Create. Pesan konfirmasi akan muncul yang menyatakan bahwa project Anda telah dibuat.
  7. Login ke UI Harbor untuk mengonfirmasi bahwa Anda dapat melihat project Harbor.

gdcloud

Buat project Harbor di project tear:

gdcloud harbor harbor-projects create HARBOR_PROJECT \
  --project=tear \
  --instance=tear-harbor

Ganti HARBOR_PROJECT dengan nama project Harbor yang akan dibuat.