File konfigurasi cluster admin

Halaman ini menjelaskan kolom dalam file konfigurasi cluster admin untuk GKE di VMware.

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 gkeadm tidak digunakan untuk membuat workstation admin, Anda dapat menggunakan gkectl untuk membuat template file konfigurasi cluster admin.

Untuk membuat template bagi file konfigurasi cluster admin Anda:

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 nomor versi yang diinginkan, yang harus sama dengan atau kurang dari versi gkectl Anda. Misalnya: gkectl create-config admin --gke-on-prem-version=1.6.2-gke.0 Jika Anda menghapus tanda ini, template konfigurasi yang dihasilkan akan diisi dengan nilai berdasarkan versi cluster terbaru.

Template

Klik untuk melihat template yang dibuat.

apiVersion: v1
kind: AdminCluster
# (Optional) A unique name for this admin cluster. This will default to a random name
# prefixed with 'gke-admin-'
name: ""
# (Required) Absolute path to a GKE bundle on disk
bundlePath: ""
# # (Optional/Preview) Specify the prepared secret configuration which can be added
# # or edited only during cluster creation
# preparedSecrets:
#   # enable prepared credentials for the admin cluster; it is immutable
#   enabled: false
# (Required) vCenter configuration
vCenter:
  address: ""
  datacenter: ""
  cluster: ""
  # Resource pool to use. Specify [VSPHERE_CLUSTER_NAME]/Resources to use the default
  # resource pool
  resourcePool: ""
  datastore: ""
  # Provide the path to vCenter CA certificate pub key for SSL verification
  caCertPath: ""
  # The credentials to connect to vCenter
  credentials:
    # reference to external credentials file
    fileRef:
      # read credentials from this file
      path: ""
      # entry in the credential file
      entry: ""
  # (Optional) vSphere folder where cluster VMs will be located. Defaults to the
  # datacenter wide folder if unspecified.
  folder: ""
  # # (Only used in 1.16 and older versions for non-HA admin cluster) Provide the name
  # # for the persistent disk to be used by the deployment (ending in .vmdk). Any directory
  # # in the supplied path must be created before deployment. Required for non-HA admin
  # # cluster. Invalid for HA admin cluster as the path is generated automatically under
  # # the root directory "anthos" in the specified datastore.
  # dataDisk: ""
# (Required) Network configuration
network:
  # (Required when using "static" ipMode.type; or "Seesaw" loadBalancer.kind; or using
  # amdin cluster HA mode) This section overrides ipMode.ipBlockFilePath values when
  # ipMode.type=static. It's also used for seesaw nodes
  hostConfig:
    # List of DNS servers
    dnsServers:
    - ""
    # List of NTP servers
    ntpServers:
    - ""
    # # List of DNS search domains
    # searchDomainsForDNS:
    # - ""
  ipMode:
    # (Required) Define what IP mode to use ("dhcp" or "static")
    type: dhcp
    # # (Required when using "static" mode) The absolute or relative path to the yaml file
    # # to use for static IP allocation. Hostconfig part will be overwritten by network.hostconfig
    # # if specified
    # ipBlockFilePath: ""
  # (Required) The Kubernetes service CIDR range for the cluster. Must not overlap
  # with the pod CIDR range
  serviceCIDR: 10.96.232.0/24
  # (Required) The Kubernetes pod CIDR range for the cluster. Must not overlap with
  # the service CIDR range
  podCIDR: 192.168.0.0/16
  vCenter:
    # vSphere network name
    networkName: ""
  # (Required for HA admin cluster) Specify the IPs to use for control plane machines
  # for HA admin cluster.
  controlPlaneIPBlock:
    netmask: ""
    gateway: ""
    ips:
    - ip: ""
      hostname: ""
    - ip: ""
      hostname: ""
    - ip: ""
      hostname: ""
# (Required) Load balancer configuration
loadBalancer:
  # (Required) The VIPs to use for load balancing
  vips:
    # Used to connect to the Kubernetes API
    controlPlaneVIP: ""
  # (Required) Which load balancer to use "F5BigIP" "Seesaw" "ManualLB" or "MetalLB".
  # Uncomment the corresponding field below to provide the detailed spec
  kind: MetalLB
  # # (Required when using "ManualLB" kind) Specify pre-defined nodeports
  # manualLB:
  #   # NodePort for ingress service's http (only needed for user cluster)
  #   ingressHTTPNodePort: 0
  #   # NodePort for ingress service's https (only needed for user cluster)
  #   ingressHTTPSNodePort: 0
  #   # NodePort for konnectivity server service (only needed for controlplane v1 user
  #   # cluster)
  #   konnectivityServerNodePort: 0
  #   # NodePort for control plane service (not needed for HA admin cluster or controlplane
  #   # V2 user cluster)
  #   controlPlaneNodePort: 30968
  # # (Required when using "F5BigIP" kind) Specify the already-existing partition and
  # # credentials
  # f5BigIP:
  #   address: ""
  #   credentials:
  #     # reference to external credentials file
  #     fileRef:
  #       # read credentials from this file
  #       path: ""
  #       # entry in the credential file
  #       entry: ""
  #   partition: ""
  #   # # (Optional) Specify a pool name if using SNAT
  #   # snatPoolName: ""
  # # (Only used in 1.16 and older versions for using "Seesaw" kind) Specify the Seesaw
  # # configs
  # seesaw:
  #   # (Required) The absolute or relative path to the yaml file to use for IP allocation
  #   # for LB VMs. Must contain one or two IPs. Hostconfig part will be overwritten by
  #   # network.hostconfig if specified.
  #   ipBlockFilePath: ""
  #   # (Required) The Virtual Router IDentifier of VRRP for the Seesaw group. Must be
  #   # between 1-255 and unique in a VLAN.
  #   vrid: 0
  #   # (Required) The IP announced by the master of Seesaw group
  #   masterIP: ""
  #   # (Required) The number CPUs per machine
  #   cpus: 2
  #   # (Required) Memory size in MB per machine
  #   memoryMB: 3072
  #   # (Optional) Network that the LB interface of Seesaw runs in (default: cluster network)
  #   vCenter:
  #     # vSphere network name
  #     networkName: ""
  #   # (Optional) Run two LB VMs to achieve high availability (default: false)
  #   enableHA: false
  #   # (Optional) Avoid using VRRP MAC and rely on gratuitous ARP to do failover. In
  #   # this mode MAC learning is not needed but the gateway must refresh arp table based
  #   # on gratuitous ARP. It's recommended to turn this on to avoid MAC learning configuration.
  #   # In vsphere 7+ it must be true to enable HA. It is supported in GKE on-prem version
  #   # 1.7+. (default: false)
  #   disableVRRPMAC: true
# Spread admin addon nodes and user masters across different physical hosts (requires
# at least three hosts)
antiAffinityGroups:
  # Set to false to disable DRS rule creation
  enabled: true
# (Optional) Specify the admin master node configuration which can be added or edited
# only during cluster creation (default: 4 CPUs; 16384 MB memory; 3 replicas)
adminMaster:
  cpus: 4
  memoryMB: 16384
  # How many machines of this type to deploy
  replicas: 3
# # (Only used in 1.16 and older versions) Specify the addon node configuration which
# # can be added or edited only during cluster creation
# addonNode:
#   # Enable auto resize for addon node
#   autoResize:
#     # Whether to enable auto resize for master. Defaults to false.
#     enabled: false
# (Optional) Specify the proxy configuration
proxy:
  # The URL of the proxy
  url: ""
  # The domains and IP addresses excluded from proxying
  noProxy: ""
# # (Optional) Use a private registry to host GKE images
# privateRegistry:
#   # Do not include the scheme with your registry address
#   address: ""
#   credentials:
#     # reference to external credentials file
#     fileRef:
#       # read credentials from this file
#       path: ""
#       # entry in the credential file
#       entry: ""
#   # The absolute or relative path to the CA certificate for this registry
#   caCertPath: ""
# (Required): The absolute or relative path to the GCP service account key for pulling
# GKE images
componentAccessServiceAccountKeyPath: ""
# (Required) Specify which GCP project to register your GKE OnPrem cluster to
gkeConnect:
  projectID: ""
  # # (Optional) The location of the GKE Hub and Connect service where the cluster is
  # # registered to. It can be any GCP region or "global". Default to "global" when unspecified.
  # location: us-central1
  # The absolute or relative path to the key file for a GCP service account used to
  # register the cluster
  registerServiceAccountKeyPath: ""
# # (Optional) Specify if you wish to explicitly enable/disable the cloud hosted gkeonprem
# # API to enable/disable cluster lifecycle management from gcloud UI and Terraform.
# gkeOnPremAPI:
#   enabled: false
# (Required) Specify which GCP project to connect your logs and metrics to
stackdriver:
  # The project ID for logs and metrics. It should be the same with gkeconnect.projectID.
  projectID: ""
  # A GCP region where you would like to store logs and metrics for this cluster.
  clusterLocation: us-central1
  enableVPC: false
  # The absolute or relative path to the key file for a GCP service account used to
  # send logs and metrics from the cluster
  serviceAccountKeyPath: ""
  # (Optional) Disable vsphere resource metrics collection from vcenter.  False by
  # default
  disableVsphereResourceMetrics: false
# (Optional) Configure kubernetes apiserver audit logging
cloudAuditLogging:
  # The project ID for logs and metrics. It should be the same with gkeconnect.projectID.
  projectID: ""
  # A GCP region where you would like to store audit logs for this cluster.
  clusterLocation: us-central1
  # The absolute or relative path to the key file for a GCP service account used to
  # send audit logs from the cluster
  serviceAccountKeyPath: ""
# # (Optional/Preview) Configure backups for admin cluster. Backups will be stored under
# # /anthos-backups/.
# clusterBackup:
#   # # datastore where admin cluster backups are desired
#   # datastore: ""
# Enable auto repair for the cluster
autoRepair:
  # Whether to enable auto repair feature. Set false to disable.
  enabled: true
# # Encrypt Kubernetes secrets at rest
# secretsEncryption:
#   # Secrets Encryption Mode. Possible values are: GeneratedKey
#   mode: GeneratedKey
#   # GeneratedKey Secrets Encryption config
#   generatedKey:
#     # # key version
#     # keyVersion: 1
#     # # disable secrets encryption
#     # disabled: false
# (Optional) Specify the type of OS image; available options can be set to "ubuntu_containerd"
# "cos" "ubuntu_cgv2" or "cos_cgv2". Default is "ubuntu_containerd".
osImageType: ""

Mengisi file konfigurasi Anda

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

`name`

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

Nama cluster pilihan Anda.

Contoh:

name: "my-admin-cluster"

`bundlePath`

Wajib
Dapat diubah
String

Jalur GKE Anda pada file paket VMware.

File paket lengkap GKE di VMware berisi semua komponen dalam rilis GKE tertentu di VMware. Saat Anda membuat workstation admin, paket lengkap akan tersedia 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
Terisi otomatis: false
Default: false

Tetapkan ini ke true jika Anda ingin menggunakan kredensial yang telah 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 koneksi Anda ke Server vCenter.

`vCenter.address`

Wajib
String
yang tidak dapat diubah

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
String
yang tidak dapat diubah

Jalur relatif pusat data vSphere.

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

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

Contoh:

vCenter:
  datacenter: "my-data-center"

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

Contoh:

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

`vCenter.cluster`

Wajib
String
yang tidak dapat diubah

Jalur relatif dari cluster vSphere yang mewakili host ESXi tempat VM cluster admin Anda akan dijalankan. Cluster vSphere ini merepresentasikan 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 mencakup satu atau beberapa folder beserta nama cluster vSphere.

Contoh:

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

`vCenter.resourcePool`

Wajib
String
yang tidak dapat diubah

Kumpulan resource 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 ingin menggunakan kumpulan resource yang telah Anda buat, 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 tersebut.

Contoh:

vCenter:
  resourcePool: "my-resource-pool"

Jika kumpulan resource Anda disusun bertingkat dalam kumpulan resource lain, tetapkan ini ke jalur lengkap ke kumpulan resource Anda.

Contoh:

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

`vCenter.datastore`

Opsional
String yang tidak dapat diubah
String

Nama datastore vSphere untuk cluster admin Anda.

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

Contoh:

vCenter:
  datastore: "my-datastore"

Jika Anda menentukan nilai untuk kolom ini, jangan tentukan nilai untuk vCenter.storagePolicyName.

`vCenter.storagePolicyName`

Opsional
String yang tidak dapat diubah
String

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.

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 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`

String
yang diperlukan

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`

String
yang diperlukan

Nama blok kredensial, di file konfigurasi kredensial, yang berisi 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
Tidak dapat diubah
String
Default: Folder lebar 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 ke dalam /.../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 mencakup 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 menyimpan informasi tentang jaringan cluster admin Anda.

`network.hostConfig`

Wajib
Tidak dapat diubah

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

`network.hostConfig.dnsServers`

Wajib diisi jika bagian network.hostConfig terisi.
Array string yang 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 diisi jika bagian network.hostConfig terisi.
Array string yang 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
Array string yang tidak dapat diubah
Array string

Domain penelusuran DNS untuk digunakan oleh VM. Domain ini digunakan sebagai bagian dari daftar penelusuran domain.

Contoh:

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

`network.ipMode.type`

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

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

Contoh:

network:
  ipMode:
    type: "static"

`network.ipMode.ipBlockFilePath`

Wajib jika network.ipMode.type = static
Tidak dapat diubah
String

Jalur 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 yang mungkin: /24
Rentang terbesar yang mungkin: /12
Sudah diisi sebelumnya: "10.96.232.0/24"
Default: "10.96.232.0/24"

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

Contoh:

network:
  serviceCIDR: "10.96.232.0/24"

`network.podCIDR`

Wajib
Tidak dapat diubah
String
Rentang terkecil yang memungkinkan: /18
Rentang terbesar yang mungkin: /8
Sudah diisi sebelumnya: "192.168.0.0/16"
Default: "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 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. Setiap traffic yang dikirim dari Pod ke alamat di salah satu rentang tersebut akan diperlakukan sebagai dalam cluster dan tidak akan mencapai tujuan apa pun di luar cluster.

Secara khusus, Service dan rentang 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 Service dan rentang Pod Anda berada dalam ruang alamat RFC 1918.

Berikut adalah salah satu alasan rekomendasi untuk menggunakan alamat RFC 1918. Misalnya Pod atau rentang 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`

Wajib
String
yang tidak dapat diubah

Nama jaringan vSphere untuk node cluster Anda.

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 lengkapnya.

Contoh:

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

`network.controlPlaneIPBlock`

Diperlukan

`network.controlPlaneIPBlock.netmask`

Wajib
String
yang tidak dapat diubah

Netmask untuk jaringan yang memiliki node bidang kontrol Anda.

Contoh:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

`network.controlPlaneIPBlock.gateway`

Wajib
String
yang tidak dapat diubah

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, yang masing-masing memiliki alamat IP dan nama host opsional.

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

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.

`loadBalancer.vips.controlPlaneVIP`

Wajib
String
yang tidak dapat diubah

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`

Wajib
Tidak dapat diubah
String
Diisi otomatis: "MetalLB"

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

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. Nama ini tidak digunakan di cluster admin.

`loadBalancer.manualLB.ingressHTTPSNodePort`

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

`loadBalancer.manualLB.konnectivityServerNodePort`

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

`loadBalancer.f5BigIP`

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

`loadBalancer.f5BigIP.address`

Wajib jika loadBalancer.kind = "f5BigIp"
Tidak dapat diubah
String

Alamat load balancer Big-IP F5. Contoh:

loadBalancer:
  f5BigIP:
    address: "203.0.113.2"

`loadBalancer.f5BigIP.credentials.fileRef.path`

Wajib jika loadBalancer.kind = "f5BigIp"
Dapat Diubah
String

Jalur file konfigurasi kredensial yang menyimpan nama pengguna dan sandi akun yang dapat digunakan GKE di VMware untuk terhubung ke load balancer BIG-IP F5 F5.

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

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

Untuk mengetahui informasi tentang cara memperbarui kredensial BIG-IP F5, 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
String

Nama blok kredensial, di file konfigurasi kredensial, yang berisi nama pengguna dan sandi akun Big-IP F5 Anda.

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

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

Contoh:

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

`loadBalancer.f5BigIP.partition`

Wajib jika loadBalancer.kind = "f5BigIp"
Tidak dapat diubah
String

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

Contoh:

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

`loadBalancer.f5BigIP.snatPoolName`

Opsional
Relevan jika loadBalancer.kind = "f5BigIp"
Tidak dapat diubah
String

Jika Anda menggunakan SNAT, nama kumpulan SNAT Anda. Jika 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.

Kami masih mendukung Seesaw untuk klaster yang diupgrade dari 1.16 ke 1.28. Misalnya, Anda memiliki cluster admin non-HA 1,16 yang menggunakan Seesaw. Kemudian, setelah mengupgrade cluster ke versi 1.28, Anda dapat terus menggunakan bidang kontrol non-HA dan load balancer Seesaw. Untuk informasi tentang load balancer Seesaw, lihat dokumentasi 1.16:

`antiAffinityGroups.enabled`

Opsional
Dapat diubah
Boolean
Terisi otomatis: benar

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

Contoh:

antiAffinityGroups:
  enabled: true

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

Fitur ini mengharuskan lingkungan vSphere Anda memenuhi kondisi berikut:

DRS VMware diaktifkan. VMware DRS memerlukan edisi lisensi vSphere Enterprise Plus.
Akun pengguna vSphere Anda memiliki hak istimewa Host.Inventory.Modify cluster.
Ada setidaknya empat host ESXi yang tersedia.

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

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

Jika Anda tidak mengaktifkan DRS, atau tidak memiliki setidaknya empat host tempat 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 otomatis: 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
Diisi otomatis: 16384
Default: 16384

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

Contoh:

adminMaster:
  memoryMB: 16384

`adminMaster.replicas`

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

Jumlah node bidang kontrol di cluster admin. Saat membuat cluster admin baru, tetapkan kolom ini ke 3 untuk membuat cluster 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 cluster admin ini.
Tidak dapat diubah

`proxy.url`

Wajib diisi jika bagian proxy terisi.
String yang tidak dapat diubah

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

Contoh:

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

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

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

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

`proxy.noProxy`

Opsional
String yang tidak dapat diubah
String

Daftar alamat IP, rentang alamat IP, nama host, dan nama domain yang dipisahkan koma yang tidak boleh melalui server proxy. Saat GKE di VMware mengirim permintaan ke salah satu alamat, host, atau domain tersebut, permintaan tersebut akan dikirim secara langsung.

Contoh:

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

`privateRegistry`

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

`privateRegistry.address`

Diperlukan untuk registry pribadi
Tidak dapat diubah
String

Alamat IP atau FQDN (Fully Qualified Domain Name) komputer yang menjalankan registry pribadi Anda.

Contoh:

privateRegistry:
  address: "203.0.113.10"

privateRegistry:
  address: "fqdn.example.com"

`privateRegistry.credentials.fileRef.path`

Diperlukan untuk registry pribadi
Dapat diubah
String

Jalur file konfigurasi kredensial yang menyimpan nama pengguna dan sandi akun yang dapat digunakan GKE di VMware untuk mengakses registry pribadi Anda.

Contoh:

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

`privateRegistry.credentials.fileRef.entry`

Diperlukan untuk registry pribadi
Dapat diubah
String

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

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

`privateRegistry.caCertPath`

Diperlukan untuk registry pribadi
Dapat diubah
String

Saat runtime container mengambil image dari registry pribadi Anda, registry harus membuktikan identitasnya dengan memberikan 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 terdaftar ke fleet setelah dibuat. Bagian ini menyimpan informasi tentang project Google Cloud dan akun layanan 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
String
yang tidak dapat diubah

ID project host fleet. 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
Tidak dapat diubah
String
Default: global

Setiap keanggotaan fleet cluster dikelola oleh layanan Armada (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 Google Cloud tempat Fleet dan layanan Connect dijalankan. Jika tidak ditentukan, instance global layanan akan digunakan. Perhatikan hal-hal berikut:

Cluster admin yang dibuat sebelum versi 1.28 dikelola oleh layanan Fleet and 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 region 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

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

Jika ingin mendaftarkan semua cluster dalam project di GKE On-Prem API, pastikan Anda melakukan langkah-langkah di 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) di project tersebut. Untuk mengetahui petunjuknya, lihat Menonaktifkan layanan.

Dengan mendaftarkan cluster admin di GKE On-Prem API, Anda dapat menggunakan alat standar—Google Cloud Console, 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 terdaftar 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, buat 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 secara default
Dapat diubah

Jika 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 tidak menyertakan bagian ini, Anda harus menyertakan flag --skip-validation-stackdriver saat menjalankan gkectl create admin.

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

`stackdriver.projectID`

Diperlukan untuk Logging dan Pemantauan
String yang Tidak Dapat Diubah

ID project host fleet. 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 dalam project ini untuk merutekan log ke dalam bucket log dalam 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 Pemantauan
Tidak dapat diubah
String
Terisi otomatis: "us-central1"

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

Untuk cluster baru, jika Anda menyertakan bagian gkeOnPremAPI dan cloudAuditLogging dalam file konfigurasi, region yang Anda tetapkan di sini harus merupakan region yang sama dengan 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.enableVPC`

Opsional
Tidak dapat diubah
Boolean
Diisi otomatis: false

Jika jaringan cluster Anda dikontrol oleh VPC, setel ini ke true. Tindakan ini memastikan bahwa semua telemetri mengalir melalui alamat IP yang dibatasi Google. Jika tidak, tetapkan ini ke false.

Contoh:

stackdriver:
  enableVPC: false

`stackdriver.serviceAccountKeyPath`

Diperlukan untuk Logging dan Pemantauan
Dapat Diubah
String

Jalur file kunci JSON untuk akun layanan pemantauan logging Anda.

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 Pemantauan
Boolean
Terisi otomatis: false
Default: false

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

Bagian ini diperlukan dalam 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 dengan Cloud Audit Logs, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.
Dapat diubah

Bagian ini diperlukan dalam 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
String

ID project fleet host 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.

Contoh:

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

`cloudAuditLogging.clusterLocation`

Diperlukan untuk Cloud Audit Logs
Tidak dapat diubah
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 merupakan region yang sama dengan 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.

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`

Pratinjau
Opsional
Dapat Diubah
String

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 string ini ke true untuk mengaktifkan perbaikan otomatis node. Jika tidak, tetapkan 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 (Key Management Service) eksternal, 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 untuk digunakan untuk nomor versi kunci. Sebaiknya mulai dengan 1.

Contoh:

secretsEncryption:
  generatedKey:
    keyVersion: 1

`secretsEncryption.generatedKey.disabled`

Opsional untuk enkripsi Secret
Dapat diubah
Boolean
Terisi otomatis: false

Setel ini ke true untuk menonaktifkan enkripsi Secrets. Atau, tetapkan ke false.

Contoh:

secretsEncryption:
  generatedKey:
    disabled: false

`osImageType`

Opsional
Dapat diubah
String
Nilai yang mungkin: "ubuntu_containerd", "cos", "ubuntu_cgv2", "cos_cgv2"
Terisi otomatis: ""
Default: "ubuntu_containerd"

Jenis OS image yang akan dijalankan di node cluster admin.

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

Contoh:

osImageType: "cos"