File konfigurasi cluster pengguna

Halaman ini menjelaskan kolom dalam file konfigurasi cluster pengguna GKE pada VMware.

Membuat template untuk file konfigurasi Anda

Jika Anda menggunakan gkeadm untuk membuat workstation admin, gkeadm akan membuat template untuk file konfigurasi cluster pengguna Anda. Dan gkeadm telah mengisi beberapa {i>field<i} untuk Anda.

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

Untuk membuat template bagi file konfigurasi cluster pengguna Anda:

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

Ganti kode berikut:

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

VERSION: nomor versi yang diinginkan. Contoh: gkectl create-config cluster --gke-on-prem-version=1.10.0-gke.8.

Template

Klik untuk melihat template yang dibuat.

apiVersion: v1
kind: UserCluster
# (Required) A unique name for this cluster
name: ""
# (Required) GKE on-prem version (example: 1.3.0-gke.16)
gkeOnPremVersion: ""
# # (Optional) Specify the prepared secret configuration which can be added or edited
# # only during cluster creation
# preparedSecrets:
#   # reference to the secret namespace for a group of secrets; it should be prepared
#   # beforehand by 'gkectl prepare secrets' command; it is immutable.
#   namespace: ""
# (Optional) Enable controlplane v2. Default is true
enableControlplaneV2: true
# # (Optional) vCenter configuration (default: inherit from the admin cluster)
# vCenter:
#   # # (Optional) vCenter server to use. Controlplane v2 needs to be enabled when the address
#   # # is different from that in the admin cluster configuration
#   # address: ""
#   datacenter: ""
#   cluster: ""
#   # Resource pool to use. Specify [VSPHERE_CLUSTER_NAME]/Resources to use the default
#   # resource pool
#   resourcePool: ""
#   datastore: ""
#   # (Optional) Storage policy to use for user cluster VM storage and default StorageClass
#   storagePolicyName: ""
#   # 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) reference to the credential secret; it should be prepared beforehand
#     # # by 'gkectl prepare secrets' command
#     # secretRef:
#     #   # The version for this prepared secret; it can be specified as 'latest' or integer
#     #   # string; it will be defaulted to latest version if it is not specified when creating
#     #   # a cluster; it is allowed to be empty when creating a cluster; it is not allowed
#     #   # to be empty when rotating credentials
#     #   version: ""
#   # (Optional) vSphere folder where cluster VMs will be located. Defaults to the
#   # datacenter wide folder if unspecified.
#   folder: ""
# # (Optional) The absolute or relative path to the GCP service account key for pulling
# # GKE images (default: inherit from the admin cluster)
# componentAccessServiceAccountKeyPath: ""
# # (Optional) The prepared credentials for component access service account key
# componentAccessServiceAccountKey:
#   # reference to the credential secret; it should be prepared beforehand by 'gkectl
#   # prepare secrets' command
#   secretRef:
#     # The version for this prepared secret; it can be specified as 'latest' or integer
#     # string; it will be defaulted to latest version if it is not specified when creating
#     # a cluster; it is allowed to be empty when creating a cluster; it is not allowed
#     # to be empty when rotating credentials
#     version: ""
# # (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: ""
#     # # (Optional) reference to the credential secret; it should be prepared beforehand
#     # # by 'gkectl prepare secrets' command
#     # secretRef:
#     #   # The version for this prepared secret; it can be specified as 'latest' or integer
#     #   # string; it will be defaulted to latest version if it is not specified when creating
#     #   # a cluster; it is allowed to be empty when creating a cluster; it is not allowed
#     #   # to be empty when rotating credentials
#     #   version: ""
#   # The absolute or relative path to the CA certificate for this registry
#   caCertPath: ""
# (Required) Network configuration; vCenter section is optional and inherits from
# the admin cluster if not specified
network:
  # (Required when using "static" ipMode.type; "Seesaw" loadBalancer.kind; or setting
  # enableControlplaneV2 to "true") This section overrides ipMode.ipBlockFilePath
  # values when ipMode.type=static. It's also used for control-plane nodes when controlplane
  # v2 is enabled and 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.0.0/20
  # (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: ""
  # # (Optional) List of additional node network interfaces feature enabled by multipleNetworkInterfaces
  # additionalNodeInterfaces:
  # # vSphere network name
  # - networkName: ""
  #   # (Required) Define what IP mode to use ("dhcp" "static" or "none")
  #   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 when setting enableControlplaneV2 to "true") Specify the IPs to use
  # for control-plane nodes when controlplane v2 is enabled. 1 IP is needed for non-HA
  # cluster and 3 for HA cluster. Non-empty controlPlaneIPBlock is not allowed when
  # controlplane v2 is disabled
  controlPlaneIPBlock:
    netmask: ""
    gateway: ""
    ips:
    - ip: ""
      hostname: ""
# (Required) Load balancer configuration
loadBalancer:
  # (Required) The VIPs to use for load balancing
  vips:
    # Used to connect to the Kubernetes API
    controlPlaneVIP: ""
    # Shared by all services for ingress traffic
    ingressVIP: ""
  # (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: 30243
  #   # NodePort for ingress service's https (only needed for user cluster)
  #   ingressHTTPSNodePort: 30879
  #   # NodePort for konnectivity server service (only needed for controlplane v1 user
  #   # cluster)
  #   konnectivityServerNodePort: 30563
  #   # NodePort for control plane service (not needed for HA admin cluster or controlplane
  #   # V2 user cluster)
  #   controlPlaneNodePort: 30562
  # # (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: ""
  #     # # (Optional) reference to the credential secret; it should be prepared beforehand
  #     # # by 'gkectl prepare secrets' command
  #     # secretRef:
  #     #   # The version for this prepared secret; it can be specified as 'latest' or integer
  #     #   # string; it will be defaulted to latest version if it is not specified when creating
  #     #   # a cluster; it is allowed to be empty when creating a cluster; it is not allowed
  #     #   # to be empty when rotating credentials
  #     #   version: ""
  #   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: 4
  #   # (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
  # (Required when using "MetalLB" kind in user clusters) Specify the MetalLB configs
  metalLB:
    # (Required) A list of non-overlapping IP pools used by load balancer typed services.
    # Must include ingressVIP of the cluster.
    addressPools:
    # (Required) Name of the address pool
    - name: address-pool-1
      # (Required) The addresses that are part of this pool. Each address must be
      # either in the CIDR form (1.2.3.0/24) or range form (1.2.3.1-1.2.3.5).
      addresses:
      - ""
      # # (Optional) Avoid using IPs ending in .0 or .255. This avoids buggy consumer devices
      # # mistakenly dropping IPv4 traffic for those special IP addresses (default: false)
      # avoidBuggyIPs: false
      # # (Optional) Prevent IP addresses to be automatically assigned from this pool (default:
      # # false)
      # manualAssign: false
# (Optional) Enable dataplane v2
enableDataplaneV2: true
# # (Optional) DataplaneV2 configuration
# dataplaneV2:
#   # (Optional) Specify dataplanev2 forward mode (snat or dsr)
#   forwardMode: snat
# # (Optional) Enable support for multiple networking interfaces
# multipleNetworkInterfaces: false
# # (Optional) Enable advanced dataplane v2 networking features such as Egress NAT Gateway
# # and it requires enableDataplaneV2 to be set
# advancedNetworking: false
# # (Optional) Disable installation of bundled ingress
# disableBundledIngress: false
# # (Optional) Storage specification for the cluster
# storage:
#   # # Whether to disable vSphere CSI components deployment. The feature is enabled by
#   # # default
#   # vSphereCSIDisabled: false
# (Optional) User cluster master nodes must have either 1 or 3 replicas (default:
# 4 CPUs; 8192 MB memory; 1 replica)
masterNode:
  cpus: 4
  memoryMB: 8192
  # How many machines of this type to deploy
  replicas: 1
  # # Enable auto resizing on master
  # autoResize:
  #   # Whether to enable auto resize for master. Defaults to false.
  #   enabled: false
  # vsphere:
  #   # (Optional) vSphere datastore the master nodes will be created on (default: vCenter.datastore)
  #   datastore: ""
  #   # (Optional) Storage policy to use for user master VM storage and datadisk
  #   storagePolicyName: ""
# (Required) List of node pools. The total un-tainted replicas across all node pools
# must be greater than or equal to 3
nodePools:
- name: pool-1
  # # (Optional) GKE on-prem version (example: 1.13.0-gke.16); it will be defaulted to
  # # cluster version if it is not specified; it can be used to roll back a node pool
  # # if it is specified as the previous node pool version
  # gkeOnPremVersion: ""
  cpus: 4
  memoryMB: 8192
  # How many machines of this type to deploy
  replicas: 3
  # # (Optional) boot disk size; must be at least 40 (default: 40)
  # bootDiskSizeGB: 40
  # (Optional) Specify the type of OS image; available options can be set to "ubuntu"
  # "ubuntu_containerd" "cos" "ubuntu_cgv2" "cos_cgv2" or "windows". Default is "ubuntu_containerd".
  osImageType: ubuntu_containerd
  # # (Required when using "windows" osImageType) Specify the OS image template in vCenter
  # osImage: ""
  # # Labels to apply to Kubernetes Node objects
  # labels: {}
  # # Taints to apply to Kubernetes Node objects
  # taints:
  # - key: ""
  #   value: ""
  #   effect: ""
  # vsphere:
  #   # (Optional) vSphere datastore the node pool will be created on (default: vCenter.datastore)
  #   datastore: ""
  #   # (Optional) Storage policy to use for nodepool
  #   storagePolicyName: ""
  #   # (Optional) Existing host groups used for VM/Host affinity. VM groups will be created
  #   # to bind with these host groups via vm-host affinity rules
  #   hostgroups:
  #   - ""
  #   # (Optional) vSphere tags to be attached to the virtual machines in the node pool.
  #   # It is supported in GKE on-prem version 1.7+
  #   tags:
  #   - category: ""
  #     name: ""
  # # (Optional) Horizontal autoscaling for the nodepool; replicas should not be edited
  # # while updating the nodepool if this is turned on
  # autoscaling:
  #   # min number of replicas in the NodePool
  #   minReplicas: 0
  #   # max number of replicas in the NodePool
  #   maxReplicas: 0
  # (Optional) Allow traffic of LoadBalancer typed services flow through nodes of
  # this pool. This is only needed for MetalLB mode. Set it to true for at least one
  # node pool in the cluster. Default is false.
  enableLoadBalancer: true
  # # (Optional/Preview) Update strategy for this node pool (it will overwrite nodePoolUpdatePolicy.updateStrategy
  # # setting)
  # updateStrategy:
  #   # # (Optional/Preview) Rolling update strategy for machines of the node pool
  #   # rollingUpdate:
  #   #   # # (Optional/Preview) The maximum number of machines that can be scheduled simultaneously
  #   #   # # during update/upgrade (default: 1)
  #   #   # maxSurge: "1"
# Spread nodes across at least three physical hosts (requires at least three hosts)
antiAffinityGroups:
  # Set to false to disable DRS rule creation
  enabled: true
# # (Optional/Preview) Track user cluster VMs with vSphere tags
# enableVMTracking: false
# # Configure node pool update policy for the cluster
# nodePoolUpdatePolicy:
#   # (Optional/Preview) Number of node pools to update at a time. 0 means no limit.
#   # 1 means updating one by one.
#   maximumConcurrentNodePoolUpdate: 0
#   # # (Optional/Preview) Cluster wide default node pool update strategy. A node pool will
#   # # use this setting if it doesn't set specific updateStrategy
#   # updateStrategy:
#   #   # # (Optional/Preview) Rolling update strategy for machines of the node pool
#   #   # rollingUpdate:
#   #   #   # # (Optional/Preview) The maximum number of machines that can be scheduled simultaneously
#   #   #   # # during update/upgrade (default: 1)
#   #   #   # maxSurge: "1"
# # (Optional) Configure additional authentication.
# authentication:
#   # (Optional) Provide an additional serving certificate for the API server
#   sni:
#     certPath: ""
#     keyPath: ""
# (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) The prepared credentials for register service account key
  # registerServiceAccountKey:
  #   # reference to the credential secret; it should be prepared beforehand by 'gkectl
  #   # prepare secrets' command
  #   secretRef:
  #     # The version for this prepared secret; it can be specified as 'latest' or integer
  #     # string; it will be defaulted to latest version if it is not specified when creating
  #     # a cluster; it is allowed to be empty when creating a cluster; it is not allowed
  #     # to be empty when rotating credentials
  #     version: ""
# # (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) The prepared credentials for stackdriver service account key
  # serviceAccountKey:
  #   # reference to the credential secret; it should be prepared beforehand by 'gkectl
  #   # prepare secrets' command
  #   secretRef:
  #     # The version for this prepared secret; it can be specified as 'latest' or integer
  #     # string; it will be defaulted to latest version if it is not specified when creating
  #     # a cluster; it is allowed to be empty when creating a cluster; it is not allowed
  #     # to be empty when rotating credentials
  #     version: ""
  # (Optional) Disable vsphere resource metrics collection from vcenter.  False by
  # default
  disableVsphereResourceMetrics: false
# # (Optional/Preview) Configure the GKE usage metering feature
# usageMetering:
#   bigQueryProjectID: ""
#   # The ID of the BigQuery Dataset in which the usage metering data will be stored
#   bigQueryDatasetID: ""
#   # The absolute or relative path to the key file for a GCP service account used by
#   # gke-usage-metering to report to BigQuery
#   bigQueryServiceAccountKeyPath: ""
#   # # (Optional) The prepared credentials for big query service account key
#   # bigQueryServiceAccountKey:
#   #   # reference to the credential secret; it should be prepared beforehand by 'gkectl
#   #   # prepare secrets' command
#   #   secretRef:
#   #     # The version for this prepared secret; it can be specified as 'latest' or integer
#   #     # string; it will be defaulted to latest version if it is not specified when creating
#   #     # a cluster; it is allowed to be empty when creating a cluster; it is not allowed
#   #     # to be empty when rotating credentials
#   #     version: ""
#   # Whether or not to enable consumption-based metering
#   enableConsumptionMetering: 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) The prepared credentials for cloud audit logging service account key
  # serviceAccountKey:
  #   # reference to the credential secret; it should be prepared beforehand by 'gkectl
  #   # prepare secrets' command
  #   secretRef:
  #     # The version for this prepared secret; it can be specified as 'latest' or integer
  #     # string; it will be defaulted to latest version if it is not specified when creating
  #     # a cluster; it is allowed to be empty when creating a cluster; it is not allowed
  #     # to be empty when rotating credentials
  #     version: ""
# 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

Mengisi file konfigurasi Anda

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

`name`

String
yang diperlukan

Nama pilihan Anda untuk cluster pengguna. Namanya harus:

berisi maksimal 40 karakter
hanya berisi karakter alfanumerik huruf kecil atau tanda hubung (-)
diawali dengan karakter alfabet
diakhiri dengan karakter alfanumerik

Contoh:

name: "my-user-cluster"

`gkeOnPremVersion`

Wajib
Dapat diubah
String

GKE pada versi VMware untuk cluster pengguna Anda.

Contoh:

gkeOnPremVersion: "1.14.0-gke.1"

`preparedSecrets.namespace`

Jika Anda ingin menggunakan kredensial yang telah disiapkan, isi kolom ini. Jika tidak, hapus kolom ini atau biarkan sebagai komentar.

Opsional
Tidak dapat diubah
String
Nilai yang mungkin: String yang diawali dengan "gke-onprem-secrets-"

Nama namespace Kubernetes di cluster admin tempat Secret yang telah disiapkan disimpan untuk cluster pengguna ini.

Contoh:

preparedSecrets:
  namespace: "gke-onprem-secrets-alice"

`enableControlplaneV2`

Opsional
Boolean
yang tidak dapat diubah
Terisi otomatis: true
Default: true

Jika Anda ingin membuat cluster pengguna yang mengaktifkan Controlplane V2, tetapkan nilainya ke true. Jika tidak, tetapkan ke false.

Contoh:

enableControlplaneV2: true

`vCenter`

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

Jika Anda ingin kolom di bagian ini sama dengan yang Anda tentukan untuk cluster admin, hapus kolom tersebut atau biarkan sebagai komentar.

Jika Anda ingin kolom yang berbeda dari yang Anda tentukan untuk cluster admin, isi di sini. Setiap kolom yang Anda isi di sini di bagian vCenter akan menggantikan kolom terkait di file konfigurasi cluster admin.

`vCenter.address`

Opsional
Tidak dapat diubah
String
Default: Mewarisi dari cluster admin

Alamat IP atau nama host instance Server vCenter yang ingin Anda gunakan untuk cluster pengguna ini.

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

Jika Anda menentukan nilai yang berbeda dari instance Server vCenter yang digunakan oleh cluster admin, Controlplane V2 harus diaktifkan, dan Anda harus memberikan nilai untuk network.vCenter.networkName dan semua kolom yang wajib diisi di bagian vCenter.

Contoh:

vCenter:
  address: "203.0.113.101"

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

`vCenter.datacenter`

Opsional
Tidak dapat diubah
String
Default: Mewarisi dari cluster admin

Jalur relatif pusat data vSphere.

Jika Anda menentukan nilai untuk kolom ini, Anda juga harus menentukan:

vCenter.networkName
Berupa vCenter.datastore atau vCenter.storagePolicyName
Berupa vCenter.cluster atau vCenter.resourcePool

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-uc-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-2"

`vCenter.cluster`

Opsional
Tidak dapat diubah
String
Default: Mewarisi dari cluster admin

Jalur relatif dari cluster vSphere yang mewakili host ESXi tempat VM cluster pengguna Anda akan dijalankan. Cluster vSphere ini merepresentasikan subset host ESXi fisik di pusat data vCenter Anda.

Jika Anda menentukan nilai untuk kolom ini, Anda juga harus menentukan:

vCenter.networkName
vCenter.datacenter
Berupa vCenter.datastore atau vCenter.storagePolicyName

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-uc-vsphere-cluster"

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

Contoh:

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

`vCenter.resourcePool`

Opsional
Tidak dapat diubah
String
Default: Mewarisi dari cluster admin

Kumpulan resource vCenter untuk VM cluster pengguna Anda.

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

Contoh:

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

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-uc-resource-pool"

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

Contoh:

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

`vCenter.datastore`

Opsional
Tidak dapat diubah
String
Default: Mewarisi dari cluster admin

Nama datastore vSphere untuk cluster pengguna Anda.

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

Contoh:

vCenter:
  datastore: "my-uc-datastore"

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

`vCenter.storagePolicyName`

Opsional
String

Nama kebijakan penyimpanan VM untuk node cluster.

Anda juga dapat menentukan kebijakan penyimpanan VM untuk node dalam kumpulan node tertentu. Namun, kebijakan yang ditentukan di sini berlaku untuk setiap kumpulan node yang tidak memiliki kebijakannya sendiri.

Untuk informasi selengkapnya, lihat Mengonfigurasi kebijakan penyimpanan.

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

`vCenter.caCertPath`

Opsional
Dapat diubah
String
Default: Mewarisi dari cluster admin

Jalur sertifikat CA untuk server vCenter Anda. Untuk informasi selengkapnya, lihat Mendapatkan sertifikat CA vCenter.

Contoh:

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

Untuk informasi tentang cara memperbarui kolom ini, lihat Memperbarui referensi sertifikat vCenter.

`vCenter.credentials.fileRef.path`

Opsional
Dapat diubah
String
Default: Mewarisi dari cluster admin

Jika Anda memberikan nilai untuk preparedSecrets.namespace, jangan berikan nilai untuk kolom ini. Sebagai gantinya, berikan nilai untuk vCenter.credentials.secretRef.version.

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 credentials untuk memperbarui kolom ini di cluster yang ada. Untuk mengetahui informasi selengkapnya, lihat Merotasi kunci akun layanan.

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

Contoh:

vCenter:
  credentials:
    fileRef:
      path: "my-config-directory/my-credentials-2.yaml"

`vCenter.credentials.fileRef.entry`

Opsional
Dapat diubah
String
Default: Mewarisi dari cluster admin

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

Contoh:

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

`vCenter.credentials.secretRef.version`

Wajib jika Anda memberikan nilai untuk preparedSecrets.namespace
String
Nilai yang mungkin: String bilangan bulat atau "latest"
Nilai default: "latest"

Jika Anda memberikan nilai untuk preparedSecrets.namespace, isi kolom ini. Jika tidak, hapus kolom ini atau biarkan sebagai komentar.

Versi Secret yang disiapkan di cluster admin yang menyimpan nama pengguna dan sandi untuk instance Server vCenter yang ingin Anda gunakan untuk cluster pengguna ini.

Contoh:

vCenter:
  credentials:
    secretRef:
      version: "1"

`vCenter.folder`

Opsional
Tidak dapat diubah
String
Default: Mewarisi dari cluster admin

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

Jika Anda tidak menentukan nilai, VM cluster pengguna 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-uc-folder"

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

Contoh:

vCenter:
  folder: "folders/folder-2"

`componentAccessServiceAccountKeyPath`

Opsional
Dapat diubah
String
Default: Mewarisi dari cluster admin

Jalur file kunci JSON untuk akun layanan akses komponen Anda.

Contoh:

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

`componentAccessServiceAccountKey.secretRef.version`

Opsional
Dapat diubah
String
Nilai yang mungkin: String bilangan bulat atau "terbaru"
Nilai default: "latest"

Versi Secret yang disiapkan di cluster admin yang menyimpan kunci JSON untuk akun layanan akses komponen Anda.

Contoh:

componentAccessServiceAccountKey:
  secretRef:
    version: "1"

`privateRegistry`

Isi bagian ini hanya jika cluster admin Anda menggunakan registry pribadi dan Anda ingin cluster pengguna menggunakan registry pribadi yang berbeda. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

Jika Anda ingin menerapkan beberapa setelan yang berbeda dari setelan cluster admin:

Nama pengguna, sandi, sertifikat yang berbeda
(Hanya tersedia untuk Control Plane V2) Alamat registry pribadi yang berbeda

Isi kolom privateRegistry di sini. Setelan baru akan diterapkan selama pembuatan dan update cluster.

`privateRegistry.address`

Diperlukan untuk registry pribadi
Tidak dapat diubah
String
Default: Mewarisi dari cluster admin

Alamat IP atau FQDN (Fully Qualified Domain Name) mesin yang menjalankan registry Docker 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
Default: Mewarisi dari cluster admin

Jika Anda berencana menggunakan secret yang sudah disiapkan untuk registry pribadi, jangan berikan nilai untuk kolom ini. Sebagai gantinya, berikan nilai untuk privateRegistry.credentials.secretRef.version.

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

Contoh:

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

`privateRegistry.credentials.fileRef.entry`

Diperlukan untuk registry pribadi
Dapat diubah
String
Default: Mewarisi dari cluster admin

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

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

`privateRegistry.credentials.secretRef.version`

Wajib jika Anda ingin menggunakan secret yang sudah disiapkan untuk registry pribadi
String
Nilai yang mungkin: String bilangan bulat atau "latest"
Nilai default: "latest"

Jika Anda memberikan nilai untuk preparedSecrets.namespace dan ingin menggunakan secret yang sudah disiapkan untuk registry pribadi, isi kolom ini. Jika tidak, hapus kolom ini atau biarkan kolomnya sebagai komentar.

Versi Secret yang disiapkan di cluster admin yang menyimpan nama pengguna dan sandi untuk instance Server vCenter yang ingin Anda gunakan untuk cluster pengguna ini.

Contoh:

privateRegistry:
  credentials:
    secretRef:
      version: "1"

`privateRegistry.caCertPath`

Diperlukan untuk registry pribadi
Dapat diubah
String
Default: Mewarisi dari cluster admin

Saat Docker mengambil image dari registry pribadi Anda, registry harus membuktikan identitasnya dengan memberikan sertifikat. Sertifikat registry ditandatangani oleh certificate authority (CA). Docker menggunakan sertifikat CA untuk memvalidasi sertifikat registry.

Tetapkan kolom ini ke jalur sertifikat CA.

Contoh:

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

`network`

Bagian ini menyimpan informasi tentang jaringan cluster pengguna Anda.

`network.hostConfig`

Bagian ini menyimpan informasi tentang server NTP, server DNS, dan domain penelusuran DNS yang digunakan oleh VM yang merupakan node cluster Anda. Jika Anda menggunakan load balancer Seesaw, informasi ini juga berlaku untuk VM Seesaw.

Bagian ini wajib ada jika satu atau beberapa kondisi berikut terpenuhi:

network.ipMode.type disetel ke static
enableControlplaneV2 disetel ke true atau diizinkan ke default ke true.
loadBalancer.kind disetel ke "Seesaw"

`network.hostConfig.dnsServers`

Array string yang tidak dapat diubah
Tidak dapat diubah
.
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
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 {i>host<i}. Domain ini digunakan sebagai bagian dari daftar pencarian 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/user-cluster-ipblock.yaml"

`network.serviceCIDR`

Wajib
Tidak dapat diubah
String
Diisi otomatis: "10.96.0.0/20"

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

Contoh:

network:
  serviceCIDR: "10.96.0.0/20"

`network.podCIDR`

Wajib
Tidak dapat diubah
String
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 cluster Anda. Minimal rentang /18.

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 diisi jika vCenter.address berbeda dengan alamat vCenter yang Anda gunakan untuk cluster admin.
String yang tidak dapat diubah

Nama jaringan vSphere untuk node cluster pengguna 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: "/my-uc-datacenter/network/my-network"

`network.additionalNodeInterfaces`

Jika Anda menetapkan multipleNetworkInterfaces ke true, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

Tidak dapat diubah

Array objek, yang masing-masing menjelaskan antarmuka jaringan yang dapat digunakan pada semua atau beberapa node cluster Anda.

`network.additionalNodeInterfaces[i].networkName`

Wajib jika multipleNetworkInterfaces = true
Tidak dapat diubah
String

Nama jaringan vSphere yang akan terhubung dengan antarmuka node tambahan ini.

Contoh:

network:
  additionalNodeInterfaces:
  - networkName: "my-node-interface-1"

`network.additionalNodeInterfaces[i].type`

Wajib jika multipleNetworkInterfaces = true
Tidak dapat diubah
String

Contoh:

network:
  additionalNodeInterfaces:
  - name: "my-node-interface-1"
    type: "static"

`network.additionalNodeInterfaces[i].ipBlockFilePath`

Wajib jika network.additionalNodeInterfaces[i].type = static
Tidak dapat diubah
String

Jalur file blok IP yang menyimpan alamat IP yang akan digunakan untuk antarmuka jaringan ini pada node yang memiliki antarmuka jaringan ini.

Contoh:

network:
  additionalNodeInterfaces:
  - name: "my-node-interface-1"
    type: "static"
    ipBlockFilePath: "my-ipblock-file-1"

`network.controlPlaneIPBlock`

Jika Anda menetapkan enableControlplaneV2 ke true, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

`network.controlPlaneIPBlock.netmask`

Wajib jika enableControlplaneV2 = true
Tidak dapat diubah
String

Contoh:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

`network.controlPlaneIPBlock.gateway`

Wajib jika enableControlplaneV2 = true
Tidak dapat diubah
String

Contoh:

network:
  controlPlaneIPBlock:
    gateway: "172.16.21.1"

`network.controlPlaneIPBlock.ips`

Wajib jika enableControlplaneV2 = true
Tidak dapat diubah
Array objek, yang masing-masing memiliki alamat IP dan nama host opsional.

Untuk cluster pengguna dengan ketersediaan tinggi (HA), array memiliki tiga elemen. Untuk cluster pengguna non-HA, array memiliki satu elemen.

Contoh:

network:
  controlPlaneIPBlock:
    ips:
    - ip: "172.16.21.6"
      hostname: "cp-vm-1"
    - ip: "172.16.21.7"
      hostname: "cp-vm-2"
    - ip: "172.16.21.8"
      hostname: "cp-vm-3"

`loadBalancer`

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

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

Contoh:

loadBalancer:
  vips:
    controlplaneVIP: "203.0.113.3"

`loadBalancer.vips.ingressVIP`

Wajib
String
yang tidak dapat diubah

Alamat IP yang telah Anda pilih untuk dikonfigurasi pada load balancer untuk proxy ingress.

Contoh:

loadBalancer:
  vips:
    ingressVIP: "203.0.113.4"

`loadBalancer.kind`

Wajib
Tidak dapat diubah
String
Diisi otomatis: "MetalLB"

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

Contoh:

loadBalancer:
  kind: "MetalLB"

`loadBalancer.manualLB`

Jika Anda menetapkan loadbalancer.kind ke "manualLB", isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

`loadBalancer.manualLB.ingressHTTPNodePort`

Wajib jika loadBalancer.kind = ManualLB
Tidak dapat diubah
Bilangan bulat
Diisi otomatis: 30243

Proxy masuk di cluster pengguna diekspos oleh Layanan Kubernetes jenis LoadBalancer. Layanan memiliki ServicePort untuk HTTP. Anda harus memilih nilai nodePort untuk HTTP ServicePort.

Tetapkan kolom ini ke nilai nodePort.

Contoh:

loadBalancer:
  manualLB:
    ingressHTTPNodePort: 32527

`loadBalancer.manualLB.ingressHTTPSNodePort`

Wajib jika loadBalancer.kind = ManualLB
Tidak dapat diubah
Bilangan bulat
Diisi otomatis: 30879

Proxy masuk di cluster pengguna diekspos oleh Layanan jenis LoadBalancer. Layanan memiliki ServicePort untuk HTTPS. Anda harus memilih nilai nodePort untuk HTTPS ServicePort.

Tetapkan kolom ini ke nilai nodePort. Contoh:

loadBalancer:
  manualLB:
    ingressHTTPSNodePort: 30139

`loadBalancer.manualLB.controlPlaneNodePort`

Wajib jika loadBalancer.kind = ManualLB dan enableControlplaneV2 = false
Tidak dapat diubah
Bilangan bulat
Terisi otomatis: 30562

Server Kubernetes API cluster pengguna berjalan di cluster admin, dan diekspos oleh Layanan jenis LoadBalancer. Anda harus memilih nilai nodePort untuk Layanan.

Tetapkan kolom ini ke nilai nodePort.

Contoh:

loadBalancer:
  manualLB:
    controlPlaneNodePort: 30968

`loadBalancer.manualLB.konnectivityServerNodePort`

Wajib jika loadBalancer.kind = ManualLB dan enableControlplaneV2 = false
Tidak dapat diubah
Bilangan bulat
Terisi otomatis: 30563

Server Kubernetes API dari cluster pengguna yang menggunakan kubeception berjalan di cluster admin, dan diekspos oleh Layanan jenis LoadBalancer. Server Konnectivity menggunakan kembali layanan ini dengan nilai nodePort yang berbeda. Anda harus memilih nilai nodePort untuk server Konnectivity.

Tetapkan kolom ini ke nilai nodePort untuk server Konnectivity.

Contoh:

loadBalancer:
  manualLB:
    konnectivityServerNodePort: 30969

`loadBalancer.f5BigIP`

Jika Anda menetapkan loadbalancer.kind ke "f5BigIP", isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

`loadBalancer.f5BigIP.address`

Wajib jika loadBalancer.kind = "f5BigIP"
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"
String

Jalur file 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.

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

Contoh:

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

`loadBalancer.f5BigIP.credentials.fileRef.entry`

Wajib jika loadBalancer.kind = "f5BigIP"
String

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

Contoh:

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

`loadBalancer.f5BigIP.partition`

Wajib jika loadBalancer.kind = "f5BigIP"
String

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

Contoh:

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

`loadBalancer.f5BigIP.snatPoolName`

Wajib jika loadBalancer.kind = "f5BigIP" dan Anda menggunakan String SNAT

Nama kumpulan SNAT Anda.

Contoh:

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

`loadBalancer.seesaw`

Jika Anda menetapkan loadbalancer.kind ke "Seesaw", isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

Perhatikan batasan berikut:

Jika cluster admin ketersediaan tinggi mengelola cluster pengguna ini, cluster pengguna ini tidak dapat menggunakan load balancer Seesaw.
Cluster pengguna dengan Controlplane V2 diaktifkan tidak dapat menggunakan load balancer Seesaw.

Untuk mengetahui informasi tentang cara menyiapkan load balancer Seesaw, lihat Panduan memulai load balancer Seesaw dan Load balancing paket dengan Seesaw.

`loadBalancer.seesaw.ipBlockFilePath`

Wajib jika loadBalancer.kind = Seesaw
Tidak dapat diubah
String

Jalur file blok IP untuk Seesaw VM Anda.

Contoh:

loadBalancer:
  seesaw:
    ipBlockFilePath: "config-folder/user-seesaw-ipblock.yaml"

`loadBalancer.seesaw.vrid`

Wajib jika loadBalancer.kind = Seesaw
Tidak dapat diubah
Bilangan bulat
Nilai yang memungkinkan: 1 - 255
Terisi otomatis: 0

ID router virtual dari Seesaw VM. ID ini, yang merupakan bilangan bulat pilihan Anda, harus unik di VLAN.

Contoh:

loadBalancer:
  seesaw:
    vrid: 125

`loadBalancer.seesaw.masterIP`

Wajib jika loadBalancer.kind = Seesaw
Tidak dapat diubah
String

Alamat IP virtual yang dikonfigurasi di Master Seesaw VM.

Contoh:

loadBalancer:
  seesaw:
    masterIP: 172.16.20.21

`loadBalancer.seesaw.cpus`

Wajib jika loadBalancer.kind = Seesaw
Dapat Diubah
Bilangan Bulat
Terisi otomatis: 4

Jumlah CPU untuk setiap VM Seesaw.

Contoh:

loadBalancer:
  seesaw:
    cpus: 8

`loadBalancer.seesaw.memoryMB`

Wajib jika loadBalancer.kind = Seesaw
Dapat Diubah
Bilangan Bulat
Terisi otomatis: 3072

Jumlah mebibyte memori untuk setiap Seesaw VM Anda.

Contoh:

loadBalancer:
  seesaw:
    memoryMB: 8192

Catatan: Kolom ini menentukan jumlah mebibyte memori, bukan jumlah megabyte. Satu mebibyte adalah 2^20 = 1.048.576 byte. Satu megabita adalah 10^6 = 1.000.000 byte.

`loadBalancer.seesaw.vCenter.networkName`

Opsional
Tidak dapat diubah
String
Default: Sama seperti node cluster

Nama jaringan vCenter yang berisi VM Seesaw Anda.

Contoh:

loadBalancer:
  seesaw:
    vCenter:
      networkName: "my-seesaw-network"

`loadBalancer.seesaw.enableHA`

Opsional
Tidak dapat diubah
Relevan jika loadBalancer.kind = Seesaw
Boolean
Diisi otomatis: false
Default: false

Jika Anda ingin membuat load balancer Seesaw dengan ketersediaan tinggi (HA), tetapkan ini ke true. Jika tidak, tetapkan ini ke false. Load balancer Seesaw dengan ketersediaan tinggi (HA) menggunakan pasangan VM (Master, Backup).

Contoh:

loadBalancer:
  seesaw:
    enableHA: true

`loadBalancer.seesaw.disableVRRPMAC`

Opsional
Tidak dapat diubah
Relevan jika loadBalancer.kind = Seesaw
Boolean
Diisi otomatis: benar
Default: benar

Jika Anda menetapkannya ke true, load balancer Seesaw tidak akan menggunakan MAC learning untuk failover. Sebagai gantinya, sistem ini menggunakan ARP yang serampangan. Jika Anda menetapkannya ke false, load balancer Seesaw akan menggunakan pembelajaran MAC. Sebaiknya tetapkan setelan ini ke true. Jika menggunakan vSphere 7 atau yang lebih baru, dan memiliki load balancer Seesaw yang memiliki ketersediaan tinggi, Anda harus menetapkannya ke true.

Contoh:

loadBalancer:
  seesaw:
    disableVRRPMAC: true

`loadBalancer.metalLB`

Jika Anda menetapkan loadbalancer.kind ke "MetalLB", isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

Untuk informasi selengkapnya, lihat Load balancing yang dipaketkan dengan MetalLB.

`loadBalancer.metalLB.addressPools`

Wajib ada jika loadBalancer.kind = 'MetalLB`
Dapat Berubah

Array objek, yang masing-masing menyimpan informasi tentang kumpulan alamat yang akan digunakan oleh load balancer MetalLB.

`loadBalancer.metalLB.addressPools[i].name`

Wajib jika loadBalancer.kind = MetalLB
Dapat Diubah
String

Nama pilihan Anda untuk kumpulan alamat.

Contoh:

loadBalancer:
  metalLB:
    addressPools:
    - name: "my-address-pool-1"

`loadBalancer.metalLB.addressPools[i].addresses`

Wajib jika loadBalancer.kind = MetalLB
Dapat Berubah

Array string, yang masing-masing merupakan rentang alamat. Setiap rentang harus memiliki format CIDR atau rentang dengan tanda hubung.

Contoh:

loadBalancer:
  metalLB:
    addressPools:
    - name: "my-address-pool-1"
      addresses:
      - "192.0.2.0/26"
      - "192.0.2.64-192.0.2.72"

`loadBalancer.metalLB.addressPools[i].avoidBuggyIPs`

Opsional
Relevan jika loadBalancer.kind = MetalLB
Dapat diubah
Boolean
Terisi otomatis: false
Default: false

Jika Anda menetapkannya ke true, pengontrol MetalLB tidak akan menetapkan alamat IP yang diakhiri dengan .0 atau .255 ke Layanan. Hal ini untuk menghindari masalah perangkat konsumen yang berisi bug yang secara keliru menjatuhkan traffic yang dikirim ke alamat IP khusus tersebut.

Contoh:

loadBalancer:
  metalLB:
    addressPools:
    - name: "my-address-pool-1"
      - "192.0.2.0/26"
      - "192.0.2.64-192.0.2.72"
      avoidBuggyIPs: true

`loadBalancer.metalLB.addressPools[i].manualAssign`

Opsional
Relevan jika loadBalancer.kind = MetalLB
Dapat diubah
Boolean
Terisi otomatis: false
Default: false

Jika Anda tidak ingin pengontrol MetalLB menetapkan alamat IP secara otomatis dari kumpulan ini ke Service, tetapkan ini ke true. Kemudian, developer dapat membuat Layanan dengan jenis LoadBalancer dan secara manual menentukan salah satu alamat dari kumpulan tersebut.

Jika tidak, tetapkan ini ke false.

Contoh:

loadBalancer:
  metalLB:
    addressPools:
    - name: "my-address-pool-1"
      manualAssign: true

`enableDataplaneV2`

Opsional
Boolean
yang tidak dapat diubah
Diisi otomatis: benar
Default: false

Jika Anda ingin mengaktifkan Dataplane V2, atau jika ingin menggunakan Controlplane V2, tetapkan ini ke true. Jika tidak, tetapkan ini ke false.

Contoh:

enableDataplaneV2: true

Lihat Pemecahan Masalah Dataplane V2 untuk mengetahui langkah-langkah pemecahan masalah.

`dataplaneV2.lbMode`

Opsional
Tidak dapat diubah
String
Nilai yang mungkin: "snat", "dsr"
Terisi otomatis: "snat"
Default: "snat"

Mode load balancing untuk cluster yang mengaktifkan Dataplane V2.

Dengan mode penafsiran alamat jaringan (SNAT) sumber, paket diterjemahkan ke SNAT saat diteruskan dari node load balancer ke Pod backend. Pod tidak dapat melihat alamat IP sumber asli, dan paket yang ditampilkan harus melewati node load balancer.

Dengan mode return server langsung (DSR), paket mempertahankan alamat IP sumber aslinya saat diteruskan dari node load balancer ke Pod backend. Pod dapat melihat alamat IP sumber asli, dan paket yang dikembalikan akan langsung dikirim ke klien tanpa melewati node load balancer.

Contoh:

dataplaneV2:
  lbMode: "dsr"

`multipleNetworkInterfaces`

Opsional
Boolean
yang tidak dapat diubah
Terisi otomatis: false
Default: false

Jika ingin mengaktifkan beberapa antarmuka jaringan untuk Pod, tetapkan parameter ini ke true. Jika tidak, tetapkan ini ke false.

Untuk mengetahui informasi selengkapnya, baca Mengonfigurasi beberapa antarmuka jaringan untuk Pod.

Contoh:

multipleNetworkInterfaces: true

`advancedNetworking`

Opsional
Boolean
yang tidak dapat diubah
Diisi otomatis: salah
Default: false

Jika Anda berencana untuk membuat gateway NAT keluar, tetapkan ini ke true. Atau, tetapkan ke false.

Jika Anda menetapkan kolom ini ke true, Anda juga harus menetapkan enableDataplaneV2 ke true.

Contoh:

advancedNetworking: true

`disableBundledIngress`

Tetapkan ini ke true jika Anda ingin menonaktifkan ingress yang dipaketkan untuk cluster. Jika tidak, tetapkan ke false.

Opsional
Boolean
Dapat diubah
Terisi otomatis: false
Default: false

Contoh:

disableBundledIngress: true

`storage.vSphereCSIDisabled`

Jika ingin menonaktifkan deployment komponen CSI vSphere, tetapkan ini ke true. Jika tidak, tetapkan ke false.

Opsional
Dapat diubah
Boolean
Terisi otomatis: false
Default: false

Contoh:

storage:
  vSphereCSIDisabled: false

`masterNode`

Bagian ini menyimpan informasi tentang node yang berfungsi sebagai node bidang kontrol untuk cluster pengguna ini.

`masterNode.cpus`

Opsional
Dapat diubah
Bilangan bulat
Diisi otomatis: 4
Default: 4

Jumlah CPU untuk setiap node yang berfungsi sebagai bidang kontrol untuk cluster pengguna ini.

Contoh:

masterNode:
  cpus: 8

`masterNode.memoryMB`

Opsional
Dapat diubah
Bilangan bulat
Diisi otomatis: 8192
Default: 8192

Mebibyte memori untuk setiap node yang berfungsi sebagai bidang kontrol untuk cluster pengguna ini. Harus kelipatan dari 4.

Contoh:

masterNode:
  memoryMB: 8192

Catatan: Kolom ini menentukan jumlah mebibyte memori, bukan jumlah megabyte. Satu mebibyte adalah 2^20 = 1.048.576 byte. Satu megabita adalah 10^6 = 1.000.000 byte.

`masterNode.replicas`

Opsional
Tidak dapat diubah
Bilangan bulat
Nilai yang memungkinkan: 1 atau 3
Terisi otomatis: 1
Default: 1

Jumlah node bidang kontrol untuk cluster pengguna ini. Angka ini tidak dapat diubah setelah cluster dibuat. Jika ingin memperbarui jumlah replika nanti, Anda harus membuat ulang cluster pengguna.

Contoh:

masterNode:
  replicas: 3

`masterNode.autoResize.enabled`

Opsional
Dapat diubah
Boolean
Terisi otomatis: false
Default: false

Tetapkan string ini ke true untuk mengaktifkan pengubahan ukuran otomatis node bidang kontrol untuk cluster pengguna. Jika tidak, tetapkan ini ke false.

Untuk informasi selengkapnya, lihat Mengaktifkan perubahan ukuran node untuk node bidang kontrol cluster pengguna.

Contoh:

masterNode:
  autoResize:
    enabled: true

`masterNode.vsphere.datastore`

Opsional
Tidak dapat diubah
String
Default: Nilai vCenter.datastore

Datastore tempat node bidang kontrol untuk cluster pengguna ini akan dibuat.

Contoh:

masterNode:
  vSphere:
    datastore: "control-plane-datastore"

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

`masterNode.vsphere.storagePolicyName`

Opsional
Tidak dapat diubah
String
Default: Nilai vCenter.storagePolicyName

Nama kebijakan penyimpanan VM untuk node bidang kontrol.

Untuk informasi selengkapnya, lihat Mengonfigurasi kebijakan penyimpanan.

Contoh:

masterNode:
  vSphere:
    storagePolicyName: "control-plane-storage-policy"

Jika Anda menentukan nilai untuk kolom ini, jangan tentukan nilai untuk masterNode.vsphere.datastore.

`nodePools`

Wajib
Dapat diubah
Array objek, yang masing-masing menjelaskan kumpulan node.

Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola node pool.

`nodePools[i].name`

Wajib
String
yang tidak dapat diubah

Nama pilihan Anda untuk kumpulan node. Namanya harus:

berisi maksimal 40 karakter
hanya berisi karakter alfanumerik huruf kecil atau tanda hubung (-)
diawali dengan karakter alfabet
diakhiri dengan karakter alfanumerik

Contoh:

nodePools:
- name: "my-node-pool-1"

`nodePools[i].gkeOnPremVersion`

Saat mengupgrade cluster pengguna, Anda dapat menentukan bahwa kumpulan node yang dipilih tetap pada versi sebelumnya.

Jika Anda ingin kumpulan node ini tetap pada versi sebelumnya, tetapkan ini ke versi sebelumnya. Jika tidak, hapus kolom ini atau setel ke string kosong. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade kumpulan node.

Opsional
Dapat diubah
String
Default: Cluster gkeOnPremVersion

Contoh:

