File konfigurasi cluster admin 1.30 dan yang lebih tinggi

Dokumen ini menjelaskan kolom dalam file konfigurasi cluster admin untuk Google Distributed Cloud versi 1.30 dan yang lebih tinggi.

Membuat template untuk file konfigurasi Anda

Jika Anda menggunakan gkeadm untuk membuat workstation admin, gkeadm akan membuat template untuk file konfigurasi cluster admin Anda. Selain itu, gkeadm telah mengisi beberapa kolom untuk Anda.

Jika tidak menggunakan gkeadm untuk membuat workstation admin, Anda dapat menggunakan gkectl untuk membuat template file konfigurasi cluster admin.

Untuk membuat template file konfigurasi cluster admin:

gkectl create-config admin --config=OUTPUT_FILENAME --gke-on-prem-version=VERSION

Ganti kode berikut:

  • OUTPUT_FILENAME: jalur pilihan Anda untuk template yang dihasilkan. Jika Anda menghilangkan flag ini, gkectl akan memberi nama file admin-cluster.yaml dan menempatkannya di direktori saat ini.

  • VERSION: nomor versi Google Distributed Cloud. Contoh: gkectl create-config admin --gke-on-prem-version=1.36.200-gke.118. Versi ini harus sama dengan atau lebih rendah dari versi gkectl Anda. Jika Anda menghapus flag ini, template konfigurasi yang dihasilkan akan diisi dengan nilai berdasarkan patch 1.36 terbaru.

Template

Kolom wajib diisi dan nilai default

Jika kolom ditandai sebagai Wajib, file konfigurasi yang telah selesai harus memiliki nilai yang diisi untuk kolom tersebut.

Jika nilai Default diberikan untuk sebuah kolom, cluster akan menggunakan nilai tersebut jika Anda tidak memasukkan apa pun untuk kolom tersebut. Anda dapat mengganti nilai default dengan memasukkan nilai.

Jika kolom tidak ditandai sebagai Wajib, kolom tersebut bersifat opsional. Anda dapat mengisinya jika relevan, tetapi Anda tidak wajib mengisinya.

Mengisi file konfigurasi Anda

Dalam file konfigurasi, masukkan nilai kolom seperti yang dijelaskan di bagian berikut.

enableAdvancedCluster

1.33 dan yang lebih tinggi

Semua cluster baru dibuat sebagai cluster lanjutan. Jika Anda menyertakan kolom ini dalam file konfigurasi saat membuat cluster baru, kolom ini harus ditetapkan ke true. Jika Anda menetapkan kolom ini ke false, pembuatan cluster akan diblokir.

1,32

Opsional
Dapat diubah (dari false ke true diizinkan)
Boolean
Diisi otomatis: true
Default: true

Tetapkan enableAdvancedCluster ke false jika Anda tidak ingin mengaktifkan cluster lanjutan saat membuat cluster baru. Jika flag ini ditetapkan ke true (cluster lanjutan diaktifkan), software Google Distributed Cloud akan men-deploy pengontrol yang memungkinkan arsitektur yang lebih dapat diperluas. Mengaktifkan cluster lanjutan akan memberi Anda akses ke fitur dan kemampuan baru, seperti domain topologi. Kolom ini wajib diisi jika infraConfigFilePath dikonfigurasi.

Pastikan untuk meninjau Perbedaan saat menjalankan cluster lanjutan sebelum mengaktifkan cluster lanjutan.

Untuk mengupdate cluster yang ada ke cluster lanjutan, lihat Mengupdate cluster ke cluster lanjutan. Setelah mengupdate ke cluster lanjutan, penonaktifan tidak diizinkan.

1,31

Hanya tersedia untuk cluster baru
Pratinjau
Opsional
Immutable
Boolean
Diisi otomatis: false
Default: false

Tetapkan enableAdvancedClusters ke true untuk mengaktifkan cluster lanjutan saat membuat cluster baru. Jika flag ini diaktifkan, software Google Distributed Cloud yang mendasarinya akan men-deploy pengontrol yang memungkinkan arsitektur yang lebih dapat diperluas. Mengaktifkan cluster lanjutan memberi Anda akses ke fitur dan kemampuan baru, seperti domain topologi. Kolom ini wajib diisi jika infraConfigFilePath dikonfigurasi.

1.30 dan yang lebih lama

Tidak tersedia.

name

Opsional
String
Default: Nama acak yang diawali dengan awalan "gke-admin-"

Nama pilihan Anda untuk cluster.

Contoh:

name: "my-admin-cluster"

bundlePath

Wajib
Dapat diubah
String

Jalur file paket Google Distributed Cloud Anda. Anda dapat menentukan paket lengkap atau paket reguler. Untuk perbandingan mendetail, lihat Tentang paket Google Distributed Cloud.

Saat Anda membuat workstation admin, workstation tersebut sudah diinstal dengan paket lengkap:

/var/lib/gke/bundles/gke-onprem-vsphere-VERSION-full.tgz

Contoh paket lengkap:

bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.30.0-gke.1-full.tgz"

Jika Anda lebih suka menggunakan paket reguler (yang memerlukan download image saat runtime), tentukan jalurnya setelah mendownloadnya:

Contoh paket reguler:

bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.30.0-gke.1.tgz"

preparedSecrets.enabled

Jika infraConfigFilePath dikonfigurasi, hapus kolom ini.

Pratinjau
Opsional
Immutable
Boolean
Diisi otomatis: false
Default: false

Tetapkan ini ke true jika Anda ingin menggunakan kredensial yang disiapkan di cluster admin. Jika tidak, tetapkan ke false atau hapus kolom.

Contoh:

preparedSecrets:
  enabled: true

vCenter

Bagian ini berisi informasi tentang lingkungan vSphere dan koneksi Anda ke vCenter Server.

Jika infraConfigFilePath dikonfigurasi, hapus seluruh bagian ini. Jika tidak, bagian ini wajib diisi dan tidak dapat diubah.

vCenter.address

Wajib
Immutable
String

Alamat IP atau nama host server vCenter Anda.

Untuk mengetahui informasi selengkapnya, lihat Menemukan alamat server vCenter Anda.

Contoh:

vCenter:
  address: "203.0.113.100"

vCenter:
  address: "my-vcenter-server.my-domain.example"

vCenter.datacenter

Wajib
Immutable
String

Jalur relatif pusat data vSphere.

Nilai yang Anda tentukan bersifat relatif terhadap folder root bernama /.

Jika pusat data Anda berada di folder root, nilainya adalah nama pusat data.

Contoh:

vCenter:
  datacenter: "my-data-center"

Jika tidak, nilainya adalah jalur relatif yang menyertakan satu atau beberapa folder beserta nama pusat data.

Contoh:

vCenter:
  datacenter: "data-centers/data-center-1"

vCenter.cluster

Wajib
Immutable
String

Jalur relatif cluster vSphere yang mewakili host ESXi tempat VM cluster admin Anda akan berjalan. Cluster vSphere ini mewakili subset host ESXi fisik di pusat data vCenter Anda.

Nilai yang Anda tentukan bersifat relatif terhadap /.../DATA_CENTER/vm/.

Jika cluster vSphere Anda berada di folder /.../DATA_CENTER/vm/, nilainya adalah nama cluster vSphere.

Contoh:

vCenter:
  cluster: "my-vsphere-cluster"

Jika tidak, nilainya adalah jalur relatif yang menyertakan satu atau beberapa folder beserta nama cluster vSphere.

Contoh:

vCenter:
  cluster: "clusters/vsphere-cluster-1"

vCenter.resourcePool

Wajib
Immutable
String

Resource pool vCenter untuk VM cluster admin Anda.

Jika Anda ingin menggunakan kumpulan resource default, tetapkan ini ke VSPHERE_CLUSTER/Resources.

Contoh:

vCenter:
  resourcePool: "my-vsphere-cluster/Resources"

Jika Anda ingin menggunakan kumpulan resource yang telah dibuat, tetapkan ini ke jalur relatif kumpulan resource Anda.

Nilai yang Anda tentukan bersifat relatif terhadap /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/

Jika kumpulan resource Anda adalah turunan langsung dari /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/, nilainya adalah nama kumpulan resource.

Contoh:

vCenter:
  resourcePool: "my-resource-pool"

Jika tidak, nilainya adalah jalur relatif yang memiliki dua atau beberapa kumpulan resource.

Contoh:

vCenter:
  resourcePool: "resource-pool-1/resource-pool-2"

vCenter.datastore

Wajib jika vCenter.storagePolicyName tidak ditentukan
Immutable
String

Nama datastore vSphere untuk cluster admin Anda.

Nilai yang Anda tentukan harus berupa nama, bukan jalur. Jangan sertakan folder apa pun dalam nilai.

Contoh:

vCenter:
  datastore: "my-datastore"

Anda harus menentukan nilai untuk vCenter.datastore atau vCenter.storagePolicyName, tetapi tidak keduanya. Jika Anda menentukan nilai untuk kolom ini, jangan tentukan nilai untuk vCenter.storagePolicyName. Kolom vCenter.datastore tidak dapat diubah, kecuali jika Anda menetapkan kolom ke string kosong saat Anda memigrasikan datastore ke Storage Policy Based Management (SPBM).

vCenter.storagePolicyName

Wajib jika vCenter.datastore tidak ditentukan
Immutable
String

Nama kebijakan penyimpanan VM untuk node cluster.

Cluster admin harus memiliki ketersediaan tinggi (HA) agar dapat berfungsi dengan kebijakan penyimpanan.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi kebijakan penyimpanan.

Anda harus menentukan nilai untuk vCenter.datastore atau vCenter.storagePolicyName, tetapi tidak keduanya. Jika Anda menentukan nilai untuk kolom ini, jangan tentukan nilai untuk vCenter.datastore.

vCenter.caCertPath

Wajib
Dapat diubah
String

Jalur sertifikat CA untuk server vCenter Anda.

Untuk mengetahui informasi selengkapnya, lihat Mendapatkan sertifikat CA vCenter.

Untuk mengetahui informasi tentang cara memperbarui kolom ini untuk cluster yang ada, lihat Memperbarui referensi sertifikat vCenter.

Contoh:

vCenter:
  caCertPath: "/usr/local/google/home/me/certs/vcenter-ca-cert.pem"

vCenter.credentials.fileRef.path

Wajib
String

Jalur file konfigurasi kredensial yang menyimpan nama pengguna dan sandi akun pengguna vCenter Anda. Akun pengguna harus memiliki peran Administrator atau hak istimewa yang setara. Lihat persyaratan vSphere.

Anda dapat menggunakan gkectl update untuk memperbarui kolom ini di cluster yang ada.

Untuk mengetahui informasi tentang cara memperbarui kredensial vCenter, lihat Memperbarui kredensial cluster.

Contoh:

vCenter:
  credentials:
    fileRef:
      path: "my-config-folder/admin-creds.yaml"

vCenter.credentials.fileRef.entry

Wajib
String

Nama blok kredensial, dalam file konfigurasi kredensial, yang menyimpan nama pengguna dan sandi akun pengguna vCenter Anda.

Anda dapat menggunakan gkectl update untuk memperbarui kolom ini di cluster yang ada.

Untuk mengetahui informasi tentang cara memperbarui kredensial vCenter, lihat Memperbarui kredensial cluster.

Contoh:

vCenter:
  credentials:
    fileRef:
      entry: "vcenter-creds"

vCenter.folder

Opsional
Immutable
String
Default: Folder di seluruh pusat data

Jalur relatif folder vSphere yang telah Anda buat. Folder ini akan menyimpan VM cluster admin Anda.

Jika Anda tidak menentukan nilai, VM cluster admin Anda akan ditempatkan di /.../DATA_CENTER/vm/.

Jika Anda menentukan nilai, nilai tersebut akan relatif terhadap /.../DATA_CENTER/vm/.

Nilainya dapat berupa nama folder.

Contoh:

vCenter:
  folder: "my-folder"

Atau, nilainya dapat berupa jalur relatif yang menyertakan lebih dari satu folder.

Contoh:

vCenter:
  folder: "folders/folder-1"

vCenter.dataDisk

Jangan berikan nilai untuk kolom ini. Hapus kolom atau biarkan sebagai komentar.

network

Wajib
Tidak dapat diubah

Bagian ini berisi informasi tentang jaringan cluster admin Anda.

network.hostConfig

Bagian ini berisi informasi tentang server NTP, server DNS, dan domain penelusuran DNS yang digunakan oleh VM yang merupakan node cluster Anda.

Jika infraConfigFilePath dikonfigurasi, hapus seluruh bagian ini. Jika tidak, bagian ini wajib diisi dan tidak dapat diubah.

network.hostConfig.dnsServers

Wajib jika bagian network.hostConfig diisi.
Tidak dapat diubah
Array string.
Jumlah maksimum elemen dalam array adalah tiga.

Alamat server DNS untuk VM.

Contoh:

network:
  hostConfig:
    dnsServers:
    - "172.16.255.1"
    - "172.16.255.2"

network.hostConfig.ntpServers

Wajib jika bagian network.hostConfig diisi.
Tidak dapat diubah
Array string

Alamat server waktu yang akan digunakan VM.

Contoh:

network:
  hostConfig:
    ntpServers:
    - "216.239.35.0"

network.hostConfig.searchDomainsForDNS

Opsional
Immutable
Array string

Domain penelusuran DNS yang akan digunakan VM. Domain ini digunakan sebagai bagian dari daftar penelusuran domain.

Contoh:

network:
  hostConfig:
    searchDomainsForDNS:
    - "my.local.com"

network.ipMode.type

Immutable
String
Diisi otomatis: "static"
Default: "dhcp"

Jika Anda ingin node cluster mendapatkan alamat IP dari server DHCP, tetapkan ini ke "dhcp". Jika Anda ingin node cluster memiliki alamat IP statis yang dipilih dari daftar yang Anda berikan, tetapkan ini ke "static".

Biasanya, Anda harus menentukan static karena Anda harus selalu menyediakan alamat IP untuk node bidang kontrol cluster admin. DHCP hanya digunakan untuk menyediakan alamat IP dalam kasus berikut:

  • Jika enableControlplaneV2 tidak diaktifkan di cluster pengguna, Anda dapat menggunakan DHCP untuk node bidang kontrol cluster pengguna, yang berada di cluster admin.

  • Di versi 1.16 dan yang lebih rendah, node add-on untuk cluster admin non-HA bisa mendapatkan alamat IP-nya dari DHCP. Di versi 1.28 dan yang lebih tinggi, cluster admin harus berupa HA, dan tidak memiliki node add-on.

Contoh:

network:
  ipMode:
    type: "static"

network.ipMode.ipBlockFilePath

Jalur absolut atau relatif dari file blok IP untuk cluster Anda.

Jika infraConfigFilePath dikonfigurasi, kolom ini wajib diisi.

Kolom ini juga wajib diisi dalam kasus berikut:

  • Cluster admin non-HA 1.16 dan yang lebih rendah: cantumkan alamat IP untuk node bidang kontrol dan node add-on dalam file blok IP.

  • Cluster admin HA 1.16 dan yang lebih rendah: cantumkan alamat IP untuk node add-on dalam file blok IP.

  • Cluster pengguna kubeception versi 1.29 dan yang lebih rendah: cantumkan alamat IP untuk node bidang kontrol cluster pengguna dalam file blok IP cluster admin.

Immutable
String

Contoh:

network:
  ipMode:
    ipBlockFilePath: "/my-config-folder/admin-cluster-ipblock.yaml"

network.serviceCIDR

Wajib
Immutable
String
Rentang terkecil yang memungkinkan: /24
Rentang terbesar yang memungkinkan: /12
Diisi otomatis: "10.96.232.0/24"

Rentang alamat IP, dalam format CIDR, yang akan digunakan untuk Service di cluster Anda.

Contoh:

network:
  serviceCIDR: "10.96.232.0/24"

network.podCIDR

Wajib
Immutable
String
Rentang terkecil yang memungkinkan: /18
Rentang terbesar yang memungkinkan: /8
Diisi otomatis: "192.168.0.0/16"

Rentang alamat IP, dalam format CIDR, yang akan digunakan untuk Pod di cluster Anda.

Contoh:

network:
  podCIDR: "192.168.0.0/16"

Rentang Service tidak boleh tumpang-tindih dengan rentang Pod.

Rentang Service dan Pod tidak boleh tumpang-tindih dengan alamat di luar cluster yang ingin Anda jangkau dari dalam cluster.

Misalnya, rentang Service Anda adalah 10.96.232.0/24, dan rentang Pod Anda adalah 192.168.0.0/16. Setiap traffic yang dikirim dari Pod ke alamat di salah satu rentang tersebut akan diperlakukan sebagai dalam cluster dan tidak akan mencapai tujuan di luar cluster.

Secara khusus, rentang Service dan Pod tidak boleh tumpang-tindih dengan:

  • Alamat IP node di cluster mana pun

  • Alamat IP yang digunakan oleh mesin load balancer

  • VIP yang digunakan oleh node bidang kontrol dan load balancer

  • Alamat IP server vCenter, server DNS, dan server NTP

Sebaiknya rentang Service dan Pod Anda berada dalam ruang alamat RFC 1918.

Berikut adalah salah satu alasan rekomendasi untuk menggunakan alamat RFC 1918. Misalnya, rentang Pod atau Service Anda berisi alamat IP eksternal. Setiap traffic yang dikirim dari Pod ke salah satu alamat eksternal tersebut akan diperlakukan sebagai traffic dalam cluster dan tidak akan mencapai tujuan eksternal.

network.vCenter.networkName

Nama jaringan vSphere untuk node cluster Anda.

Jika infraConfigFilePath dikonfigurasi, hapus kolom ini. Jika tidak, kolom ini wajib diisi dan tidak dapat diubah.

Contoh:

network:
  vCenter:
    networkName: "my-network"

Jika nama berisi karakter khusus, Anda harus menggunakan urutan escape untuk karakter tersebut.

Karakter khusus Urutan escape
Garis miring (/) %2f
Garis miring terbalik (\) %5c
Tanda persen (%) %25

Jika nama jaringan tidak unik di pusat data, Anda dapat menentukan jalur lengkap.

Contoh:

network:
  vCenter:
    networkName: "/data-centers/data-center-1/network/my-network"

network.controlPlaneIPBlock

Informasi jaringan untuk node bidang kontrol cluster admin.

Jika infraConfigFilePath dikonfigurasi, hapus seluruh bagian ini. Jika tidak, bagian ini wajib diisi dan tidak dapat diubah.

network.controlPlaneIPBlock.netmask

Wajib
Immutable
String

Netmask untuk jaringan yang memiliki node bidang kontrol Anda.

Contoh:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

network.controlPlaneIPBlock.gateway

Wajib
Immutable
String

Alamat IP gateway default untuk node bidang kontrol Anda.

Contoh:

network:
  controlPlaneIPBlock:
    gateway: "172.16.22.1"

network.controlPlaneIPBlock.ips

Wajib
Immutable
Array yang terdiri dari tiga objek, masing-masing memiliki alamat IP dan nama host opsional.

Ini adalah alamat IP yang akan ditetapkan ke node bidang kontrol Anda. Nama host diperlukan untuk cluster admin dengan ketersediaan tinggi (HA).

Contoh:

network:
  controlPlaneIPBlock:
    ips:
    - ip: "172.16.22.6"
      hostname: "admin-cp-vm-1"
    - ip: "172.16.22.7"
      hostname: "admin-cp-vm-2"
    - ip: "172.16.22.8"
      hostname: "admin-cp-vm-3"

infraConfigFilePath

1,31

Menentukan jalur di kolom ini akan mengaktifkan domain topologi.

Pratinjau
Opsional
String
Dapat diubah

Tentukan jalur lengkap file konfigurasi infrastruktur vSphere.

Contoh:

infraConfigFilePath: "/my-config-folder/vsphere-infrastructure.yaml"

Selain menambahkan jalur, salin file konfigurasi infrastruktur vSphere ke direktori yang berlaku.

Jika menambahkan jalur ke infraConfigFilePath, Anda perlu melakukan perubahan berikut pada file konfigurasi cluster admin dan cluster pengguna.

Perubahan file konfigurasi cluster admin

  • Hapus hal berikut dari file konfigurasi cluster admin Anda. Anda mengonfigurasi informasi ini di file konfigurasi infrastruktur vSphere per domain topologi.

    • vCenter: hapus seluruh bagian vCenter.
    • network.hostConfig: hapus seluruh bagian network.hostConfig.
    • network.vCenter.networkName: hapus kolom ini.

  • Buat perubahan berikut dalam file konfigurasi cluster admin Anda:

    • network.controlPlaneIPBlock: hapus seluruh bagian. Sebagai gantinya, tentukan alamat IP untuk node bidang kontrol cluster admin dalam file blok IP.

    • preparedSecrets: hapus kolom ini. Kredensial yang disiapkan tidak didukung saat domain topologi diaktifkan. Hapus kolom ini.

  • Kolom berikut wajib diisi:

Perubahan file konfigurasi cluster pengguna

  • Hapus hal berikut dari file konfigurasi cluster pengguna Anda. Anda mengonfigurasi informasi ini di file konfigurasi infrastruktur vSphere per domain topologi.

    • vCenter: hapus seluruh bagian vCenter.
    • network.hostConfig: hapus seluruh bagian network.hostConfig.
    • network.vCenter.networkName: hapus kolom ini.
    • masterNode.vsphere: hapus seluruh bagian.
    • nodePools[i].vsphere.datastore dan nodePools[i].vsphere.storagePolicyName: hapus kolom ini.

  • Buat perubahan berikut dalam file konfigurasi cluster pengguna Anda:

    • network.controlPlaneIPBlock: hapus seluruh bagian. Sebagai gantinya, tentukan alamat IP untuk node bidang kontrol cluster admin dalam file blok IP.

    • preparedSecrets: hapus kolom ini. Kredensial yang disiapkan tidak didukung saat domain topologi diaktifkan.

    • nodePools[i].vsphere.hostgroups: hapus kolom ini. Pada versi 1.32.200 dan 1.33 serta yang lebih baru, gunakan topologyDomains[i].compute.hostGroups untuk mengonfigurasi afinitas host VM untuk setiap domain topologi dalam file konfigurasi infrastruktur vSphere.

    • multipleNetworkInterfaces: tetapkan kolom ini ke false. Beberapa antarmuka jaringan untuk Pod tidak didukung jika domain topologi diaktifkan.

    • storage.vSphereCSIDisabled: tetapkan kolom ini ke true untuk menonaktifkan deployment komponen CSI vSphere

  • Kolom berikut wajib diisi:

    • enableAdvancedCluster: ditetapkan ke true dalam file konfigurasi cluster pengguna.

    • network.ipMode.ipBlockFilePath: ditetapkan ke jalur lengkap atau relatif dari file blok IP cluster pengguna.

    • loadBalancer.kind: tetapkan ke "ManualLB". "ManualLB" adalah satu-satunya opsi load balancing multi-subnet (lapisan 3) yang tersedia yang ditawarkan Google Distributed Cloud.

1.30 dan yang lebih lama

Tidak tersedia.

loadBalancer

Bagian ini berisi informasi tentang load balancer untuk cluster admin Anda.

loadBalancer.vips.controlPlaneVIP

Wajib
Immutable
String

Alamat IP yang telah Anda pilih untuk dikonfigurasi pada load balancer untuk server Kubernetes API cluster admin.

Contoh:

loadBalancer:
  vips:
    controlplaneVIP: "203.0.113.3"

loadBalancer.kind

Tentukan jenis load balancer yang akan digunakan.

1.32 dan yang lebih baru

Wajib
Immutable
String
Diisi otomatis: "MetalLB"

Jenis load balancer yang dapat Anda gunakan bergantung pada apakah Anda akan menyiapkan cluster untuk menggunakan domain topologi. Cluster diasumsikan menggunakan domain topologi jika kolom infraConfigFilePath dikonfigurasi.

  • Dengan domain topologi: tetapkan ini ke "ManualLB". Anda harus mengonfigurasi load balancer pihak ketiga (seperti F5 BIG-IP atau Citrix) jika ingin menggunakan domain topologi.

  • Tanpa domain topologi: tetapkan ini ke "ManualLB" atau "MetalLB". Gunakan "ManualLB" jika Anda memiliki load balancer pihak ketiga atau "MetalLB" untuk solusi paket kami.

Jika enableAdvancedCluster ditetapkan ke true (cluster lanjutan diaktifkan), jenis load balancer untuk node bidang kontrol ditentukan oleh adminMaster.controlPlaneLoadBalancer.

Contoh:

loadBalancer:
  kind: "MetalLB"

1,31

Wajib
Immutable
String
Diisi otomatis: "MetalLB"

Jenis load balancer yang dapat Anda gunakan bergantung pada apakah Anda akan menyiapkan cluster untuk menggunakan domain topologi. Cluster diasumsikan menggunakan domain topologi jika kolom infraConfigFilePath dikonfigurasi.

  • Dengan domain topologi: tetapkan ini ke "ManualLB". Anda harus mengonfigurasi load balancer pihak ketiga (seperti F5 BIG-IP atau Citrix) jika ingin menggunakan domain topologi.

  • Tanpa domain topologi: tetapkan ini ke "ManualLB" atau "MetalLB". Gunakan "ManualLB" jika Anda memiliki load balancer pihak ketiga atau "MetalLB" untuk solusi paket kami.

Contoh:

loadBalancer:
  kind: "MetalLB"

1,30

Wajib
Immutable
String
Diisi otomatis: "MetalLB"

Tetapkan ke "ManualLB" atau "MetalLB". Gunakan "ManualLB" jika Anda memiliki load balancer pihak ketiga (seperti F5 BIG-IP atau Citrix) atau "MetalLB" untuk solusi paket kami.

Perhatikan perbedaan berikut dari versi sebelumnya:

  • Di versi 1.30 dan yang lebih tinggi, nilai "F5BigIP" tidak diizinkan untuk cluster admin baru.

  • Di versi 1.28 dan yang lebih baru, nilai "Seesaw" tidak diizinkan untuk cluster admin baru.

Jika Anda sudah memiliki cluster yang menggunakan load balancer ini, lihat Merencanakan migrasi cluster ke fitur yang direkomendasikan.

Contoh:

loadBalancer:
  kind: "MetalLB"

1.29 dan 1.28

Wajib
Immutable
String
Diisi otomatis: "MetalLB"

Tetapkan ke "ManualLB", "F5BigIP", atau "MetalLB"

Untuk mengaktifkan fitur baru dan lanjutan, sebaiknya gunakan "ManualLB" jika Anda memiliki load balancer pihak ketiga (seperti F5 BIG-IP atau Citrix) atau "MetalLB" untuk solusi paket kami.

Di versi 1.28 dan yang lebih tinggi, nilai "Seesaw" tidak diizinkan untuk cluster admin baru. Jika Anda sudah memiliki cluster yang menggunakan load balancer Seesaw, lihat Bermigrasi dari load balancer Seesaw ke MetalLB.

Contoh:

loadBalancer:
  kind: "MetalLB"

1.16 dan yang lebih lama

Wajib
Immutable
String
Diisi otomatis: "MetalLB"

String. Tetapkan ini ke "ManualLB", "F5BigIP", "Seesaw", atau "MetalLB"

Jika Anda menetapkan adminMaster.replicas ke 3, Anda tidak dapat menggunakan load balancer Seesaw.

Contoh:

loadBalancer:
  kind: "MetalLB"

Saat Anda membuat cluster pengguna menggunakan konsol Google Cloud , gcloud CLI, atau Terraform, jenis load balancer untuk cluster admin dan cluster penggunanya harus sama. Satu-satunya pengecualian adalah jika cluster admin menggunakan Seesaw, maka cluster pengguna dapat menggunakan MetalLB. Jika Anda ingin cluster admin dan pengguna menggunakan berbagai jenis load balancer, Anda harus membuat cluster pengguna menggunakan alat command line gkectl.

loadBalancer.manualLB

Jika Anda menetapkan loadbalancer.kind ke "ManualLB", isi bagian ini. Jika tidak, hapus bagian ini.
Immutable

loadBalancer.manualLB.ingressHTTPNodePort

Hapus kolom ini dari file konfigurasi Anda. Ini tidak digunakan dalam cluster admin.

loadBalancer.manualLB.ingressHTTPSNodePort

Hapus kolom ini dari file konfigurasi Anda. Ini tidak digunakan dalam cluster admin.

loadBalancer.manualLB.konnectivityServerNodePort

Hapus kolom ini dari file konfigurasi Anda. Fitur ini tidak digunakan di cluster admin.

loadBalancer.f5BigIP

1.30 dan yang lebih baru

Di versi 1.30 dan yang lebih tinggi, nilai "F5BigIP" tidak diizinkan untuk loadbalancer.kind untuk cluster admin baru. Jika bagian loadBalancer.f5BigIP ada dalam file konfigurasi, hapus atau jadikan sebagai komentar.

Anda masih dapat menggunakan load balancer F5 BIG-IP dengan cluster admin baru, tetapi konfigurasinya berbeda. Untuk mengetahui detail konfigurasi, lihat Mengaktifkan mode load balancing manual.

Jika cluster yang ada telah mengonfigurasi bagian ini, upgrade ke versi 1.32 akan diblokir. Anda harus memigrasikan cluster ke fitur yang direkomendasikan sebelum mengupgrade ke versi 1.32.

1,29

Jika Anda menetapkan loadbalancer.kind ke "F5BigIP", isi bagian ini. Jika tidak, hapus bagian ini.

Untuk mengaktifkan fitur baru dan lanjutan, sebaiknya konfigurasikan load balancing manual untuk load balancer F5 BIG-IP Anda. Untuk mengaktifkan load balancing manual, tetapkan loadbalancer.kind ke "ManualLB" dan isi bagian loadBalancer.manualLB. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan mode load balancing manual.

Jika Anda sudah memiliki load balancer F5-BIG-IP dan konfigurasi cluster menggunakan bagian ini, setelah mengupgrade ke versi 1.29 atau yang lebih tinggi, sebaiknya migrasikan ke load balancing manual.

1.28 dan yang lebih lama

Jika Anda menetapkan loadbalancer.kind ke "F5BigIP", isi bagian ini. Jika tidak, hapus bagian ini.

Untuk mengaktifkan fitur baru dan lanjutan, sebaiknya konfigurasikan load balancing manual untuk load balancer F5 BIG-IP Anda. Untuk mengaktifkan load balancing manual, tetapkan loadbalancer.kind ke "ManualLB" dan isi bagian loadBalancer.manualLB. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan mode load balancing manual.

loadBalancer.f5BigIP.address

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Wajib jika loadBalancer.kind = "F5BigIp"
Immutable
String

Alamat load balancer F5 BIG-IP Anda. Contoh:

loadBalancer:
  f5BigIP:
    address: "203.0.113.2"

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = "F5BigIp"
Immutable
String

Alamat load balancer F5 BIG-IP Anda. Contoh:

loadBalancer:
  f5BigIP:
    address: "203.0.113.2"

loadBalancer.f5BigIP.credentials.fileRef.path

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Diperlukan jika loadBalancer.kind = "F5BigIp"
Dapat diubah
String

Jalur file konfigurasi kredensial yang menyimpan nama pengguna dan sandi akun yang dapat digunakan Google Distributed Cloud untuk terhubung ke load balancer F5 BIG-IP Anda.

