Mengonfigurasi Docker agar memercayai CA root Harbor

Instance Harbor menggunakan sertifikat Transport Layer Security (TLS) yang diterbitkan oleh root Certificate Authority (CA) tepercaya organisasi Anda. Tindakan ini akan mengenkripsi koneksi antara klien Docker dan registry Harbor untuk mengamankan image dari akses yang tidak sah.

Halaman ini menjelaskan cara mengonfigurasi klien Docker di workstation Anda untuk memercayai root CA Harbor. Anda tidak perlu mengonfigurasi kepercayaan pada node cluster Kubernetes, karena GDC mengonfigurasi node cluster untuk memercayai instance registry Harbor Anda secara otomatis. Untuk mengetahui informasi selengkapnya, lihat Kepercayaan node cluster untuk instance registry Harbor.

Sebelum memulai

Anda harus melakukan langkah-langkah ini sebelum mengelola image container:

  1. Instal Docker jika belum diinstal dengan mengikuti petunjuk di https://docs.docker.com/engine/install/ubuntu/. Docker disertakan dalam Cloud Shell.
  2. 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.

    1. Untuk Linux, tambahkan pengguna:

        sudo usermod -a -G docker USER
      
    2. Untuk Windows:

        net localgroup docker-users DOMAIN\Upan>SER /add
      

      Ganti USER dengan nama pengguna yang ingin Anda tambahkan.

Mengonfigurasi Docker untuk memercayai Root CA Harbor

Anda harus mengonfigurasi klien Docker lokal untuk memercayai root CA organisasi Anda saat menggunakan klien Docker untuk berkomunikasi dengan instance Harbor.

Untuk mengonfigurasi klien Docker agar memercayai root CA, minta file .crt root CA dari administrator organisasi Anda, dan salin root CA organisasi ke:

/etc/docker/certs.d/HARBOR_INSTANCE_URL/ca.crt

Ganti HARBOR_INSTANCE_URL dengan URL instance Harbor Anda. Contoh, harbor-1.org-1.zone1.google.gdc.test.

Perintah ini memungkinkan klien Docker Anda membuat koneksi HTTPS dengan instance Harbor.

Atau, gunakan gdcloud CLI untuk login ke organisasi, membuat dan menggunakan file kubeconfig untuk server API pengelolaan, dan menyalin trust bundle di cluster. Untuk mengetahui informasi selengkapnya, lihat Mengambil paket kepercayaan GDC.

  export REGISTRY=HARBOR_INSTANCE_URL
  mkdir -p /etc/docker/certs.d/${REGISTRY} && echo $(kubectl get secret trust-store-global-root-ext -n platform -o \
  jsonpath='{.data.ca\.crt}') | openssl base64 -A -d > \
  /etc/docker/certs.d/${REGISTRY}/ca.crt

Ganti HARBOR_INSTANCE_URL dengan URL instance Harbor Anda. Contoh, harbor-1.org-1.zone1.google.gdc.test.

Jika konfigurasi tidak berhasil, Anda akan melihat pesan error berikut:

Error response from daemon: Get "https://<HARBOR_INSTANCE_URL>": x509: certificate signed by unknown authority

Ulangi langkah-langkah untuk menyelesaikan masalah ini, dan eskalasikan ke tim engineering GDC jika perlu.

Jika pod di cluster Kubernetes menampilkan error x509: certificate signed by unknown authority saat mengambil image dari instance registry Harbor, lihat Memecahkan masalah error sertifikat saat mengambil image.

Langkah berikutnya

Setelah mengonfigurasi klien Docker untuk memercayai root CA Harbor, selesaikan penyiapan koneksi Anda untuk mulai menggunakan registry: