File konfigurasi cluster admin 1.28

Dokumen ini menjelaskan kolom dalam file konfigurasi cluster admin untuk Google Distributed Cloud versi 1.28.

Membuat {i>template<i} untuk {i>file<i} 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 bidang untuk Anda.

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

Guna membuat template untuk file konfigurasi cluster admin:

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

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

Ganti VERSION dengan patch 1.28 versi lengkap data. Contoh: gkectl create-config admin --gke-on-prem-version=1.28.800-gke.109. Versi ini harus sama dengan atau lebih kecil dari versi gkectl Anda. Jika Anda menghilangkan flag ini, template konfigurasi yang dihasilkan akan diisi dengan nilai berdasarkan patch 1.28 terbaru.

Template

Mengisi file konfigurasi Anda

Di file konfigurasi Anda, masukkan nilai kolom seperti yang dijelaskan di bawah bagian.

name

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

Nama pilihan Anda untuk cluster.

Contoh:

name: "my-admin-cluster"

bundlePath

Wajib
Dapat diubah
{i>String<i}

Jalur file paket Google Distributed Cloud Anda.

File paket lengkap Google Distributed Cloud berisi semua komponen dalam rilis Google Distributed Cloud tertentu. Saat Anda membuat admin Google Workspace for Education, hadir dengan paket lengkap di:

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

Contoh:

bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.10.0-gke.8.full.tgz"

preparedSecrets.enabled

Pratinjau
Opsional
Tidak dapat diubah
Boolean
Diisi otomatis: salah
Default: false

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

Contoh:

preparedSecrets:
  enabled: true

vCenter

Wajib
Tidak dapat diubah

Bagian ini menyimpan informasi tentang lingkungan vSphere dan yang terhubung ke Server vCenter.

vCenter.address

Wajib
Tidak dapat diubah
{i>String<i}

Alamat IP atau nama host server vCenter Anda.

Untuk 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
Tidak dapat diubah
{i>String<i}

Jalur relatif dari Pusat data vSphere.

Nilai yang Anda tentukan relatif terhadap folder root bernama /.

Jika pusat data Anda berada di folder {i>root<i}, nilainya adalah nama pusat data.

Contoh:

vCenter:
  datacenter: "my-data-center"

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

Contoh:

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

vCenter.cluster

Wajib
Tidak dapat diubah
{i>String<i}

Jalur relatif dari Gugus vSphere yang mewakili host ESXi tempat VM cluster admin Anda akan dijalankan. VSphere ini mewakili subset dari host ESXi fisik di pusat data vCenter Anda.

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

Jika cluster vSphere Anda berada di /.../DATA_CENTER/vm/ , nilainya adalah nama {i>cluster <i}vSphere.

Contoh:

vCenter:
  cluster: "my-vsphere-cluster"

Jika tidak, nilainya adalah jalur relatif yang mencakup satu atau beberapa folder dengan nama gugus {i>vSphere<i}.

Contoh:

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

vCenter.resourcePool

Wajib
Tidak dapat diubah
{i>String<i}

J Kumpulan resource vCenter untuk VM cluster admin Anda.

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

Contoh:

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

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

Nilai yang Anda tetapkan 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 kumpulan resource Anda berada di bawah kumpulan resource lain, tetapkan ini ke keseluruhan jalur ke kumpulan resource Anda.

Contoh:

vCenter:
  resourcePool: "my-vsphere-cluster/Resources/parent-resource-pool/child-resource-pool"

vCenter.datastore

Wajib jika vCenter.storagePolicyName tidak ditentukan
Tidak dapat diubah
{i>String<i}

Nama vSphere datastore 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 jangan tentukan nilai untuk vCenter.storagePolicyName. Tujuan Kolom vCenter.datastore tidak dapat diubah, kecuali jika Anda menetapkan kolom ke kosong {i>string<i} saat Anda memigrasikan datastore ke Pengelolaan Berbasis Kebijakan Penyimpanan(SPBM).

vCenter.storagePolicyName

Wajib jika vCenter.datastore tidak ditentukan
Tidak dapat diubah
{i>String<i}

Nama Kebijakan penyimpanan VM untuk node cluster.

Cluster admin harus sangat tersedia (HA) agar dapat berfungsi dengan kebijakan penyimpanan.

Untuk informasi selengkapnya, lihat Mengonfigurasi kebijakan penyimpanan.

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

vCenter.caCertPath

Wajib
Dapat diubah
{i>String<i}

Jalur sertifikat CA untuk server vCenter Anda.

Untuk informasi selengkapnya, lihat Mendapatkan sertifikat CA vCenter.

Untuk 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
{i>String<i}

Jalur dari file konfigurasi kredensial yang menyimpan nama pengguna dan {i>password<i} dari 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
{i>String<i}

Nama blok kredensial, di file konfigurasi kredensial, yang menyimpan nama pengguna dan {i> password<i} 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
Tidak dapat diubah
String
Default: Folder 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 /.../DATA_CENTER/vm/.

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

Nilainya dapat berupa nama folder.

Contoh:

vCenter:
  folder: "my-folder"

Jika folder vm Anda berada di folder vm lain, setel ini ke jalur lengkap ke folder vm Anda.

Contoh:

vCenter:
  folder: "/my-datacenter/vm/vm-folder/nested-vm-folder"

Perhatikan bahwa Anda harus menyertakan "/" pertama di jalur lengkap folder vm Anda.

vCenter.dataDisk

Jangan berikan nilai untuk kolom ini. Hapus kolom atau biarkan berkomentar.

network

Wajib
Tidak dapat diubah

Bagian ini menyimpan informasi tentang jaringan cluster admin Anda.

network.hostConfig

Wajib
Tidak dapat diubah

Bagian ini menyimpan informasi tentang server NTP, server DNS, dan pencarian DNS yang digunakan oleh VM yang merupakan node cluster Anda.

network.hostConfig.dnsServers

Wajib diisi jika bagian network.hostConfig diisi.
Tidak dapat diubah
Array string.
Jumlah elemen maksimal 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 diisi jika bagian network.hostConfig diisi.
Tidak dapat diubah
Array string

Alamat server waktu yang akan digunakan oleh VM.

Contoh:

network:
  hostConfig:
    ntpServers:
    - "216.239.35.0"

network.hostConfig.searchDomainsForDNS

Opsional
Tidak dapat diubah
Array string

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

Contoh:

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

network.ipMode.type

Wajib
Tidak dapat diubah
String
Terisi otomatis: "dhcp"
Default: "dhcp"

Jika Anda ingin {i>node<i} cluster Anda untuk mendapatkan alamat IP mereka dari server DHCP, tetapkan parameter ini ke "dhcp". Jika Anda ingin node cluster memiliki IP statis untuk alamat yang dipilih dari daftar yang Anda berikan, tetapkan ke "static".

Contoh:

network:
  ipMode:
    type: "static"

network.ipMode.ipBlockFilePath

Wajib jika network.ipMode.type = static
Tidak dapat diubah
{i>String<i}

Jalur dari File blok IP untuk cluster Anda.

Contoh:

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

network.serviceCIDR

Wajib
Tidak dapat diubah
String
Rentang terkecil: /24
Rentang terbesar: /12
Terisi otomatis: "10.96.232.0/24"
Default: "10.96.232.0/24"

Rentang alamat IP, dalam format CIDR, yang akan digunakan untuk Layanan di .

Contoh:

network:
  serviceCIDR: "10.96.232.0/24"

network.podCIDR

Wajib
Tidak dapat diubah
String
Rentang terkecil: /18
Rentang terbesar: /8
Terisi otomatis: "192.168.0.0/16"
Default: "192.168.0.0/16"

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

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 apa pun 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. Semua traffic yang dikirim dari Pod ke alamat di salah satu rentang akan diperlakukan sebagai dalam cluster dan tidak akan mencapai tujuan apa pun di luar gugus ini.

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 di RFC 1918 alamat IP eksternal.

Berikut adalah salah satu alasan direkomendasikan untuk menggunakan alamat RFC 1918. Misalkan Pod atau rentang Service berisi alamat IP eksternal. Setiap lalu lintas yang dikirim dari Pod ke salah satu alamat eksternal tersebut akan diperlakukan sebagai traffic dalam cluster dan tidak akan sampai ke tujuan eksternal.

network.vCenter.networkName

Wajib
Tidak dapat diubah
{i>String<i}

Nama jaringan vSphere untuk node cluster Anda.

Contoh:

network:
  vCenter:
    networkName: "my-network"

Jika nama berisi karakter khusus, Anda harus menggunakan urutan escape untuk nama 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 .

Contoh:

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

network.controlPlaneIPBlock

Wajib

network.controlPlaneIPBlock.netmask

Wajib
Tidak dapat diubah
{i>String<i}

{i>Netmask<i} untuk jaringan yang memiliki node bidang kontrol Anda.

Contoh:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

network.controlPlaneIPBlock.gateway

Wajib
Tidak dapat diubah
{i>String<i}

Alamat IP gateway default untuk node bidang kontrol.

Contoh:

network:
  controlPlaneIPBlock:
    gateway: "172.16.22.1"

network.controlPlaneIPBlock.ips

Wajib
Tidak dapat diubah
Array berisi tiga objek, yang masing-masing memiliki alamat IP dan opsional nama host.

Ini adalah alamat IP yang akan ditetapkan ke node bidang kontrol Anda.

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"

loadBalancer

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

loadBalancer.vips.controlPlaneVIP

Wajib
Tidak dapat diubah
{i>String<i}

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

Contoh:

loadBalancer:
  vips:
    controlplaneVIP: "203.0.113.3"

loadBalancer.kind

Wajib
Tidak dapat diubah
String
Diisi otomatis: "MetalLB"

String. Tetapkan ini 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.

Contoh:

loadBalancer:
  kind: "MetalLB"

loadBalancer.manualLB

Jika Anda menetapkan loadbalancer.kind ke "ManualLB", isi bagian ini. Jika tidak, hapus bagian ini.
Tidak dapat diubah

loadBalancer.manualLB.ingressHTTPNodePort

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

loadBalancer.manualLB.ingressHTTPSNodePort

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

loadBalancer.manualLB.konnectivityServerNodePort

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

loadBalancer.f5BigIP

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

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

Jika Anda sudah memiliki load balancer F5 BIG-IP dan cluster menggunakan besar, setelah meningkatkan ke versi 1.29 atau yang lebih tinggi, sebaiknya Anda bermigrasi ke mode manual.

loadBalancer.f5BigIP.address

Wajib jika loadBalancer.kind = "f5BigIp"
Tidak dapat diubah
{i>String<i}

Alamat load balancer F5 BIG-IP Anda. Contoh:

loadBalancer:
  f5BigIP:
    address: "203.0.113.2"

loadBalancer.f5BigIP.credentials.fileRef.path

Wajib jika loadBalancer.kind = "f5BigIp"
Dapat diubah
{i>String<i}

Jalur dari file konfigurasi kredensial yang menyimpan nama pengguna dan sandi akun milik Google Distributed Cloud, dapat digunakan untuk terhubung ke penyeimbang beban F5 BIG-IP Anda.

Akun pengguna harus memiliki peran pengguna yang memiliki izin memadai untuk menyiapkan dan mengelola load balancer. Keduanya peran Administrator atau peran Administrator Sumber Daya saja.

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

Wajib jika loadBalancer.kind = "f5BigIp"
Dapat diubah
{i>String<i}

Nama blok kredensial, di file konfigurasi kredensial, yang menyimpan nama pengguna dan {i> password<i} 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

Wajib jika loadBalancer.kind = "f5BigIp"
Tidak dapat diubah
{i>String<i}

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

Contoh:

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

loadBalancer.f5BigIP.snatPoolName

Opsional
Relevan jika loadBalancer.kind = "f5BigIp"
Tidak dapat diubah
{i>String<i}

Jika Anda menggunakan SNAT, nama kumpulan 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 admin dalam versi 1.28 dan yang lebih tinggi. Sebagai gantinya, kami menyarankan Anda mengonfigurasi load balancer MetalLB untuk cluster admin baru. Untuk selengkapnya informasi tentang cara mengonfigurasi MetalLB, Paket load balancing dengan MetalLB.

Kami masih mendukung Seesaw untuk cluster yang diupgrade dari 1,16 ke 1,28. Sebagai Sebagai contoh, misalkan Anda memiliki 1,16 cluster admin non-HA yang menggunakan Seesaw. Selanjutnya setelah mengupgrade cluster ke versi 1.28, Anda dapat terus menggunakan bidang kontrol dan load balancer Seesaw. Untuk mengetahui informasi tentang Jungkat-jungkit untuk load balancer, lihat dokumentasi 1.16:

antiAffinityGroups.enabled

Opsional
Dapat diubah
Boolean
Terisi otomatis: benar

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

Contoh:

antiAffinityGroups:
  enabled: true

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

Fitur ini mengharuskan lingkungan vSphere Anda memenuhi persyaratan berikut kondisi:

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

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

  • Ada setidaknya empat host ESXi yang tersedia.

Meskipun aturan mengharuskan node cluster tersebar di tiga untuk host ESXi, sebaiknya Anda memiliki minimal empat host ESXi yang tersedia. Tindakan ini akan melindungi Anda agar tidak kehilangan bidang kontrol cluster admin. Sebagai misalnya, Anda hanya memiliki tiga host ESXi, dan cluster admin {i>control-plane<i} berada di {i>host<i} ESXi yang gagal. Aturan DRS akan mencegah {i>node<i} bidang kontrol agar tidak ditempatkan di salah satu dari dua {i>host<i} ESXi yang tersisa.

Ingatlah 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 dengan VM vSphere dapat dijadwalkan, tetapkan antiAffinityGroups.enabled ke false.

adminMaster

Tidak dapat diubah

Setelan konfigurasi untuk node bidang kontrol di cluster admin.

adminMaster.cpus

Pratinjau
Opsional
Tidak dapat diubah
Bilangan bulat
Diisi sebelumnya: 4
Default: 4

Jumlah vCPU untuk setiap node bidang kontrol di cluster admin.

Contoh:

adminMaster:
  cpus: 4

adminMaster.memoryMB

Pratinjau
Opsional
Tidak dapat diubah
Bilangan bulat
Terisi otomatis: 16384
Default: 16384

Jumlah mebibyte memori untuk setiap node bidang kontrol pada admin .

Contoh:

adminMaster:
  memoryMB: 16384

adminMaster.replicas

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

Jumlah node bidang kontrol di cluster admin. Saat membuat cluster admin, tetapkan kolom ini ke 3 untuk membuat admin ketersediaan tinggi (HA) .

Contoh:

adminMaster:
  replicas: 3

proxy

Jika jaringan Anda berada di belakang 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 diisi jika bagian proxy diisi.
Tidak dapat diubah
{i>String<i}

Alamat HTTP server proxy Anda. Sertakan nomor porta tersebut meskipun sama dengan porta {i>default<i} skema ini.

Contoh:

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

Server proxy yang Anda tetapkan di sini digunakan oleh Google Distributed Cloud klaster. Selain itu, workstation admin Anda akan otomatis dikonfigurasi untuk menggunakan server proxy yang sama kecuali jika Anda menetapkan variabel lingkungan HTTPS_PROXY pada komputer admin.

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

Setelah konfigurasi proxy untuk cluster admin disetel, konfigurasi tidak dapat diubah atau dihapus, kecuali jika cluster dibangun kembali.

proxy.noProxy

Opsional
Tidak dapat diubah
{i>String<i}

Daftar yang dipisahkan koma untuk alamat IP, rentang alamat IP, nama {i>host<i}, dan nama domain yang seharusnya tidak melewati server {i>proxy<i}. Kapan Google Distributed Cloud mengirimkan permintaan ke salah satu alamat, host, atau domain, permintaan akan dikirim secara langsung.

Contoh:

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

privateRegistry

Jika Anda memiliki container registry pribadi, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

privateRegistry.address

Wajib untuk registry pribadi
Tidak dapat diubah
{i>String<i}

Alamat IP atau FQDN (Fully Qualified Domain Name) 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
{i>String<i}

Jalur dari file konfigurasi kredensial yang menyimpan nama pengguna dan sandi akun milik Google Distributed Cloud, digunakan untuk mengakses {i>registry<i} pribadi Anda.

Contoh:

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

privateRegistry.credentials.fileRef.entry

Wajib untuk registry pribadi
Dapat diubah
{i>String<i}

Nama blok kredensial, di file konfigurasi kredensial, yang menyimpan nama pengguna dan {i> password<i} akun {i>registry<i} pribadi Anda.

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

privateRegistry.caCertPath

Wajib untuk registry pribadi
Dapat diubah
{i>String<i}

Saat runtime container mengambil image dari registry pribadi Anda, {i>registry<i} harus membuktikan identitasnya dengan menyerahkan sertifikat. dari registry sertifikat ditandatangani oleh {i>certificate authority<i} (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
{i>String<i}

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 menyimpan informasi tentang project dan layanan Google Cloud akun yang diperlukan untuk mendaftarkan cluster.

Selama pembuatan atau pembaruan cluster, beberapa Kebijakan RBAC dikonfigurasikan di cluster admin. Kebijakan RBAC ini diperlukan sehingga Anda dapat membuat cluster pengguna di Konsol Google Cloud.

gkeConnect.projectID

Wajib
Tidak dapat diubah
{i>String<i}

ID project host perangkat. 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 gagal. Persyaratan ini tidak berlaku untuk beberapa cluster yang ada.

Contoh:

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

gkeConnect.location

Opsional
Tidak dapat diubah
String
Default: global

Setiap keanggotaan armada cluster dikelola oleh layanan Fleet (gkehub.googleapis.com) dan layanan Connect (gkeconnect.googleapis.com). Lokasi layanan dapat bersifat global. atau regional. Pada versi 1.28 dan yang lebih baru, Anda dapat secara opsional menentukan region tempat layanan Fleet dan Connect berjalan. Jika tidak ditentukan, instance global layanan digunakan. Perhatikan hal berikut:

  • Cluster admin yang dibuat sebelum versi 1.28 dikelola oleh Armada global dan Menghubungkan layanan.

  • 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 wilayah tidak sama, pembuatan cluster gagal.

Contoh:

gkeConnect:
  location: "us-central1"

gkeConnect.registerServiceAccountKeyPath

Wajib
Dapat diubah
{i>String<i}

Jalur file kunci JSON untuk akun layanan connect-register.

Contoh:

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

gkeOnPremAPI

Opsional

Pada versi 1.16 dan yang lebih baru, jika GKE On-Prem API diaktifkan di di project Google Cloud, semua cluster dalam project 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 dalam Sebelum memulai mengaktifkan dan menggunakan GKE On-Prem API di project.

  • Jika Anda tidak ingin mendaftarkan cluster di GKE On-Prem API, sertakan bagian ini dan menyetel 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) di awal proyek. Untuk mengetahui petunjuknya, lihat Menonaktifkan layanan.

Dengan mendaftarkan cluster admin di GKE On-Prem API, Anda dapat menggunakan alat—Konsol Google Cloud, Google Cloud CLI, atau Terraform—untuk mengupgrade yang dikelola oleh cluster admin. Mendaftarkan cluster juga memungkinkan Anda menjalankan perintah gcloud untuk dapatkan informasi tentang cluster Anda.

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

gkeOnPremAPI.enabled

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

Secara default, cluster akan didaftarkan di GKE On-Prem API jika GKE On-Prem API diaktifkan di project Anda. Tetapkan ke false jika Anda yang 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

Tidak dapat diubah
String
Default:stackdriver.clusterLocation

Region Google Cloud tempat GKE On-Prem API menjalankan 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 diisi secara default
Dapat Berubah

Jika Anda ingin mengaktifkan Cloud Logging dan Cloud Monitoring untuk cluster Anda, isi bagian ini. Jika tidak, hapus bagian ini.

Bagian ini wajib ada secara default. Artinya, jika Anda tidak menyertakan bagian ini, Anda harus menyertakan flag --skip-validation-stackdriver saat menjalankan gkectl create admin.

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

stackdriver.projectID

Diperlukan untuk Logging dan Pemantauan
Tidak dapat diubah
{i>String<i}

ID project host perangkat. 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 gagal. Persyaratan ini tidak berlaku untuk beberapa cluster yang ada.

Jika perlu, Anda dapat mengonfigurasi {i>router<i} log dalam proyek ini untuk merutekan log ke bucket log di project lain. Untuk informasi tentang cara mengonfigurasi log router, lihat Tujuan yang didukung.

Contoh:

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

stackdriver.clusterLocation

Diperlukan untuk Logging dan Pemantauan
Tidak dapat diubah
String
Diisi otomatis: "us-central1"

Region Google Cloud tempat Anda ingin menyimpan log. Ini adalah hal yang bagus Anda bisa memilih region yang dekat dengan pusat data lokal Anda.

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

Contoh:

stackdriver:
  clusterLocation: "us-central1"

stackdriver.enableVPC

Opsional
Tidak dapat diubah
Boolean
Diisi otomatis: salah

Jika jaringan cluster Anda dikontrol oleh VPC, tetapkan parameter ini ke true. Hal ini memastikan bahwa semua telemetri mengalir melalui alamat IP terbatas Google. Jika tidak, tetapkan parameter ini ke false.

Contoh:

stackdriver:
  enableVPC: false

stackdriver.serviceAccountKeyPath

Diperlukan untuk Logging dan Pemantauan
Dapat diubah
{i>String<i}

Jalur file kunci JSON untuk akun layanan pemantauan logging Anda.

Untuk informasi tentang cara memperbarui kolom ini di cluster yang sudah ada, lihat Akun layanan rotasi .

Contoh:

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

stackdriver.disableVsphereResourceMetrics

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

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

Bagian ini wajib ada 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 Kubernetes API cluster Anda server Anda dengan Cloud Audit Logs, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.
Dapat diubah

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

cloudAuditLogging.projectID

Diperlukan untuk Cloud Audit Logs
Tidak dapat diubah
{i>String<i}

ID project host perangkat 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 gagal. Persyaratan ini tidak berlaku untuk beberapa cluster yang ada.

Jika perlu, Anda dapat mengonfigurasi {i>router<i} log dalam proyek ini untuk merutekan log ke bucket log di project lain. Untuk informasi tentang cara mengonfigurasi log router, lihat Tujuan yang didukung.

Contoh:

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

cloudAuditLogging.clusterLocation

Diperlukan untuk Cloud Audit Logs
Tidak dapat diubah
{i>String<i}

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

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

Contoh:

cloudAuditLogging:
  clusterLocation: "us-central1"

cloudAuditLogging.serviceAccountKeyPath

Diperlukan untuk Cloud Audit Logs
Dapat diubah
{i>String<i}

Jalur file kunci JSON untuk akun layanan logging audit Anda.

Untuk informasi tentang cara memperbarui kolom ini di cluster yang sudah ada, lihat Akun layanan rotasi .

Contoh:

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

clusterBackup.datastore

Pratinjau
Opsional
Dapat diubah
{i>String<i}

Jika Anda ingin mengaktifkan pencadangan cluster admin, tetapkan ini ke datastore vSphere tempat Anda ingin menyimpan cadangan cluster.

Contoh:

clusterBackup:
  datastore: "my-datastore"

autoRepair.enabled

Opsional
Dapat diubah
Boolean
Terisi otomatis: benar

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

Untuk memperbarui nilai kolom ini, gunakan gkectl update admin.

Contoh:

autoRepair:
  enabled: true

secretsEncryption

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

secretsEncryption.mode

Diperlukan untuk enkripsi Secret
Tidak dapat diubah
String
Nilai yang mungkin: "GeneratedKey"
Diisi otomatis: "GeneratedKey"

Mode enkripsi Rahasia.

secretsEncryption:
  mode: "GeneratedKey"

secretsEncryption.generatedKey.keyVersion

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

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

Contoh:

secretsEncryption:
  generatedKey:
    keyVersion: 1

secretsEncryption.generatedKey.disabled

Opsional untuk enkripsi Secret
Dapat diubah
Boolean
Diisi otomatis: salah

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

Contoh:

secretsEncryption:
  generatedKey:
    disabled: false

osImageType

Opsional
Dapat diubah
String
Nilai yang memungkinkan: "ubuntu_containerd", "cos", "ubuntu_cgv2", "cos_cgv2"
Diisi otomatis: ""
Default: "ubuntu_containerd"

Jenis OS image yang akan dijalankan pada node cluster admin.

Jika Anda menentukan ubuntu_cgv2 atau cos_cgv2, Anda harus menjalankan gkectl prepare --extra-os-image-types=cgroupv2 sebelum membuat/memperbarui cluster.

Contoh:

osImageType: "cos"