nodePools:
- name: "my-node-pool"
  gkeOnPremVersion: "1.13.0-gke.16"

`nodePools[i].cpus`

Wajib
Dapat Diubah
Bilangan bulat
Diisi otomatis: 4

Jumlah vCPU untuk setiap node dalam kumpulan.

Contoh:

nodePools"
- name: "my-node-pool"
  cpus: 8

`nodePools[i].memoryMB`

Wajib
Dapat Diubah
Bilangan bulat
Diisi otomatis: 8192

Mebibyte memori untuk setiap node dalam kumpulan. Harus kelipatan dari 4.

Contoh:

nodePools"
- name: "my-node-pool"
  memoryMB: 8192

Catatan: Kolom ini menentukan jumlah mebibyte memori, bukan jumlah megabyte. Satu mebibyte adalah 2^20 = 1.048.576 byte. Satu megabita adalah 10^6 = 1.000.000 byte.

`nodePools[i].replicas`

Wajib
Dapat diubah
Bilangan bulat
Terisi otomatis: 3
Nilai yang mungkin: Jumlah total node yang belum tersentuh di semua kumpulan node dalam cluster harus minimal 3.

Jumlah node dalam kumpulan.

Contoh:

nodePools:
- name: "my-node-pool"
  replicas: 5

`nodePools[i].bootDiskSizeGB`

Opsional
Dapat diubah
Bilangan bulat
Diisi otomatis: 40
Default: 40

Ukuran boot disk dalam gigabyte untuk setiap node di kumpulan.

Contoh:

nodePools
- name: "my-node-pool"
  bootDiskSizeGB: 40

`nodePools[i].osImageType`

Opsional
Dapat diubah
String
Nilai yang mungkin: "ubuntu_containerd", "cos", "windows"
Diisi otomatis: "ubuntu_containerd"
Default: "ubuntu_containerd"

Jenis OS image yang akan dijalankan pada VM di kumpulan node.

Contoh:

nodePools
- name: "my-node-pool"
  osImageType: "ubuntu_containerd"

`nodePools[i].osImage`

Wajib jika nodePools[i].osImageType = windows
Dapat Diubah
String

Nama template VM Windows. Template harus didasarkan pada ISO Windows Server 2019 yang memiliki tag bahasa/wilayah en-US.

Untuk informasi selengkapnya, lihat Panduan pengguna untuk kumpulan node OS Windows Server.

`nodePools[i].labels`

Opsional
Dapat Diubah
Pemetaan

Label untuk diterapkan ke setiap objek Node Kubernetes dalam kumpulan.

Contoh:

nodePools:
- name: "my-node-pool"
  labels:
    environment: "production"
    tier: "cache"

Untuk alasan keamanan, kubelet tidak dapat menerapkan label ke dirinya sendiri dalam namespace tertentu.

Namespace label node yang dicadangkan adalah : kubernetes.io, k8s.io, googleapis.com.

`nodePools[i].taints`

Opsional
Dapat diubah
Array objek, yang masing-masing menjelaskan taint Kubernetes yang diterapkan ke setiap node dalam kumpulan. Taint adalah pasangan nilai kunci yang terkait dengan effect. Taint digunakan dengan toleransi untuk penjadwalan Pod. Tentukan salah satu dari hal berikut untuk effect: NoSchedule, PreferNoSchedule, NoExecute.

Contoh:

nodePools:
- name: "my-node-pool"
  taints:
  - key: "staging"
    value: "true"
    effect: "NoSchedule"

`nodePools[i].vsphere.datastore`

Opsional
Dapat diubah
String
Default: Nilai vCenter.datastore

Nama datastore vCenter tempat node akan dibuat.

Contoh:

nodePools:
- name: "my-node-pool"
  vsphere:
    datastore: "my-datastore"

Jika Anda menentukan nilai untuk kolom ini, jangan tentukan nilai untuk nodePools[i].vsphere.storagePolicyName.

`nodePools[i].vsphere.storagePolicyName`

Opsional
Dapat diubah
String
Default: Nilai vCenter.storagePolicyName

Nama kebijakan penyimpanan VM untuk node di dalam kumpulan.

Untuk informasi selengkapnya, lihat Mengonfigurasi kebijakan penyimpanan.

Contoh:

nodePools:
- name: "my-node-pool"
  vsphere:
    storagePolicyName: "my-storage-policy"

Jika Anda menentukan nilai untuk kolom ini, jangan tentukan nilai untuk nodePools[i].vsphere.datastore.

`nodePools[i].vsphere.tags`

Opsional
Dapat diubah
Array objek, yang masing-masing menjelaskan tag vSphere untuk ditempatkan pada VM di kumpulan node.

Setiap tag memiliki kategori dan nama.

Contoh:

nodePools:
- name: "my-node-pool"
  vsphere:
    tags:
    - category: "purpose"
      name: "testing"

Jika Anda ingin menambahkan tag ke semua VM di kumpulan node, akun pengguna vCenter Anda harus memiliki hak istimewa pemberian tag vSphere berikut:

Pemberian Tag vSphere.Tetapkan atau Batalkan Penetapan Tag vSphere
Pemberian Tag vSphere.Tetapkan atau Batalkan Penetapan Tag vSphere pada Objek (vSphere 7)

`nodePools[i].vsphere.hostgroups`

Isi bagian ini jika Anda ingin mengonfigurasi cluster untuk menggunakan afinitas VM-Host.

Opsional

Dapat diubah Array string, yang masing-masing merupakan nama grup DRS host.

Array hanya boleh memiliki satu elemen.

`nodePools[i].vsphere.hostgroups[j].hostgroup`

Opsional
Dapat diubah
String

Nama grup DRS host yang sudah ada

nodePools:
- name: "my-node-pool"
  vsphere:
    hostgroups:
    - "my-hostgroup"

`nodePools[i].autoscaling`

Opsional
Dapat diubah

Jika Anda ingin mengaktifkan penskalaan otomatis untuk kumpulan node, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

`nodePools[i].autoscaling.minReplicas`

Opsional
Dapat diubah
Bilangan bulat
Nilai yang memungkinkan: Lebih besar dari atau sama dengan 1
Terisi otomatis: 0

Jumlah minimum node yang dapat ditetapkan oleh penskala otomatis untuk kumpulan.

Contoh:

nodePools:
- name: "my-node-pool"
  autoscaling:
    minReplicas: 5

`nodePools[i].autoscaling.maxReplicas`

Opsional
Dapat diubah
Bilangan bulat
Diisi otomatis: 0

Jumlah maksimum node yang dapat ditetapkan oleh penskala otomatis untuk kumpulan.

Contoh:

nodePools:
- name: "my-node-pool"
  autoscaling:
    maxReplicas: 10

`nodePools[i].enableLoadBalancer`

Opsional
Relevan jika loadBalancer.kind = "MetalLB"
Dapat diubah
Boolean
Terisi otomatis: benar
Default: false

Tetapkan ini ke true jika Anda ingin mengizinkan speaker MetalLB berjalan pada node dalam kumpulan. Jika tidak, tetapkan ke false.

Untuk informasi selengkapnya, lihat Load balancing yang dipaketkan dengan MetalLB.

Contoh:

nodePools:
- name: "my-node-pool"
  enableLoadBalancer: true

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

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.

`enableVMTracking`

Pratinjau
Opsional
Tidak dapat diubah
Diisi otomatis: false

Tetapkan string ini ke true untuk mengaktifkan pelacakan VM dengan tag vSphere. Jika tidak, tetapkan ke false.

Untuk mengetahui informasi lebih lanjut, lihat Mengaktifkan pelacakan VM.

Contoh:

enableVMTracking: true

`nodePoolUpdatePolicy.maximumConcurrentNodePoolUpdate`