Akun pengguna harus memiliki peran pengguna yang memiliki izin yang memadai untuk menyiapkan dan mengelola load balancer. Peran Administrator atau peran Resource Administrator sudah cukup.

Anda dapat menggunakan gkectl update untuk memperbarui kolom ini di cluster yang ada.

Untuk mengetahui informasi tentang cara memperbarui kredensial F5 BIG-IP, lihat Memperbarui kredensial cluster.

Contoh:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        path: "my-config-folder/admin-creds.yaml"

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = "F5BigIp"
Dapat diubah
String

Jalur file konfigurasi kredensial yang menyimpan nama pengguna dan sandi akun yang dapat digunakan Google Distributed Cloud untuk terhubung ke load balancer F5 BIG-IP Anda.

Akun pengguna harus memiliki peran pengguna yang memiliki izin yang memadai untuk menyiapkan dan mengelola load balancer. Peran Administrator atau peran Resource Administrator sudah cukup.

Anda dapat menggunakan gkectl update untuk memperbarui kolom ini di cluster yang ada.

Untuk mengetahui informasi tentang cara memperbarui kredensial F5 BIG-IP, lihat Memperbarui kredensial cluster.

Contoh:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        path: "my-config-folder/admin-creds.yaml"

loadBalancer.f5BigIP.credentialsfileRef.entry

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Diperlukan jika loadBalancer.kind = "F5BigIp"
Dapat diubah
String

Nama blok kredensial, dalam file konfigurasi kredensial, yang menyimpan nama pengguna dan sandi akun F5 BIG-IP Anda.

Anda dapat menggunakan gkectl update untuk memperbarui kolom ini di cluster yang ada.

Untuk mengetahui informasi tentang cara memperbarui kredensial F5 BIG-IP, lihat Memperbarui kredensial cluster.

Contoh:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        entry: "f5-creds"

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = "F5BigIp"
Dapat diubah
String

Nama blok kredensial, dalam file konfigurasi kredensial, yang menyimpan nama pengguna dan sandi akun F5 BIG-IP Anda.

Anda dapat menggunakan gkectl update untuk memperbarui kolom ini di cluster yang ada.

Untuk mengetahui informasi tentang cara memperbarui kredensial F5 BIG-IP, lihat Memperbarui kredensial cluster.

Contoh:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        entry: "f5-creds"

loadBalancer.f5BigIP.partition

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Wajib jika loadBalancer.kind = "F5BigIp"
Immutable
String

Nama partisi BIG-IP yang Anda buat untuk cluster admin.

Contoh:

loadBalancer:
  f5BigIP:
    partition: "my-f5-admin-partition"

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = "F5BigIp"
Immutable
String

Nama partisi BIG-IP yang Anda buat untuk cluster admin.

Contoh:

loadBalancer:
  f5BigIP:
    partition: "my-f5-admin-partition"

loadBalancer.f5BigIP.snatPoolName

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Opsional
Relevan jika loadBalancer.kind = "F5BigIp"
Immutable
String

Jika Anda menggunakan SNAT, nama pool SNAT Anda. Jika Anda tidak menggunakan SNAT, hapus kolom ini.

Contoh:

loadBalancer:
  f5BigIP:
    snatPoolName: "my-snat-pool"

1.29 dan yang lebih rendah

Opsional
Relevan jika loadBalancer.kind = "F5BigIp"
Immutable
String

Jika Anda menggunakan SNAT, nama pool SNAT Anda. Jika Anda tidak menggunakan SNAT, hapus kolom ini.

Contoh:

loadBalancer:
  f5BigIP:
    snatPoolName: "my-snat-pool"

loadBalancer.seesaw

Jangan gunakan bagian ini. Load balancer Seesaw tidak didukung untuk cluster admin baru di versi 1.28 dan yang lebih baru. Sebagai gantinya, sebaiknya Anda mengonfigurasi load balancer MetalLB untuk cluster admin baru. Untuk informasi selengkapnya tentang cara mengonfigurasi MetalLB, lihat Load balancing yang dipaketkan dengan MetalLB.

Meskipun kami masih mendukung Seesaw untuk cluster admin non-HA yang telah diupgrade, sebaiknya Anda bermigrasi ke MetalLB.

antiAffinityGroups.enabled

Opsional
Dapat diubah
Boolean
Diisi otomatis: true

Tetapkan ke true untuk mengaktifkan pembuatan aturan DRS. Jika tidak, tetapkan ke false.

Jika kolom ini adalah true, Google Distributed Cloud akan membuat aturan anti-afinitas Distributed Resource Scheduler (DRS) VMware untuk node cluster admin Anda, sehingga node tersebut tersebar di setidaknya tiga host ESXi fisik di pusat data Anda.

Fitur ini mengharuskan lingkungan vSphere Anda memenuhi kondisi berikut:

  • VMware DRS diaktifkan. VMware DRS memerlukan edisi lisensi vSphere Enterprise Plus.

  • Akun pengguna vSphere Anda memiliki hak istimewa Host.Inventory.Modify cluster.

  • Tersedia minimal empat host ESXi.

Meskipun aturan mengharuskan node cluster tersebar di tiga host ESXi, kami sangat menyarankan agar Anda memiliki setidaknya empat host ESXi yang tersedia. Tindakan ini melindungi Anda dari kehilangan bidang kontrol cluster admin. Misalnya, Anda hanya memiliki tiga host ESXi, dan node bidang kontrol cluster admin berada di host ESXi yang gagal. Aturan DRS akan mencegah node bidang kontrol ditempatkan di salah satu dari dua host ESXi yang tersisa.

Ingat bahwa jika Anda memiliki lisensi vSphere Standard, Anda tidak dapat mengaktifkan VMware DRS.

Jika Anda tidak mengaktifkan DRS, atau jika Anda tidak memiliki setidaknya empat host tempat VM vSphere dapat dijadwalkan, tetapkan antiAffinityGroups.enabled ke false.

Perhatikan batasan berikut terkait cluster lanjutan:

  • Versi 1.31: jika kolom enableAdvancedCluster adalah true, aturan anti-afinitas tidak didukung di cluster lanjutan, dan Anda harus menetapkan antiAffinityGroups.enabled ke false.

  • Versi 1.32: aturan anti-afinitas didukung di cluster lanjutan.

Contoh:

antiAffinityGroups:
  enabled: true

adminMaster

Tidak dapat diubah

Setelan konfigurasi untuk node bidang kontrol di cluster admin.

adminMaster.controlPlaneLoadBalancer

1.32 dan yang lebih baru

Secara opsional, sertakan bagian ini untuk menentukan jenis load balancer yang akan digunakan untuk traffic bidang kontrol di cluster admin. Sertakan adminMaster.controlPlaneLoadBalancer.mode dalam file konfigurasi Anda jika Anda ingin secara eksplisit menetapkan jenis load balancer yang akan digunakan, bukan mengandalkan nilai default. Selain itu, Anda harus menetapkan loadBalancer.kind dalam file konfigurasi meskipun kolom tersebut tidak beroperasi di 1.32 dan yang lebih tinggi.

adminMaster.controlPlaneLoadBalancer.mode

Opsional
Immutable
String
Default: Bergantung pada apakah cluster menggunakan domain topologi

Jenis load balancer yang dapat Anda gunakan bergantung pada apakah Anda akan menyiapkan cluster untuk menggunakan domain topologi. Cluster diasumsikan menggunakan domain topologi jika kolom infraConfigFilePath dikonfigurasi.

  • Dengan domain topologi: tentukan "manual", yang merupakan nilai default. Anda harus mengonfigurasi load balancer pihak ketiga (seperti F5 BIG-IP atau Citrix) jika ingin menggunakan domain topologi.

  • Tanpa domain topologi: tentukan "manual" atau "bundled". Gunakan "manual" jika Anda memiliki load balancer pihak ketiga atau "bundled" untuk solusi paket kami, yang menggunakan keepalived + haproxy yang berjalan di tiga node bidang kontrol cluster admin. Nilai defaultnya adalah "bundled".

