Mengonfigurasi container registry pribadi

Halaman ini menjelaskan cara mengonfigurasi server container registry yang ada untuk software Google Distributed Cloud khusus untuk VMware.

Halaman ini ditujukan untuk Admin, Arsitek, dan Operator yang menyiapkan, memantau, dan mengelola infrastruktur teknologi. Untuk mempelajari lebih lanjut peran umum dan contoh tugas yang kami referensikan dalam konten Google Cloud , lihat Peran dan tugas pengguna GKE umum.

Ringkasan

Secara default, selama pembuatan atau upgrade cluster, Google Distributed Cloud mengambil image sistem dari gcr.io/gke-on-prem-release menggunakan akun layanan akses komponen. Secara opsional, Anda dapat menyediakan server container registry Anda sendiri sehingga image sistem ditarik dari server registry pribadi Anda.

Google Distributed Cloud tidak mendukung container registry yang tidak aman. Saat memulai server container registry, Anda harus memberikan sertifikat dan kunci. Sertifikat dapat ditandatangani oleh certificate authority (CA) publik, atau dapat ditandatangani sendiri.

Membuat server container registry

Untuk mempelajari cara membuat server container registry, lihat Menjalankan registry yang dapat diakses secara eksternal dalam dokumentasi Docker.

Mengonfigurasi registry

Untuk menggunakan container registry pribadi, Anda dapat menggunakan alat command line gkectl atau Terraform.

gkectl

  1. Tambahkan bagian privateRegistry ke file konfigurasi cluster admin sebelum membuat cluster.

    Jika bagian ini diisi:

    • Saat Anda menjalankan perintah gkectl prepare sebelum pembuatan atau upgrade cluster, perintah tersebut akan mengekstrak image dari file tar yang ditentukan dalam kolom bundlePath di file konfigurasi cluster admin dan mengirimkan image ke server registry pribadi Anda.

    • Selama pembuatan atau upgrade cluster, image sistem diambil dari server registry pribadi Anda.

  2. Jika jaringan Anda berada di belakang server proxy, isi bagian proxy.

Terraform

  1. Ikuti langkah-langkah di tab Terraform di Membuat cluster admin untuk mengisi file konfigurasi cluster admin Anda.

  1. Tambahkan kode berikut ke file konfigurasi cluster admin:

    private_registry_config {
      address = "ADDRESS"
      ca_cert = "CA_CERT"
    }
    

    Ganti kode berikut:

    • ADDRESS: alamat IP atau FQDN (Nama Domain yang Sepenuhnya Memenuhi Syarat) dari mesin yang menjalankan registry pribadi Anda.

    • CA_CERT: data sertifikat CA kunci publik, tetapi dengan semua baris baru diganti dengan string \n.

    1. Jalankan perintah berikut untuk mengganti baris baru dengan \n:

      awk 'ORS="\\n" {print}' PUBLIC_KEY_PATH
      

      Ganti PUBLIC_KEY_PATH dengan jalur ke kunci publik.

    2. Salin output dari perintah sebelumnya dan tempelkan ke variabel placeholder CA_CERT.

  2. Jika jaringan Anda berada di balik server proxy, tambahkan hal berikut:

    proxy {
      url: "PROXY_SERVER_ADDRESS"
      no_proxy: "BYPASS_LIST"
    }
    

    Ganti kode berikut:

    • PROXY_SERVER_ADDRESS: alamat HTTP server proxy Anda. Sertakan nomor port meskipun sama dengan port default skema.

    • BYPASS_LIST: daftar alamat IP, rentang alamat IP, nama host, dan nama domain yang dipisahkan koma yang tidak boleh melewati server proxy.

    Contoh:

    url: "http://my-proxy.example.local:80"
    no_proxy: "192.0.2.0/24,my-host.example.local,198.51.100.0"
    

    Saat Google Distributed Cloud mengirim permintaan ke salah satu alamat, host, atau domain ini, permintaan tersebut akan mengabaikan server proxy dan dikirim langsung ke tujuan.

  1. Lanjutkan dengan langkah-langkah di tab Terraform di Membuat cluster admin untuk memverifikasi file konfigurasi dan rencana Terraform, lalu membuat cluster bootstrap.

  2. Saat Anda menjalankan perintah gkectl register bootstrap, gkectl akan meminta Anda memasukkan nama pengguna, lalu sandi untuk registry pribadi.

Selama pembuatan cluster, image sistem diambil dari server registry pribadi Anda.

Batasan dengan cluster lanjutan dan paket lengkap