Opsional
Bilangan bulat
Nilai yang memungkinkan: 0 atau 1 Terisi otomatis: 0

Jumlah kumpulan node yang akan diperbarui pada satu waktu. Nilai 1 menentukan bahwa satu kumpulan node dapat diupdate dalam satu waktu. Nilai 0 menentukan bahwa jumlah node pool yang tidak terbatas dapat diperbarui dalam satu waktu.

Contoh:

nodePoolUpdatePolicy:
  maximumConcurrentNodePoolUpdate: 1

`authentication`

Bagian ini menyimpan informasi tentang cara pengguna cluster diautentikasi dan diberi otorisasi.

`authentication.oidc`

Jangan gunakan bagian ini. Sebagai gantinya, setelah pembuatan cluster, edit resource kustom ClientConfig seperti yang dijelaskan dalam Mengonfigurasi cluster untuk Anthos Identity Service dengan OIDC .

`authentication.sni`

Opsional

Jika Anda ingin memberikan sertifikat penyajian tambahan untuk server Kubernetes API cluster, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

`authentication.sni.certPath`

Opsional
String

Jalur sertifikat penayangan untuk server Kubernetes API.

Contoh:

authentication:
  sni:
    certPath: "my-cert-folder/example.com.crt"

`authentication.sni.keyPath`

Opsional
String

Jalur file kunci pribadi sertifikat.

Contoh:

authentication:
  sni:
    keyPath: "my-cert-folder/example.com.key"

`gkeConnect`

Wajib
Tidak dapat diubah

Bagian ini berisi informasi tentang project Google Cloud dan akun layanan yang ingin Anda gunakan untuk mendaftarkan cluster Anda ke fleet 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.registerServiceAccountKeyPath`

Wajib
Dapat diubah
String

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

Untuk memperbarui nilai kolom ini, gunakan gkectl update cluster.

Untuk mengetahui informasi cara mengubah kunci akun layanan koneksi pendaftaran, lihat Merotasi kunci akun layanan.

Contoh:

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

`gkeConnect.registerServiceAccountKey.secretRef.version`

Wajib jika menggunakan kredensial yang disiapkan
Dapat Diubah
String
Nilai yang mungkin: String bilangan bulat atau "terbaru"
Nilai default: "latest"

Versi Secret yang disiapkan di cluster admin yang menyimpan kunci JSON untuk akun layanan koneksi register Anda.

Contoh:

gkeConnect:
  registerServiceAccountKey:
    secretRef:
      version: "1"

`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 pengguna di GKE On-Prem API, Anda dapat menggunakan alat standar—Google Cloud Console, Google Cloud CLI, dan Terraform—untuk mengelola siklus proses cluster. Selain itu, dengan mendaftarkan cluster, Anda dapat menggunakan konsol atau gcloud CLI untuk melihat detail cluster. Misalnya, Anda dapat menjalankan perintah gcloud untuk mendapatkan informasi tentang cluster pengguna.

Setelah Anda menambahkan bagian ini dan membuat atau mengupdate cluster, 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`

Wajib jika bagian gkeOnPremAPI disertakan.
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 stackdriver.clusterLocation dan cloudAuditLogging.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 atau biarkan sebagai komentar.

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

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

`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 gkeOnPremAPI.location dan cloudAuditLogging.clusterLocation. 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 memperbarui nilai kolom ini, gunakan gkectl update cluster.

Untuk mengetahui informasi tentang cara mengubah kunci akun layanan pemantauan logging, lihat Merotasi kunci akun layanan.

Contoh:

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

`stackdriver.serviceAccountKey.secretRef.version`

Wajib jika menggunakan kredensial yang disiapkan
Dapat Diubah
String
Nilai yang mungkin: String bilangan bulat atau "terbaru"
Nilai default: "latest"

Versi Secret yang disiapkan di cluster admin yang menyimpan kunci JSON untuk akun layanan pemantauan logging Anda.

Contoh:

stackdriver:
  serviceAccountKey:
    secretRef:
      version: "1"

`stackdriver.disableVsphereResourceMetrics`

Opsional
Dapat diubah
Boolean
Terisi otomatis: false
Default: false

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

Contoh:

stackdriver:
  disableVsphereResourceMetrics: true

`usageMetering`

Pratinjau
Tidak dapat diubah
Opsional

Jika ingin mengaktifkan pengukuran penggunaan untuk cluster Anda, isi bagian ini. Jika tidak, hapus bagian ini atau biarkan sebagai komentar.

`usageMetering.bigQueryProjectID`

Pratinjau
Diperlukan untuk pengukuran penggunaan
Tidak dapat diubah
String

ID project Google Cloud tempat Anda ingin menyimpan data pengukuran penggunaan.

Contoh:

usageMetering:
  bigQueryProjectID: "my-bq-project"

`usageMetering.bigQueryDatasetID`

Pratinjau
Diperlukan untuk pengukuran penggunaan
Tidak dapat diubah
String

ID set data BigQuery tempat Anda ingin menyimpan data pengukuran penggunaan. Contoh:

usageMetering:
  bigQueryDatasetID: "my-bq-dataset"

`usageMetering.bigQueryServiceAccountKeyPath`

Pratinjau
Diperlukan untuk pengukuran penggunaan
String yang tidak dapat diubah
.

Jalur file kunci JSON untuk akun layanan BigQuery Anda.

Untuk memperbarui nilai kolom ini, gunakan gkectl update cluster.

Untuk mengetahui informasi tentang cara mengubah kunci akun layanan BigQuery, lihat Merotasi kunci akun layanan.

Contoh:

usageMetering:
  bigQueryServiceAccountKeyPath: "my-key-folder/bq-key.json"

`usageMetering.bigQueryServiceAccountKey.secretRef.version`

Wajib jika menggunakan kredensial yang disiapkan
Dapat Diubah
String
Nilai yang mungkin: String bilangan bulat atau "terbaru"
Nilai default: "latest"

Versi Secret yang disiapkan di cluster admin yang menyimpan kunci JSON untuk akun layanan BigQuery Anda.

Contoh:

gkeConnect:
  bigQueryServiceAccountKey:
    secretRef:
      version: "1"

`usageMetering.enableConsumptionMetering`

Pratinjau
Diperlukan untuk pengukuran penggunaan
Tidak dapat diubah
Boolean
Diisi otomatis: false

Tetapkan ini ke true jika Anda ingin mengaktifkan pengukuran berbasis konsumsi. Jika tidak, tetapkan ini ke false.

Contoh:

usageMetering:
  enableConsumptionMetering: 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.

`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 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 memperbarui nilai kolom ini, gunakan gkectl update cluster.

Untuk mengetahui informasi tentang cara mengubah kunci akun layanan logging audit, lihat Merotasi kunci akun layanan.

Contoh:

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

`cloudAuditLogging.serviceAccountKey.secretRef.version`

Opsional
Dapat diubah
String
Nilai yang mungkin: String bilangan bulat atau "terbaru"
Nilai default: "latest"

Versi Secret yang disiapkan di cluster admin yang menyimpan kunci JSON untuk akun layanan logging audit Anda.

Contoh:

cloudAuditLogging:
  serviceAccountKey:
    secretRef:
      version: "1"

`autoRepair.enabled`

Opsional
Dapat diubah
Boolean
Terisi otomatis: benar

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

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.

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

Untuk mengetahui informasi tentang cara memperbarui kolom ini untuk cluster yang ada, lihat Enkripsi Secret yang Selalu Aktif.

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.

Untuk mengetahui informasi tentang cara memperbarui kolom ini untuk cluster yang ada, lihat Enkripsi Secret yang Selalu Aktif.

Contoh:

secretsEncryption:
  generatedKey:
    disabled: false