Contoh:

adminMaster:
  controlPlaneLoadBalancer:
    mode: "manual"

1.31 dan yang lebih lama

Bagian ini tidak tersedia. Sebagai gantinya, gunakan loadBalancer.kind untuk menentukan jenis load balancer yang akan digunakan cluster admin.

adminMaster.cpus

Pratinjau
Opsional
Immutable
Bilangan bulat
Diisi otomatis: 4
Default: 4

Jumlah vCPU untuk setiap node bidang kontrol di cluster admin.

Contoh:

adminMaster:
  cpus: 4

adminMaster.memoryMB

Pratinjau
Opsional
Immutable
Bilangan bulat
Diisi otomatis: 16384
Default: 16384

Jumlah mebibyte memori untuk setiap node bidang kontrol di cluster admin.

Contoh:

adminMaster:
  memoryMB: 16384

adminMaster.replicas

1.28 dan yang lebih tinggi

Wajib untuk cluster baru
Tidak dapat diubah
Bilangan bulat
Nilai yang mungkin: 3

Jumlah node bidang kontrol di cluster admin. Di versi 1.28 dan yang lebih tinggi, cluster admin baru harus memiliki ketersediaan tinggi (HA). Tetapkan kolom ini ke 3 untuk membuat cluster admin dengan ketersediaan tinggi (HA) yang memiliki 3 node bidang kontrol.

Contoh:

adminMaster:
  replicas: 3

1.16 dan yang lebih lama

Opsional
Immutable
Bilangan bulat
Nilai yang mungkin: 1 atau 3
Diisi otomatis: 1
Default: 1

Jumlah node bidang kontrol di cluster admin. Tetapkan ke 3 jika Anda ingin membuat cluster admin dengan ketersediaan tinggi. Jika tidak, tetapkan ke 1.

Jika Anda menetapkannya ke 3, Anda juga harus mengisi bagian network.controlPlaneIPBlock dan bagian network.hostConfig.

Jika Anda menyetelnya ke 3, Anda tidak dapat menggunakan load balancer Seesaw.

Contoh:

adminMaster:
  replicas: 3

adminMaster.topologyDomains

1.32 dan yang lebih baru

Pratinjau
Opsional
Array string | Mengizinkan satu elemen atau tiga elemen berbeda
Immutable
Default: vSphereInfraConfig.defaultTopologyDomain jika ditentukan dalam file konfigurasi infrastruktur vSphere

Array domain topologi. Jika infraConfigFilePath dikonfigurasi (yang menunjukkan cluster akan menggunakan domain topologi), sertakan kolom ini secara opsional. Jumlah domain topologi dalam array menentukan cara node bidang kontrol cluster admin di-deploy, sebagai berikut:

  • Satu elemen: ketiga node bidang kontrol cluster admin akan di-deploy di domain topologi yang ditentukan.
  • Tiga elemen: setiap node bidang kontrol cluster admin akan di-deploy di domain topologi yang berbeda (yaitu, satu node per domain topologi).

1.31 dan yang lebih baru

Hanya tersedia untuk cluster baru
Pratinjau
Array string | Hanya mengizinkan satu elemen
Opsional
Immutable
Default: vSphereInfraConfig.defaultTopologyDomain jika ditentukan dalam file konfigurasi infrastruktur vSphere

Array domain topologi. Jika infraConfigFilePath dikonfigurasi (yang menunjukkan cluster akan menggunakan domain topologi), sertakan kolom ini secara opsional. Node bidang kontrol cluster admin akan di-deploy di domain topologi yang ditentukan.

1.30 dan yang lebih lama

Tidak tersedia.

addonNode.autoResize.enabled

1.28 dan yang lebih tinggi

Jangan sertakan setelan ini dalam file konfigurasi Anda saat membuat cluster baru. Cluster admin yang dibuat di versi 1.28 dan yang lebih tinggi harus memiliki ketersediaan tinggi (HA) dengan tiga node bidang kontrol. Di versi 1.28 dan yang lebih tinggi, cluster admin dengan ketersediaan tinggi (HA) tidak memiliki node add-on.

1.16 dan yang lebih lama

Opsional
Dapat diubah
Boolean
Diisi otomatis: false
Default: false

Tetapkan ke true untuk mengaktifkan pengubahan ukuran otomatis node add-on di cluster admin. Jika tidak, tetapkan ke false.

Untuk memperbarui nilai kolom ini, gunakan gkectl update admin.

Contoh:

addonNode:
  autoResize:
    enabled: true

proxy

Jika jaringan Anda berada di balik server proxy, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar. Server proxy yang Anda tentukan di sini digunakan oleh cluster pengguna yang dikelola oleh cluster admin ini.
Tidak dapat diubah

proxy.url

Wajib jika bagian proxy diisi.
Tidak dapat diubah
String

Alamat HTTP server proxy Anda. Sertakan nomor port meskipun sama dengan port default skema.

Contoh:

proxy:
  url: "http://my-proxy.example.local:80"

Server proxy yang Anda tentukan di sini digunakan oleh cluster Google Distributed Cloud Anda. Selain itu, workstation admin Anda otomatis dikonfigurasi untuk menggunakan server proxy yang sama ini, kecuali jika Anda menetapkan variabel lingkungan HTTPS_PROXY di workstation admin.

Jika Anda menentukan proxy.url, Anda juga harus menentukan proxy.noProxy.

Setelah konfigurasi proxy untuk cluster admin ditetapkan, konfigurasi tersebut tidak dapat diubah atau dihapus, kecuali jika cluster dibuat ulang.

proxy.noProxy

Opsional
Immutable
String

Daftar alamat IP, rentang alamat IP, nama host, dan nama domain yang dipisahkan koma yang tidak boleh melewati server proxy. Saat Google Distributed Cloud mengirim permintaan ke salah satu alamat, host, atau domain ini, permintaan tersebut akan dikirim secara langsung.

Contoh:

proxy:
  noProxy: "10.151.222.0/24,my-host.example.local,10.151.2.1"

privateRegistry

Registry container pribadi adalah registry yang membatasi akses ke image container hanya untuk pengguna yang diautentikasi. Isi bagian ini jika cluster pengguna Anda perlu mengakses image workload. Saat Anda mengonfigurasi bagian privateRegistry, semua cluster pengguna yang dikelola oleh cluster admin ini akan mengambil image workload dari registry pribadi yang Anda konfigurasi di sini.

Jika Anda mengonfigurasi bagian privateRegistry, saat Anda menjalankan gkectl prepare sebelum pembuatan atau upgrade cluster, gkectl akan mengirim image sistem Google Distributed Cloud ke registry pribadi. Selama pembuatan atau upgrade cluster, image sistem diambil dari registry pribadi. Jika Anda tidak mengonfigurasi bagian privateRegistry, image sistem akan ditarik dari gcr.io/gke-on-prem-release menggunakan akun layanan akses komponen.

Anda mungkin ingin mengonfigurasi bagian privateRegistry agar cluster mengambil image sistem dari registry pribadi, bukan gcr.io/gke-on-prem-release, dalam kasus berikut:

  • Anda perlu meminimalkan koneksi ke Google Cloud karena masalah keamanan atau persyaratan peraturan.
  • Organisasi Anda mewajibkan traffic keluar melewati server proxy, dan kecepatan jaringan untuk terhubung ke Google Cloud lambat.

Jika Anda ingin menggunakan Artifact Registry Google sebagai registry pribadi, lihat Menggunakan Artifact Registry sebagai registry pribadi untuk image workload untuk mengetahui langkah-langkah konfigurasinya.

privateRegistry.address

Wajib untuk registry pribadi
Immutable
String

Alamat IP atau FQDN (Nama Domain yang Sepenuhnya Memenuhi Syarat) dari mesin yang menjalankan registry pribadi Anda.

Contoh:

privateRegistry:
  address: "203.0.113.10"

privateRegistry:
  address: "fqdn.example.com"

privateRegistry.credentials.fileRef.path