Tersedia dua paket Google Distributed Cloud: lengkap dan reguler. Untuk menentukan paket mana yang ada di workstation admin, periksa kolom bundlePath di file konfigurasi cluster admin. Jika nama file diakhiri dengan -full, paket lengkapnya ada di workstation admin Anda. Jika nama file tidak diakhiri dengan -full, paket reguler ada di workstation admin Anda.

Jika Anda membuat workstation admin menggunakan perintah gkeadm, perintah tersebut akan membuat VM workstation admin dengan paket lengkap di dalamnya, dan mengonfigurasi kolom bundlePath dalam file konfigurasi cluster admin.

Jika cluster lanjutan diaktifkan, ada batasan dalam menggunakan paket lengkap dengan registry pribadi, sebagai berikut:

  • Versi 1.31: paket lengkap tidak didukung dengan registry pribadi. Untuk menggunakan registry pribadi di cluster lanjutan:

    1. Download paket ukuran reguler ke workstation admin Anda.
    2. Perbarui nama file di kolom bundlePath dalam file konfigurasi cluster admin.
  • Versi 1.32: penggunaan paket lengkap didukung, tetapi perintah gkectl prepare mengambil image dari gcr.io/gke-on-prem-release, bukan file tar. Namun, perintah ini akan mengirim image ke registry pribadi Anda sehingga image sistem ditarik dari registry pribadi Anda selama pembuatan atau upgrade cluster.

Perbedaan antara cluster normal dan cluster lanjutan

Cluster lanjutan memperkenalkan beberapa perbedaan utama dibandingkan dengan cluster standar:

  • Saat Anda menggunakan registry pribadi, image akan ditarik dari gcr.io, bukan nama host registry pribadi Anda. Perubahan ini sudah diperkirakan, meskipun image sebenarnya ditarik dari server registry pribadi Anda.
  • Penarikan image menggunakan kredensial dari file /etc/containerd/config.toml di setiap mesin yang terhubung ke registry pribadi, bukan dari secret private-registry-creds di dalam cluster.
  • Untuk semua image gcr.io, cluster akan mencoba mengambil dari registry pribadi terlebih dahulu. Jika image tidak ada di registry pribadi, sistem akan mengambilnya dari gcr.io melalui internet. Untuk menghentikan penggantian ini, siapkan noProxy atau gunakan aturan firewall untuk memblokir traffic gcr.io.

Untuk memeriksa apakah image ditarik dari sumber yang benar, lihat Memverifikasi bahwa image ditarik dari server registry Anda.

Memverifikasi bahwa image ditarik dari server registry Anda

Cara Anda memverifikasi bahwa image ditarik dari server registry bergantung pada apakah cluster lanjutan diaktifkan.

  • Jika cluster lanjutan tidak diaktifkan, jalankan perintah berikut:

    kubectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG get pods \
        --all-namespaces -o jsonpath="{.items[*].spec['initContainers', 'containers'][*].image}"
    

    Ganti ADMIN_CLUSTER_KUBECONFIG dengan jalur file kubeconfig untuk cluster admin Anda.

    Output perintah ini menampilkan semua image di cluster Anda. Anda dapat memverifikasi bahwa semua image Google Distributed Cloud berasal dari server registry Anda sendiri.

  • Jika cluster lanjutan diaktifkan, lakukan langkah-langkah berikut:

    Anda dapat menentukan apakah containerd mengambil image dari registry lokal Anda dengan memeriksa konten file bernama config.toml seperti yang ditunjukkan dalam langkah-langkah berikut:

    1. Login ke node dan periksa konten file /etc/containerd/config.toml.
    2. Periksa kolom plugins."io.containerd.grpc.v1.cri".registry.mirrors pada file config.toml untuk melihat apakah server registry Anda tercantum di kolom endpoint.

      Berikut adalah kutipan dari contoh file config.toml.

      version = 2
      root = "/var/lib/containerd"
      state = "/run/containerd"
      ...
      [plugins."io.containerd.grpc.v1.cri".registry]
      [plugins."io.containerd.grpc.v1.cri".registry.configs]
      [plugins."io.containerd.grpc.v1.cri".registry.configs."gcr.io"]
      [plugins."io.containerd.grpc.v1.cri".registry.configs."privateregistry2.io".tls]
      ca_file = '/etc/containerd/certs.d/privateregistry2.io/ca.crt'
      [plugins."io.containerd.grpc.v1.cri".registry.mirrors]
      [plugins."io.containerd.grpc.v1.cri".registry.mirrors."gcr.io"]
      endpoint = ["http://privateregistry.io", "http://privateregistry2.io"]
      ...
      
    3. Jika registry mirror Anda muncul di kolom endpoint, berarti node mengambil image dari registry mirror Anda, bukan dari Artifact Registry.