Wajib untuk registry pribadi
Dapat diubah
String

Jalur file konfigurasi kredensial yang menyimpan nama pengguna dan sandi akun yang dapat digunakan Google Distributed Cloud untuk mengakses registry pribadi Anda.

Contoh:

privateRegistry:
  credentials:
    fileRef:
      path: "my-config-folder/admin-creds.yaml"

privateRegistry.credentials.fileRef.entry

Wajib untuk registry pribadi
Dapat diubah
String

Nama blok kredensial, dalam file konfigurasi kredensial, yang menyimpan nama pengguna dan sandi akun registry pribadi Anda.

privateRegistry:
  credentials:
    fileRef:
      entry: "private-registry-creds"

privateRegistry.caCertPath

Wajib untuk registry pribadi
Dapat diubah
String

Saat runtime container mengambil image dari registry pribadi Anda, registry tersebut harus membuktikan identitasnya dengan menunjukkan sertifikat. Sertifikat registry ditandatangani oleh certificate authority (CA). Runtime container menggunakan sertifikat CA untuk memvalidasi sertifikat registry.

Tetapkan kolom ini ke jalur sertifikat CA.

Contoh:

privateRegistry:
  caCertPath: "my-cert-folder/registry-ca.crt"

componentAccessServiceAccountKeyPath

Wajib
Dapat diubah
String

Jalur file kunci JSON untuk akun layanan akses komponen Anda.

Contoh:

componentAccessServiceAccountKeyPath: "my-key-folder/access-key.json"

gkeConnect

Wajib
Dapat diubah

Saat Anda mengisi bagian gkeConnect, cluster admin akan otomatis didaftarkan ke fleet setelah dibuat. Bagian ini berisi informasi tentang project dan akun layanan Google Cloud yang diperlukan untuk mendaftarkan cluster.

Selama pembuatan atau update cluster, beberapa kebijakan RBAC dikonfigurasi di cluster admin. Kebijakan RBAC ini diperlukan agar Anda dapat membuat cluster pengguna di konsol Google Cloud .

gkeConnect.projectID

Wajib
Immutable
String

ID project host fleet Anda. Untuk cluster baru, project ID ini harus sama dengan ID yang ditetapkan di stackdriver.projectID dan cloudAuditLogging.projectID. Jika project ID tidak sama, pembuatan cluster akan gagal. Persyaratan ini tidak berlaku untuk cluster yang ada.

Contoh:

gkeConnect:
  projectID: "my-fleet-host-project"

gkeConnect.location

Opsional
Immutable
String
Default: global

Keanggotaan fleet setiap cluster dikelola oleh layanan Fleet (gkehub.googleapis.com) dan layanan Connect (gkeconnect.googleapis.com). Lokasi layanan dapat bersifat global atau regional. Di versi 1.28 dan yang lebih baru, Anda dapat menentukan region tempat Fleet dan layanan Connect berjalan. Google CloudJika tidak ditentukan, instance global layanan akan digunakan. Perhatikan hal berikut:

  • Cluster admin yang dibuat sebelum versi 1.28 dikelola oleh layanan Fleet dan Connect global.

  • Untuk cluster baru, jika Anda menyertakan kolom ini, region yang Anda tentukan harus sama dengan region yang dikonfigurasi di cloudAuditLogging.clusterLocation, stackdriver.clusterLocation, dan gkeOnPremAPI.location. Jika regionnya tidak sama, pembuatan cluster akan gagal.

Contoh:

gkeConnect:
  location: "us-central1"

gkeConnect.registerServiceAccountKeyPath

Wajib
Dapat diubah
String

Jalur file kunci JSON untuk akun layanan connect-register Anda.

Contoh:

gkeConnect:
  registerServiceAccountKeyPath: "my-key-folder/connect-register-key.json"

gkeOnPremAPI

Opsional

Di versi 1.16 dan yang lebih baru, jika GKE On-Prem API diaktifkan di projectGoogle Cloud Anda, semua cluster dalam project akan terdaftar di GKE On-Prem API secara otomatis di region yang dikonfigurasi di stackdriver.clusterLocation.

  • Jika Anda ingin mendaftarkan semua cluster dalam project di GKE On-Prem API, pastikan untuk melakukan langkah-langkah di bagian Sebelum memulai untuk mengaktifkan dan menggunakan GKE On-Prem API dalam project.

  • Jika Anda tidak ingin mendaftarkan cluster di GKE On-Prem API, sertakan bagian ini dan tetapkan gkeOnPremAPI.enabled ke false. Jika Anda tidak ingin mendaftarkan cluster apa pun dalam project, nonaktifkan gkeonprem.googleapis.com (nama layanan untuk GKE On-Prem API) dalam project. Untuk mengetahui petunjuknya, lihat Menonaktifkan layanan.

Dengan mendaftarkan cluster admin di GKE On-Prem API, Anda dapat menggunakan alat standar—konsol Google Cloud , Google Cloud CLI, atau Terraform—untuk mengupgrade cluster pengguna yang dikelola cluster admin. Dengan mendaftarkan cluster, Anda juga dapat menjalankan perintah gcloud untuk mendapatkan informasi tentang cluster Anda.

Setelah Anda menambahkan bagian ini dan membuat atau mengupdate cluster admin, jika kemudian Anda menghapus bagian tersebut dan mengupdate cluster, update akan gagal.

gkeOnPremAPI.enabled

Wajib jika bagian gkeOnPremAPI disertakan.
Dapat diubah
Boolean
Default: true

Secara default, cluster didaftarkan di GKE On-Prem API jika GKE On-Prem API diaktifkan di project Anda. Tetapkan ke false jika Anda tidak ingin mendaftarkan cluster.

Setelah cluster didaftarkan di GKE On-Prem API, jika Anda perlu membatalkan pendaftaran cluster, lakukan perubahan berikut, lalu update cluster:

gkeOnPremAPI:
  enabled: false

gkeOnPremAPI.location

Immutable
String
Default:stackdriver.clusterLocation

Region Google Cloud tempat GKE On-Prem API berjalan dan menyimpan metadata cluster. Pilih salah satu wilayah yang didukung. Anda harus menggunakan region yang sama dengan yang dikonfigurasi di cloudAuditLogging.clusterLocation, gkeConnect.location, dan stackdriver.clusterLocation. Jika gkeOnPremAPI.enabled adalah false, jangan sertakan kolom ini.

stackdriver

Wajib
Dapat diubah

stackdriver.projectID

Diperlukan untuk Logging dan Monitoring
Immutable
String

ID project host fleet Anda. Untuk cluster baru, project ID ini harus sama dengan ID yang ditetapkan di gkeConnect.projectID dan cloudAuditLogging.projectID. Jika project ID tidak sama, pembuatan cluster akan gagal. Persyaratan ini tidak berlaku untuk cluster yang ada.

Jika perlu, Anda dapat mengonfigurasi router log di project ini untuk merutekan log ke bucket log di project lain. Untuk mengetahui informasi tentang cara mengonfigurasi router log, lihat Tujuan yang didukung.

Contoh:

stackdriver:
  projectID: "my-fleet-host-project"

stackdriver.clusterLocation

Diperlukan untuk Logging dan Monitoring
Immutable
String
Diisi otomatis: "us-central1"

Region Google Cloud tempat Anda ingin merutekan dan menyimpan metrik Cloud Monitoring. Sebaiknya pilih region yang dekat dengan pusat data lokal Anda.

Anda menentukan perutean log Cloud Logging dan lokasi penyimpanan di konfigurasi Router Log. Untuk mengetahui informasi selengkapnya tentang perutean log, lihat Ringkasan perutean dan penyimpanan.

Stackdriver Operator (stackdriver-operator) melampirkan nilai dari kolom ini ke setiap entri log dan metrik sebelum dirutekan ke Google Cloud. Label yang dilampirkan ini dapat berguna untuk memfilter log dan metrik Anda di Logs Explorer dan Metrics Explorer.

Untuk cluster baru, jika Anda menyertakan bagian gkeOnPremAPI dan cloudAuditLogging dalam file konfigurasi, region yang Anda tetapkan di sini harus sama dengan region yang Anda tetapkan di cloudAuditLogging.clusterLocation, gkeConnect.location, dan gkeOnPremAPI.location. Jika region tidak sama, pembuatan cluster akan gagal.

Contoh:

stackdriver:
  clusterLocation: "us-central1"

stackdriver.serviceAccountKeyPath

Diperlukan untuk Logging dan Pemantauan
Dapat diubah
String

Jalur file kunci JSON untuk akun layanan logging-monitoring Anda.

Jika Anda akan membuat cluster dengan enableAdvancedCluster yang ditetapkan ke true (yang diperlukan untuk menyiapkan domain topologi), maka stackdriver.serviceAccountKeyPath harus sama dengan cloudAuditLogging.serviceAccountKeyPath.

Untuk mengetahui informasi tentang cara memperbarui kolom ini di cluster yang ada, lihat Merotasi kunci akun layanan.

Contoh:

stackdriver:
  serviceAccountKeyPath: "my-key-folder/log-mon-key.json"

stackdriver.disableVsphereResourceMetrics

Opsional
Dapat diubah
Relevan untuk Logging dan Monitoring
Boolean
Diisi otomatis: false
Default: false

Tetapkan ke true untuk menonaktifkan pengumpulan metrik dari vSphere. Jika tidak, tetapkan ke false.

Bagian ini diperlukan di cluster admin jika Anda ingin mengelola siklus proses cluster pengguna di konsol Google Cloud .

Contoh:

stackdriver:
  disableVsphereResourceMetrics: true

cloudAuditLogging

Jika Anda ingin mengintegrasikan log audit dari server Kubernetes API cluster Anda dengan Cloud Audit Logs, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.
Dapat diubah

Bagian ini diperlukan di cluster admin jika Anda ingin mengelola siklus proses cluster pengguna menggunakan klien GKE On-Prem API.

cloudAuditLogging.projectID

Diperlukan untuk Cloud Audit Logs
Immutable
String

ID project host fleet Anda. Untuk cluster baru, project ID ini harus sama dengan ID yang ditetapkan di gkeConnect.projecID dan stackdriver.projectID. Jika project ID tidak sama, pembuatan cluster akan gagal. Persyaratan ini tidak berlaku untuk cluster yang ada.

Jika perlu, Anda dapat mengonfigurasi router log di project ini untuk merutekan log ke bucket log di project lain. Untuk mengetahui informasi tentang cara mengonfigurasi router log, lihat Tujuan yang didukung.

Contoh:

cloudAuditLogging:
  projectID: "my-fleet-host-project"

cloudAuditLogging.clusterLocation

Diperlukan untuk Cloud Audit Logs
Immutable
String

Region Google Cloud tempat Anda ingin menyimpan log audit. Sebaiknya pilih region yang dekat dengan pusat data lokal Anda

Untuk cluster baru, jika Anda menyertakan bagian gkeOnPremAPI dan stackdriver dalam file konfigurasi, region yang Anda tetapkan di sini harus sama dengan region yang Anda tetapkan di gkeConnect.location, gkeOnPremAPI.location, dan stackdriver.clusterLocation. Jika region tidak sama, pembuatan cluster akan gagal.

Contoh:

cloudAuditLogging:
  clusterLocation: "us-central1"

cloudAuditLogging.serviceAccountKeyPath

Diperlukan untuk Cloud Audit Logs
Dapat diubah
String

Jalur file kunci JSON untuk akun layanan logging audit Anda.

Jika Anda akan membuat cluster dengan enableAdvancedCluster yang ditetapkan ke true (yang diperlukan untuk menyiapkan domain topologi), maka cloudAuditLogging.serviceAccountKeyPath harus sama dengan stackdriver.serviceAccountKeyPath.

Untuk mengetahui informasi tentang cara memperbarui kolom ini di cluster yang ada, lihat Merotasi kunci akun layanan.

Contoh:

cloudAuditLogging:
  serviceAccountKeyPath: "my-key-folder/audit-log-key.json"

clusterBackup.datastore

Opsional
Dapat diubah
String

Secara default, file tar cadangan cluster disimpan ke direktori gkectl-workspace/backups di workstation admin Anda. Jika Anda ingin menyimpan file cadangan cluster di vSphere, tetapkan kolom ini ke penyimpanan data vSphere tempat Anda ingin menyimpan cadangan.

Contoh:

clusterBackup:
  datastore: "my-datastore"

Perhatikan perbedaan dukungan berikut untuk kolom ini:

  • Untuk cluster lanjutan:

    • Versi 1.31: hapus clusterBackup.datastore dari file konfigurasi Anda. Pencadangan cluster ke datastore vSphere tidak didukung.

    • Versi 1.32: clusterBackup.datastore dalam Pratinjau

    • Versi 1.33 dan yang lebih tinggi: clusterBackup.datastore adalah GA.

  • Untuk cluster non-lanjutan, clusterBackup.datastore tetap dalam Pratinjau.

Untuk informasi selengkapnya, lihat referensi berikut:

autoRepair.enabled

Opsional
Dapat diubah
Boolean
Diisi otomatis: true

Tetapkan ke true untuk mengaktifkan perbaikan otomatis node. Jika tidak, tetapkan ke false.

Untuk memperbarui nilai kolom ini, gunakan gkectl update admin.

Contoh:

autoRepair:
  enabled: true

secretsEncryption

Jika Anda ingin mengenkripsi Secret tanpa memerlukan KMS (Key Management Service) eksternal, atau dependensi lainnya, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.
Tidak dapat diubah

Jika Anda akan membuat cluster dengan enableAdvancedCluster ditetapkan ke true (yang diperlukan untuk menyiapkan domain topologi), hapus bagian ini. Fitur ini tidak didukung dengan cluster lanjutan.

secretsEncryption.mode

Diperlukan untuk enkripsi Secret
Immutable
String
Nilai yang mungkin: "GeneratedKey"
Diisi otomatis: "GeneratedKey"

Mode enkripsi Secret.

secretsEncryption:
  mode: "GeneratedKey"

secretsEncryption.generatedKey.keyVersion

Diperlukan untuk enkripsi Secret
Dapat diubah
Bilangan bulat
Diisi otomatis: 1

Bilangan bulat pilihan Anda yang akan digunakan untuk nomor versi kunci. Sebaiknya Anda memulai dengan 1.

Contoh:

secretsEncryption:
  generatedKey:
    keyVersion: 1

secretsEncryption.generatedKey.disabled

Opsional untuk enkripsi Secret
Dapat diubah
Boolean
Diisi otomatis: false

Tetapkan ini ke true untuk menonaktifkan enkripsi Secrets. Jika tidak, tetapkan ke false.

Contoh:

secretsEncryption:
  generatedKey:
    disabled: false

osImageType

Opsional
Dapat diubah
String
Nilai yang mungkin: Untuk versi 1.34 dan sebelumnya: "ubuntu_containerd", "cos"
Untuk 1.35 dan yang lebih baru: "ubuntu_cgv2", "cos_cgv2"
Diisi otomatis: "ubuntu_cgv2"
Default: "ubuntu_containerd"

Jenis OS image yang akan dijalankan di node cluster admin Anda.

Perhatikan batasan berikut terkait cluster lanjutan:

  • Versi 1.31: jika kolom enableAdvancedCluster adalah true, hanya ubuntu-cgroupv2 dan ubuntu_containerd yang didukung di cluster lanjutan.

  • Versi 1.32: Semua jenis image OS didukung di cluster lanjutan.

Catatan: Di versi 1.32 dan yang lebih rendah, paket lengkap tidak menyertakan image OS cgroup v2. Jika Anda menentukan ubuntu_cgv2 atau cos_cgv2, Anda harus menggunakan paket reguler. Untuk mengetahui detailnya, lihat Tentang paket Google Distributed Cloud.

Contoh:

osImageType: "cos_cgv2"