File konfigurasi cluster pengguna 1.30 dan yang lebih baru

File konfigurasi cluster pengguna memungkinkan Anda menentukan spesifikasi dan setelan untuk cluster pengguna di software Distributed Cloud khusus untuk VMware. Anda dapat membuat template untuk file, lalu meninjau kolom wajib diisi, nilai default, dan kolom lain yang tersedia di versi 1.30 dan yang lebih baru.

Membuat template untuk file konfigurasi Anda

Jika Anda menggunakan gkeadm untuk membuat workstation admin, gkeadm akan membuat template untuk file konfigurasi cluster pengguna. gkeadm juga mengisi beberapa kolom untuk Anda.

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

Untuk membuat template file konfigurasi cluster pengguna:

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 menghilangkan flag ini, gkectl akan memberi nama file user-cluster.yaml dan menempatkannya di direktori saat ini.

VERSION: nomor versi Google Distributed Cloud. Contoh: gkectl create-config cluster --gke-on-prem-version=1.36.200-gke.118.

Template

Klik untuk melihat template yang dihasilkan untuk versi 1.36.

apiVersion: v1
kind: UserCluster
# (Required) A unique name for this cluster
name: ""
# (Required) GKE on-prem version (example: 1.3.0-gke.16)
gkeOnPremVersion: 1.34.0-gke.566
# # (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) Enable advanced cluster options
enableAdvancedCluster: 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: ""
#   # Storage policy to use for cluster VM storage and default StorageClass. Do not
#   # specify it together with datastore
#   storagePolicyName: ""
#   # # Datastore to use for cluster VM storage and default StorageClass. Do not specify
#   # # it together with storagePolicyName
#   # 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) 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 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: static
    # (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: static
  #   # # (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: ""
    - 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: ""
    # Shared by all services for ingress traffic
    ingressVIP: ""
  # (Required) Which load balancer to use "ManualLB" or "MetalLB".
  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 "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: 3
  # # (Optional/Preview) Topology domains that user cluster master nodes will be deployed
  # # to. Only 1 element is allowed. Advanced cluster must be enabled and infraConfigFilePath
  # # must be filled in admin cluster
  # topologyDomains:
  # - ""
  # # 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 (default:
  #   # vCenter.storagePolicyName)
  #   storagePolicyName: ""
  # # (Optional) Control plane load balancer configuration. Only supported when advanced
  # # cluster is enabled
  # controlPlaneLoadBalancer:
  #   # # (Optional) The control plane load balancer mode for advanced cluster. Possible values
  #   # # are bundled or manual. Default value is bundled for advanced cluster without topology
  #   # # domains; and is manual for advanced cluster with topology domains.
  #   # mode: ""
# (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/Preview) Topology domains that node pool nodes will be deployed to. Only
  # # 1 element is allowed. Advanced cluster must be enabled and infraConfigFilePath must
  # # be filled in admin cluster
  # topologyDomains:
  # - ""
  # # (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_cgv2
  # # (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 (default: vCenter.storagePolicyName)
  #   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) Additional configurations passed to kube-scheduler. Require advanced
# # cluster is enabled
# schedulerConfiguration:
#   # (Optional) Default TopologySpreadConstraint rule applied to the pod scheduling.
#   # See https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constraints/
#   # for details.
#   defaultTopologySpreadConstraint:
#     typemeta:
#       kind: ""
#       apiversion: ""
#     defaultconstraints:
#     - maxskew: 0
#       topologykey: ""
#       whenunsatisfiable: ""
#       labelselector:
#         matchlabels: {}
#         matchexpressions:
#         - key: ""
#           operator: ""
#           values:
#           - ""
#       mindomains: 0
#       nodeaffinitypolicy: ""
#       nodetaintspolicy: ""
#       matchlabelkeys:
#       - ""
#     defaultingtype: ""
# # (Optional) Configure additional authentication.
# authentication:
#   # (Optional) Provide an additional serving certificate for the API server
#   sni:
#     certPath: ""
#     keyPath: ""
# # (Optional) Configure BinAuthz to enable deploy-time security control to the container
# # images.
# binaryAuthorization:
#   # (Optional) Set value to string "disabled" or "project_singleton_policy_enforce".
#   # Default is "disabled".
#   evaluationMode: ""
# (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
  # 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) 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

Kolom wajib diisi dan nilai default

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

Beberapa kolom wajib diisi secara bersyarat. Misalnya, loadBalancer.metalLB.addressPools diperlukan jika loadBalancer.kind sama dengan MetalLB.

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

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

Mengisi file konfigurasi Anda

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

enableAdvancedCluster

1.33 dan yang lebih tinggi

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

1,32

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

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

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

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

1,31

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

Tetapkan enableAdvancedCluster ke true jika Anda ingin mengaktifkan cluster lanjutan saat membuat cluster baru. Jika flag ini ditetapkan ke true (cluster lanjutan diaktifkan), software Google Distributed Cloud yang mendasarinya akan men-deploy pengontrol yang memungkinkan arsitektur yang lebih dapat diperluas. Mengaktifkan cluster lanjutan akan memberi Anda akses ke fitur dan kemampuan baru, seperti domain topologi. Kolom ini harus memiliki nilai yang sama dengan kolom enableAdvancedCluster cluster admin.

1.30 dan yang lebih lama

Tidak tersedia.

name

Wajib
String

Nama pilihan Anda untuk cluster pengguna. Nama 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

Versi Google Distributed Cloud untuk cluster pengguna Anda.

Contoh:

gkeOnPremVersion: "1.29.0-gke.1456"

preparedSecrets.namespace

Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin, hapus kolom ini. Atau, jika Anda ingin menggunakan kredensial yang telah disiapkan, isi kolom ini.

Immutable
String
Nilai yang mungkin: String yang diawali dengan "gke-onprem-secrets-"

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

Contoh:

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

enableControlplaneV2

1.30 dan yang lebih baru

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

Di versi 1.30 dan yang lebih tinggi, Controlplane V2 diperlukan untuk cluster pengguna baru. Jika Anda menyertakan kolom ini dalam file konfigurasi, kolom tersebut harus ditetapkan ke true.

Untuk memigrasikan cluster yang ada ke Controlplane V2, lihat Memigrasikan cluster pengguna ke fitur yang direkomendasikan. Setelah bermigrasi ke Controlplane V2, Anda tidak dapat menonaktifkan Controlplane V2.

Dengan Controlplane V2, bidang kontrol untuk cluster pengguna berjalan di satu atau beberapa node dalam cluster pengguna itu sendiri. Manfaat Controlplane V2 meliputi:

• Konsistensi arsitektur antara cluster admin dan pengguna.

• Isolasi kegagalan. Kegagalan cluster admin tidak memengaruhi cluster pengguna.

• Pemisahan operasional. Upgrade cluster admin tidak menyebabkan periode nonaktif untuk cluster pengguna.

• Pemisahan deployment. Anda dapat menempatkan cluster admin dan pengguna di domain kegagalan atau situs geografis yang berbeda. Misalnya, cluster pengguna di lokasi edge dapat berada di situs geografis yang berbeda dari cluster admin.

1.29 dan yang lebih rendah

Immutable
Boolean
Prepopulated: true
Default: true

Untuk mengaktifkan Controlplane V2, tetapkan enableControlplaneV2 ke true atau hapus setelan dari file konfigurasi cluster pengguna Anda. Jika tidak, tetapkan ke false. Dengan Controlplane V2, bidang kontrol untuk cluster pengguna berjalan di satu atau beberapa node dalam cluster pengguna itu sendiri. Jika Controlplane V2 tidak diaktifkan, bidang kontrol cluster pengguna akan berjalan di cluster admin.

Sebaiknya aktifkan Controlplane V2.

Contoh:

enableControlplaneV2: true

vCenter

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

Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin, hapus seluruh bagian ini.

Jika Anda menyertakan bagian vCenter dalam file konfigurasi cluster admin:

• 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 berbeda dari yang Anda tentukan untuk cluster admin, isi di sini. Setiap kolom yang Anda isi di sini di bagian vCenter akan menggantikan kolom yang sesuai dalam file konfigurasi cluster admin Anda.

vCenter.address

Immutable
String
Default: Mewarisi dari cluster admin

Alamat IP atau nama host instance vCenter Server 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 vCenter Server yang digunakan oleh cluster admin, maka Controlplane V2 harus diaktifkan, dan Anda harus memberikan nilai untuk network.vCenter.networkName dan semua kolom yang diperlukan di bagian vCenter.

Contoh:

vCenter:
  address: "203.0.113.101"

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

vCenter.datacenter

Immutable
String
Default: Mewarisi dari cluster admin

Jalur relatif pusat data vSphere.

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

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

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

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

Contoh:

vCenter:
  datacenter: "my-uc-data-center"

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

Contoh:

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

vCenter.cluster

Immutable
String
Default: Mewarisi dari cluster admin

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

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

• vCenter.networkName
• vCenter.datacenter
• 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 menyertakan satu atau beberapa folder beserta nama cluster vSphere.

Contoh:

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

vCenter.resourcePool

Immutable
String
Default: Mewarisi dari cluster admin

Resource pool 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.

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
Immutable
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 dalam nilai.

Contoh:

vCenter:
  datastore: "my-datastore"

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

vCenter.storagePolicyName

Opsional
Immutable
String

Nama kebijakan penyimpanan VM untuk node cluster.

Anda juga dapat menentukan kebijakan penyimpanan VM untuk node di node pool tertentu. Namun, kebijakan yang ditentukan di sini berlaku untuk node pool mana pun yang tidak memiliki kebijakannya sendiri.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi kebijakan penyimpanan.

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

vCenter.caCertPath

Dapat diubah
String
Default: Mewarisi dari cluster admin

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

Contoh:

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

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

vCenter.credentials.fileRef.path

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

Dapat diubah
String
Default: Mewarisi dari cluster admin

Nama blok kredensial, dalam 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

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 berisi nama pengguna dan sandi untuk instance vCenter Server yang ingin Anda gunakan untuk cluster pengguna ini.

Contoh:

vCenter:
  credentials:
    secretRef:
      version: "1"

vCenter.folder

Immutable
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 bersifat relatif terhadap /.../DATA_CENTER/vm/.

Nilainya dapat berupa nama folder.

Contoh:

vCenter:
  folder: "my-uc-folder"

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

Contoh:

vCenter:
  folder: "folders/folder-2"

componentAccessServiceAccountKeyPath

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

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

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

Contoh:

componentAccessServiceAccountKey:
  secretRef:
    version: "1"

privateRegistry

Isi bagian ini jika cluster admin Anda menggunakan Container Registry pribadi, dan Anda ingin cluster pengguna menggunakan registry pribadi yang berbeda atau setelan yang berbeda. Jika Anda ingin menggunakan alamat registry pribadi yang berbeda, cluster Anda harus mengaktifkan Controlplane V2. Setelan baru akan diterapkan selama pembuatan dan update cluster.

Jika Anda ingin menggunakan setelan yang sama dengan cluster admin, hapus bagian ini atau biarkan sebagai komentar. Jika Anda mengosongkan bagian ini, image sistem akan ditetapkan secara default ke gcr.io/gke-on-prem-release.

privateRegistry.address

Immutable
String
Default: Mewarisi dari cluster admin

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

Contoh:

privateRegistry:
  address: "203.0.113.10"

privateRegistry:
  address: "fqdn.example.com"

privateRegistry.credentials.fileRef.path

Dapat diubah
String
Default: Mewarisi dari cluster admin

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

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

Contoh:

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

privateRegistry.credentials.fileRef.entry

Dapat diubah
String
Default: Mewarisi dari cluster admin

Nama blok kredensial, dalam 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

String
Nilai yang mungkin: String bilangan bulat atau "latest"
Nilai default: "latest"

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

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

Contoh:

privateRegistry:
  credentials:
    secretRef:
      version: "1"

privateRegistry.caCertPath

Dapat diubah
String
Default: Mewarisi dari cluster admin

Saat Docker mengambil image dari registry pribadi Anda, registry tersebut harus membuktikan identitasnya dengan menunjukkan 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 berisi informasi tentang jaringan cluster pengguna Anda.

network.hostConfig

1.30 dan yang lebih baru

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

Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin (tersedia di versi 1.31 dan yang lebih tinggi), hapus seluruh bagian ini. Jika tidak, bagian ini diperlukan jika satu atau beberapa hal berikut berlaku:

• network.ipMode.type disetel ke static.
• enableControlplaneV2 ditetapkan ke true atau diizinkan untuk ditetapkan ke true secara default. Perhatikan bahwa Controlplane V2 diperlukan untuk cluster pengguna baru.

1.29 dan yang lebih rendah

Bagian ini berisi 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 Anda.

Bagian ini diperlukan jika satu atau beberapa hal berikut terpenuhi:

• network.ipMode.type disetel ke static.
• enableControlplaneV2 ditetapkan ke true atau diizinkan untuk ditetapkan ke true secara default. Load balancer Seesaw tidak didukung di cluster yang mengaktifkan Controlplane V2.
• loadBalancer.kind disetel ke "Seesaw".

network.hostConfig.dnsServers

Wajib
Immutable
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
Immutable
Array string

Alamat server waktu yang akan digunakan VM.

Contoh:

network:
  hostConfig:
    ntpServers:
    - "216.239.35.0"

network.hostConfig.searchDomainsForDNS

Immutable
Array string

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

Contoh:

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

network.ipMode.type

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

Jika Anda ingin node cluster mendapatkan alamat IP-nya dari server DHCP, tetapkan ini ke "dhcp". Jika Anda ingin node cluster memiliki alamat IP statis yang dipilih dari daftar yang Anda berikan, tetapkan ini ke "static". Jika enableControlplaneV2 ditetapkan ke true, setelan ini hanya berlaku untuk worker node.

Contoh:

network:
  ipMode:
    type: "static"

network.ipMode.ipBlockFilePath

Kolom ini wajib diisi jika network.ipMode.type = static atau jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin.

Immutable
String

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

Contoh:

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

network.serviceCIDR

Immutable
String
Prepopulated: "10.96.0.0/20"
>

Rentang alamat IP, dalam format CIDR, yang akan digunakan untuk Service di cluster Anda. Harus minimal rentang /24.

Contoh:

network:
  serviceCIDR: "10.96.0.0/20"

network.podCIDR

Immutable
String
Diisi 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. Harus 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 di luar cluster yang ingin Anda jangkau dari dalam cluster.

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

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

• Alamat IP node di cluster mana pun

• Alamat IP yang digunakan oleh mesin load balancer

• VIP yang digunakan oleh node bidang kontrol dan load balancer

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

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

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

network.vCenter.networkName

Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin, hapus kolom ini. Jika tidak, kolom ini wajib diisi jika vCenter.address berbeda dengan alamat vCenter yang Anda gunakan untuk cluster admin.

Immutable
String

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

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 di semua atau beberapa node cluster Anda.

network.additionalNodeInterfaces[i].networkName

Wajib jika multipleNetworkInterfaces = true
Immutable
String

Nama jaringan vSphere yang akan dihubungkan ke antarmuka node tambahan ini.

Contoh:

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

network.additionalNodeInterfaces[i].type

Wajib jika multipleNetworkInterfaces = true
Immutable
String

Contoh:

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

network.additionalNodeInterfaces[i].ipBlockFilePath

Wajib jika network.additionalNodeInterfaces[i].type = static
Immutable
String

Jalur file blok IP yang berisi 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 infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin, hapus seluruh bagian ini.

Jika tidak, apakah Anda menyertakan bagian ini atau tidak bergantung pada nilai yang Anda tetapkan di enableControlplaneV2:

• Jika enableControlplaneV2 adalah true, isi bagian ini.
• Jika enableControlplaneV2 adalah false, hapus bagian ini.

network.controlPlaneIPBlock.netmask

Wajib jika enableControlplaneV2 = true
Immutable
String

Contoh:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

network.controlPlaneIPBlock.gateway

Wajib jika enableControlplaneV2 = true
Immutable
String

Contoh:

network:
  controlPlaneIPBlock:
    gateway: "172.16.21.1"

network.controlPlaneIPBlock.ips

Wajib jika enableControlplaneV2 = true
Immutable
Array objek, yang masing-masing memiliki alamat IP dan nama host. Nama host diperlukan saat Anda bermigrasi dari Controlplane V1 ke Controlplane V2; jika tidak, bersifat opsional. Nama host harus unik di seluruh vCenter.

Untuk cluster pengguna 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
Immutable
String

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 jika disableBundledIngress = false
Immutable
String

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

Contoh:

loadBalancer:
  vips:
    ingressVIP: "203.0.113.4"

loadBalancer.kind

Tentukan jenis load balancer yang akan digunakan.

1.32 dan yang lebih baru

Wajib
Immutable
String
Diisi otomatis: "MetalLB"

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

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

• Tanpa domain topologi: tetapkan ini ke "ManualLB" atau "MetalLB". Gunakan "ManualLB" jika Anda memiliki load balancer pihak ketiga atau "MetalLB" untuk solusi paket kami. Secara opsional, Anda dapat mengonfigurasi jenis load balancer yang berbeda untuk traffic bidang kontrol. Untuk informasi selengkapnya, lihat masterNode.controlPlaneLoadBalancer.

1,31

Wajib
Immutable
String
Diisi otomatis: "MetalLB"

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

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

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

1,30

Wajib
Immutable
String
Diisi otomatis: "MetalLB"

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

Meskipun Anda dapat mengupgrade cluster yang memiliki kind yang ditetapkan ke "F5BigIP" atau "Seesaw", Anda tidak dapat membuat cluster baru. Untuk mengetahui informasi tentang cara memigrasikan konfigurasi load balancing, lihat Merencanakan migrasi cluster ke fitur yang direkomendasikan.

Contoh:

loadBalancer:
  kind: "MetalLB"

1.29 dan yang lebih lama

Wajib
Immutable
String
Diisi otomatis: "MetalLB"

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

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

Contoh:

loadBalancer:
  kind: "MetalLB"

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

loadBalancer.manualLB

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

loadBalancer.manualLB.ingressHTTPNodePort

Wajib jika loadBalancer.kind = ManualLB (lihat Catatan versi)
Tidak dapat diubah
Bilangan bulat
Diisi otomatis: 30243

Proxy ingress di cluster pengguna diekspos oleh Service Kubernetes jenis LoadBalancer. Service memiliki ServicePort untuk HTTP. Pilih nilai nodePort untuk ServicePort HTTP, dan tetapkan kolom ini ke nilai nodePort.

Catatan versi: Di versi 1.30 dan yang lebih tinggi, port node ingress bersifat opsional untuk cluster yang menggunakan Controlplane V2.

Contoh:

loadBalancer:
  manualLB:
    ingressHTTPNodePort: 32527

loadBalancer.manualLB.ingressHTTPSNodePort

Wajib jika loadBalancer.kind = ManualLB (see Version note)
Tidak dapat diubah
Bilangan bulat
Diisi otomatis: 30879

Proxy ingress di cluster pengguna diekspos oleh Service jenis LoadBalancer. Service memiliki ServicePort untuk HTTPS. Pilih nilai nodePort untuk ServicePort HTTPS, dan tetapkan kolom ini ke nilai nodePort.

Catatan versi: Di versi 1.30 dan yang lebih tinggi, port node ingress bersifat opsional untuk cluster yang menggunakan Controlplane V2.

Contoh:

loadBalancer:
  manualLB:
    ingressHTTPSNodePort: 30139

loadBalancer.manualLB.controlPlaneNodePort

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

Server Kubernetes API dari cluster pengguna berjalan di cluster admin, dan diekspos oleh Service 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
Diisi otomatis: 30563

Server Kubernetes API dari cluster pengguna yang menggunakan kubeception berjalan di cluster admin, dan diekspos oleh Service berjenis 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

1.30 dan yang lebih baru

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

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

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

1.29 dan yang lebih rendah

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

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

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

loadBalancer.f5BigIP.address

1.30 dan yang lebih baru

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

Alamat load balancer F5 BIG-IP Anda.

Contoh:

loadBalancer:
  f5BigIP:
      address: "203.0.113.2"

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = "F5BigIP"
String

Alamat load balancer F5 BIG-IP Anda.

Contoh:

loadBalancer:
  f5BigIP:
      address: "203.0.113.2"

loadBalancer.f5BigIP.credentials.fileRef.path

1.30 dan yang lebih baru

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

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

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

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

Contoh:

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

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = "F5BigIP"
String

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

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

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

Contoh:

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

loadBalancer.f5BigIP.credentials.fileRef.entry

1.30 dan yang lebih baru

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

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

Contoh:

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

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = "F5BigIP"
String

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

Contoh:

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

loadBalancer.f5BigIP.partition

1.30 dan yang lebih baru

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

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

Contoh:

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

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = "F5BigIP"
String

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

Contoh:

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

loadBalancer.f5BigIP.snatPoolName

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Diperlukan jika loadBalancer.kind = "F5BigIP" dan Anda menggunakan SNAT
String

Nama pool SNAT Anda.

Contoh:

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

1.29 dan yang lebih rendah

Diperlukan jika loadBalancer.kind = "F5BigIP" dan Anda menggunakan SNAT
String

Nama pool SNAT Anda.

Contoh:

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

loadBalancer.seesaw

1.30 dan yang lebih baru

Di versi 1.30 dan yang lebih tinggi, nilai "Seesaw" tidak diizinkan untuk loadbalancer.kind untuk cluster pengguna baru karena load balancer ini tidak didukung dengan fitur baru dan lanjutan. Jika bagian loadBalancer.seesaw ada dalam file konfigurasi, hapus atau jadikan sebagai komentar.

Sebagai gantinya, Anda dapat mengonfigurasi load balancer MetalLB yang dipaketkan. Untuk mengaktifkan load balancer MetalLB, tetapkan loadbalancer.kind ke "MetalLB" dan isi bagian loadBalancer.metalLB. Untuk mengetahui informasi selengkapnya, lihat Load balancing paket dengan MetalLB.

1.29 dan yang lebih rendah

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

Perhatikan batasan berikut terkait load balancer SeeSaw:

• 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 menggunakan fitur ini, sebaiknya konfigurasikan load balancer MetalLB. Untuk mengaktifkan load balancer MetalLB, tetapkan loadbalancer.kind ke "MetalLB" dan isi bagian loadBalancer.metalLB. Untuk mengetahui informasi selengkapnya, lihat Load balancing paket dengan MetalLB.

loadBalancer.seesaw.ipBlockFilePath

1.30 dan yang lebih baru

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

Jalur file blok IP untuk VM Seesaw Anda.

Contoh:

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

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = Seesaw
Immutable
String

Jalur file blok IP untuk VM Seesaw Anda.

Contoh:

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

loadBalancer.seesaw.vrid

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Diperlukan jika loadBalancer.kind = Seesaw
Immutable
Bilangan bulat
Nilai yang mungkin: 1 - 255
Diisi otomatis: 0

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

Contoh:

loadBalancer:
  seesaw:
    vrid: 125

1.29 dan yang lebih rendah

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

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

Contoh:

loadBalancer:
  seesaw:
    vrid: 125

loadBalancer.seesaw.masterIP

1.30 dan yang lebih baru

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

Alamat IP virtual yang dikonfigurasi di VM Seesaw Master Anda.

Contoh:

loadBalancer:
  seesaw:
    masterIP: 172.16.20.21

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = Seesaw
Immutable
String

Alamat IP virtual yang dikonfigurasi di VM Seesaw Master Anda.

Contoh:

loadBalancer:
  seesaw:
    masterIP: 172.16.20.21

loadBalancer.seesaw.cpus

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Diperlukan jika loadBalancer.kind = Seesaw
Dapat diubah
Bilangan bulat
Diisi otomatis: 4

Jumlah CPU untuk setiap VM Seesaw Anda.

Contoh:

loadBalancer:
  seesaw:
    cpus: 8

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = Seesaw
Dapat diubah
Bilangan bulat
Diisi otomatis: 4

Jumlah CPU untuk setiap VM Seesaw Anda.

Contoh:

loadBalancer:
  seesaw:
    cpus: 8

loadBalancer.seesaw.memoryMB

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Diperlukan jika loadBalancer.kind = Seesaw
Dapat diubah
Bilangan bulat
Diisi otomatis: 3072

Jumlah mebibyte memori untuk setiap VM Seesaw Anda.

Contoh:

loadBalancer:
  seesaw:
    memoryMB: 8192

Catatan: Kolom ini menentukan jumlah mebibyte memori, bukan jumlah megabyte. Satu mebibyte adalah 2²⁰ = 1.048.576 byte. Satu megabyte adalah 10⁶ = 1.000.000 byte.

1.29 dan yang lebih rendah

Wajib jika loadBalancer.kind = Seesaw
Dapat diubah
Bilangan bulat
Diisi otomatis: 3072

Jumlah mebibyte memori untuk setiap VM Seesaw Anda.

Contoh:

loadBalancer:
  seesaw:
    memoryMB: 8192

Catatan: Kolom ini menentukan jumlah mebibyte memori, bukan jumlah megabyte. Satu mebibyte adalah 2²⁰ = 1.048.576 byte. Satu megabyte adalah 10⁶ = 1.000.000 byte.

loadBalancer.seesaw.vCenter.networkName

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Immutable
String
Default: Sama seperti node cluster

Nama jaringan vCenter yang berisi VM Seesaw Anda.

Contoh:

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

1.29 dan yang lebih rendah

Immutable
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

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Immutable
Relevan jika loadBalancer.kind = Seesaw
Boolean
Diisi otomatis: false
Default: false

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

Contoh:

loadBalancer:
  seesaw:
    enableHA: true

1.29 dan yang lebih rendah

Immutable
Relevant if loadBalancer.kind = Seesaw
Boolean
Prepopulated: false
Default: false

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

Contoh:

loadBalancer:
  seesaw:
    enableHA: true

loadBalancer.seesaw.disableVRRPMAC

1.30 dan yang lebih baru

Tidak diizinkan untuk cluster baru
Immutable
Relevan jika loadBalancer.kind = Seesaw
Boolean
Diisi otomatis: true
Default: true

Jika ditetapkan ke true (direkomendasikan), load balancer Seesaw tidak menggunakan pembelajaran MAC untuk failover. Sebagai gantinya, load balancer ini menggunakan ARP gratis. Jika kolom ini ditetapkan ke false, load balancer Seesaw akan menggunakan pembelajaran MAC. Jika Anda menggunakan vSphere 7 atau yang lebih baru, dan memiliki load balancer Seesaw ketersediaan tinggi, kolom ini harus ditetapkan ke true.

Contoh:

loadBalancer:
  seesaw:
    disableVRRPMAC: true

1.29 dan yang lebih rendah

Immutable
Relevant if loadBalancer.kind = Seesaw
Boolean
Prepopulated: true
Default: true

Jika Anda menetapkan ini ke true (direkomendasikan), load balancer Seesaw tidak akan menggunakan pembelajaran MAC untuk failover. Sebagai gantinya, load balancer ini menggunakan ARP gratis. Jika Anda menetapkan ini ke false, load balancer Seesaw akan menggunakan MAC learning. Jika Anda menggunakan vSphere 7 atau yang lebih baru, dan memiliki load balancer Seesaw 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 mengetahui informasi selengkapnya, lihat Load balancing yang dipaketkan dengan MetalLB.

loadBalancer.metalLB.addressPools

Wajib jika loadBalancer.kind = MetalLB
Dapat diubah (lihat pengecualian)

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

1.32 dan yang lebih baru

Perilaku kolom ini sama saat enableAdvancedCluster ditetapkan ke true (cluster lanjutan diaktifkan) atau false (cluster lanjutan tidak diaktifkan). Dalam kedua kasus tersebut, array tidak sepenuhnya dapat diubah. Anda dapat menambahkan kumpulan alamat, tetapi menghapus kumpulan alamat dari array kumpulan alamat yang ada tidak didukung.

1,31

Perilaku kolom ini bergantung pada apakah enableAdvancedCluster ditetapkan ke true (cluster lanjutan diaktifkan) atau false (cluster lanjutan tidak diaktifkan):

• Jika cluster lanjutan diaktifkan: array tidak sepenuhnya dapat diubah. Anda dapat menambahkan kumpulan alamat, tetapi menghapus kumpulan alamat dari array kumpulan alamat yang ada tidak didukung.

• Jika cluster lanjutan tidak diaktifkan: array dapat diubah. Anda dapat menambahkan dan menghapus kumpulan alamat dari array kumpulan alamat yang ada.

1.30 dan yang lebih lama

Anda dapat menambahkan dan menghapus kumpulan alamat dari array kumpulan alamat yang ada.

loadBalancer.metalLB.addressPools[i].name

Wajib jika loadBalancer.kind = MetalLB
Dapat diubah (lihat pengecualian)
String

Nama pilihan Anda untuk kumpulan alamat.

1.32 dan yang lebih baru

Perilaku kolom ini sama seperti saat enableAdvancedCluster ditetapkan ke true (cluster lanjutan diaktifkan) atau false (cluster lanjutan tidak diaktifkan). Dalam kedua kasus tersebut, mengubah nama setelah cluster dibuat tidak didukung.

1,31

Perilaku kolom ini bergantung pada apakah enableAdvancedCluster ditetapkan ke true (cluster lanjutan diaktifkan) atau false (cluster lanjutan tidak diaktifkan):

• Jika cluster lanjutan diaktifkan: mengubah nama setelah cluster dibuat tidak didukung.

• Jika cluster lanjutan tidak diaktifkan: Anda dapat mengubah nama pool setelah cluster dibuat.

1.30 dan yang lebih lama

Anda dapat mengubah nama pool setelah cluster dibuat.

Contoh:

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

loadBalancer.metalLB.addressPools[i].addresses

Wajib jika loadBalancer.kind = MetalLB
Dapat diubah (lihat pengecualian)

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

1.32 dan yang lebih baru

Perilaku kolom ini sama seperti saat enableAdvancedCluster ditetapkan ke true (cluster lanjutan diaktifkan) atau false (cluster lanjutan tidak diaktifkan). Dalam kedua kasus tersebut, Anda dapat menambahkan alamat ke kumpulan alamat yang ada, tetapi menghapus alamat tidak didukung.

1,31

Perilaku kolom ini bergantung pada apakah enableAdvancedCluster ditetapkan ke true (cluster lanjutan diaktifkan) atau false (cluster lanjutan tidak diaktifkan):

• Jika cluster lanjutan diaktifkan: Anda dapat menambahkan alamat ke kumpulan alamat yang ada, tetapi menghapus alamat tidak didukung.

• Jika cluster lanjutan tidak diaktifkan: Anda dapat menambahkan dan menghapus alamat dari kumpulan alamat yang ada.

1.30 dan yang lebih lama

Anda dapat menambahkan dan menghapus alamat dari kumpulan alamat yang ada.

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

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

Jika Anda menetapkan ini ke true, pengontrol MetalLB tidak akan menetapkan alamat IP yang berakhiran .0 atau .255 ke Service. Hal ini menghindari masalah perangkat konsumen yang bermasalah yang secara keliru menghapus 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

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

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

Jika tidak, tetapkan ke false.

Contoh:

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

enableDataplaneV2

1.30 dan yang lebih baru

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

Kolom ini mengontrol Container Network Interface (CNI) yang digunakan cluster. Mengaktifkan Dataplane V2 diperlukan untuk menggunakan Controlplane V2. Anda dapat mengubah kolom dari false menjadi true untuk mengaktifkan Dataplane V2, tetapi menonaktifkan Dataplane V2 tidak diizinkan.

• Di versi 1.30 dan yang lebih tinggi, Dataplane V2 diperlukan untuk cluster pengguna baru dan harus ditetapkan ke true. Untuk memigrasikan cluster 1.30 yang ada ke Dataplane V2, lihat Memigrasikan cluster pengguna ke fitur yang direkomendasikan.

• Di versi 1.31, Dataplane V2 diperlukan untuk semua cluster. Sebelum mengupgrade ke versi 1.31, ikuti langkah-langkah di bagian Mengaktifkan Dataplane V2.

Manfaat Dataplane V2 meliputi:

• Dataplane V2 memberi Anda Container Network Interface (CNI) yang lebih canggih dan mumpuni jika dibandingkan dengan opsi CNI sebelumnya, Calico. Calico berada dalam mode pemeliharaan, yang berarti hanya menerima perbaikan bug penting dan update keamanan, tetapi tidak ada pengembangan fitur baru. Sebaliknya, Dataplane V2 dikembangkan dan ditingkatkan secara aktif, sehingga memastikan Anda memiliki akses ke inovasi dan kemampuan jaringan terbaru.

• Dataplane V2 adalah CNI yang direkomendasikan untuk GKE dan produk Google Distributed Cloud lainnya.

1.29 dan yang lebih rendah

Immutable
Boolean
Prepopulated: true
Default: false

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

Sebaiknya aktifkan Dataplane V2.

Contoh:

  enableDataplaneV2: true

Lihat Memecahkan masalah NFS dan DataPlane v2 Google Distributed Cloud untuk mengetahui langkah-langkah pemecahan masalah.

dataplaneV2.forwardMode

Dapat diubah
String
Nilai yang mungkin: "snat", "dsr"
Diisi otomatis: "snat"
Default: "snat"

Mode penerusan untuk cluster yang mengaktifkan Dataplane V2.

Dengan mode penafsiran alamat jaringan sumber (SNAT), paket akan diterjemahkan 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 direct server return (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 ditampilkan akan langsung menuju ke klien tanpa melewati node load balancer.

Contoh:

dataplaneV2:
  forwardMode: "dsr"

multipleNetworkInterfaces

Immutable
Boolean
Prepopulated: false
Default: false

Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin, kolom ini harus false.

Jika Anda ingin mengaktifkan beberapa antarmuka jaringan untuk Pod, tetapkan ini ke true.

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

Contoh:

multipleNetworkInterfaces: true

advancedNetworking

Immutable
boolean
Prepopulated: false
Default: false

Jika Anda berencana membuat gateway NAT egress, tetapkan ini ke true. Jika tidak, tetapkan ke false.

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

Contoh:

advancedNetworking: true

disableBundledIngress

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

Boolean
Dapat diubah
Diisi otomatis: false
Default: false

Contoh:

disableBundledIngress: true

storage.vSphereCSIDisabled

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

Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin, kolom ini harus true.

Dapat diubah
Boolean
Diisi otomatis: false
Default: false

Contoh:

storage:
  vSphereCSIDisabled: false

masterNode

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

masterNode.controlPlaneLoadBalancer

1.32 dan yang lebih baru

Secara opsional, sertakan bagian ini untuk menentukan jenis load balancer yang akan digunakan untuk traffic bidang kontrol di cluster pengguna. Sertakan masterNode.controlPlaneLoadBalancer.mode dalam file konfigurasi Anda jika Anda ingin secara eksplisit menetapkan jenis load balancer yang akan digunakan, bukan mengandalkan nilai default. Selain itu, Anda harus menetapkan loadBalancer.kind dalam file konfigurasi untuk menentukan jenis load balancer yang akan digunakan untuk bidang data.

masterNode.controlPlaneLoadBalancer.mode

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

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

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

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

Contoh:

adminMaster:
  controlPlaneLoadBalancer:
    mode: "manual"

1.31 dan yang lebih lama

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

masterNode.cpus

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

Dapat diubah
Bilangan bulat
Diisi otomatis: 8192
Default: 8192

Memori dalam mebibyte untuk setiap node yang berfungsi sebagai bidang kontrol untuk cluster pengguna ini. Harus kelipatan 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 megabyte adalah 10^6 = 1.000.000 byte.

masterNode.replicas

Tidak dapat diubah
Bilangan bulat
Nilai yang mungkin: 1 atau 3
Diisi otomatis: 1
Default: 1

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

Jika kolom enableAdvancedCluster adalah true, Anda harus menetapkan kolom ini ke 3. Hanya cluster pengguna yang sangat tersedia (HA) yang didukung di cluster lanjutan.

Contoh:

masterNode:
  replicas: 3

masterNode.autoResize.enabled

Dapat diubah
Boolean
Diisi otomatis: false
Default: false

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

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

Contoh:

masterNode:
  autoResize:
    enabled: true

masterNode.vsphere

Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin, hapus seluruh bagian ini.

masterNode.vsphere.datastore

Opsional
Immutable
String
Default: Nilai vCenter.datastore

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

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

Contoh:

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

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

masterNode.vsphere.storagePolicyName

Opsional
Immutable
String
Default: Nilai vCenter.storagePolicyName

Nama kebijakan penyimpanan VM untuk node bidang kontrol.

Untuk mengetahui 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.

masterNode.topologyDomains

1.32 dan yang lebih baru

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

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

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

1,31

Pratinjau
Opsional
Array string | Namun, hanya satu elemen yang didukung
Immutable
Default: vSphereInfraConfig.defaultTopologyDomain jika ditentukan dalam file konfigurasi infrastruktur vSphere

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

1.30 dan yang lebih lama

Tidak tersedia.

nodePools

Wajib
Dapat diubah
Array objek, yang masing-masing mendeskripsikan node pool.

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

nodePools[i].name

Wajib
Immutable
String

Nama pilihan Anda untuk node pool. Nama 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 node pool worker yang dipilih tetap berada di versi sebelumnya.

Jika Anda ingin worker node pool ini tetap menggunakan versi sebelumnya, tetapkan ke versi sebelumnya. Jika tidak, hapus kolom ini atau tetapkan ke string kosong. Opsi ini hanya tersedia untuk worker node pool. Node pool load balancer (node pool dengan enableLoadBalancer: true) harus cocok dengan gkeOnPremVersion cluster. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade cluster pengguna.

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

Contoh:

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

nodePools[i].memoryMB

Wajib
Dapat diubah
Bilangan bulat
Diisi otomatis: 8192

Memori dalam mebibyte untuk setiap node dalam pool. Harus kelipatan 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 megabyte adalah 10^6 = 1.000.000 byte.

nodePools[i].replicas

Wajib
Dapat diubah
Bilangan bulat
Diisi otomatis: 3
Nilai yang mungkin: Jumlah total node yang tidak tercemar di semua node pool dalam cluster harus minimal 3.

Jumlah node dalam pool.

Contoh:

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

nodePools[i].bootDiskSizeGB

Dapat diubah
Bilangan bulat
Diisi otomatis: 40
Default: 40

Ukuran boot disk dalam gibibyte untuk setiap node dalam pool.

Contoh:

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

nodePools[i].osImageType

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

Jenis image OS yang akan dijalankan di VM dalam node pool.

Di versi 1.32, node pool Windows Server tidak digunakan lagi dan tidak akan tersedia di versi 1.33 dan yang lebih baru. Dukungan untuk node pool Windows Server akan berakhir pada 5 Mei 2026. Sebaiknya jangan gunakan "windows" sebagai jenis OS image di cluster baru.

Perhatikan batasan berikut terkait cluster lanjutan:

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

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

Contoh:

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

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 mengetahui informasi selengkapnya, lihat Panduan pengguna untuk node pool OS Windows Server.

nodePools[i].labels

Pemetaan
Mutable

Label yang akan diterapkan ke setiap objek Node Kubernetes di pool.

Contoh:

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

Kubelet tidak dapat menerapkan label ke dirinya sendiri di namespace tertentu karena alasan keamanan.

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

nodePools[i].taints

Mutable
Array objek, yang masing-masing menjelaskan taint Kubernetes yang diterapkan ke setiap node dalam pool. Taint adalah key-value pair yang terkait dengan effect. Taint digunakan dengan toleransi untuk penjadwalan Pod. Tentukan salah satu dari berikut ini untuk effect: NoSchedule, PreferNoSchedule, NoExecute.

Contoh:

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

nodePools[i].vsphere

Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin, hapus semua kolom di bagian nodePools[i].vsphere kecuali untuk nodePools[i].vsphere.tags.

nodePools[i].vsphere.datastore

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

Dapat diubah
String
Default: Nilai vCenter.storagePolicyName

Nama kebijakan penyimpanan VM untuk node di pool.

Untuk mengetahui 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.hostgroups

Isi bagian ini jika Anda ingin mengonfigurasi cluster untuk menggunakan afinitas host VM. Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin, konfigurasikan grup host di kolom topologyDomains[i].compute.hostGroups pada file konfigurasi infrastruktur vSphere.

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

Array hanya dapat memiliki satu elemen.

Contoh:

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

nodePools[i].vsphere.tags

Mutable
Array objek, yang masing-masing menjelaskan tag vSphere yang akan ditempatkan pada VM di node pool.

Setiap tag memiliki kategori dan nama.

Contoh:

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

Jika Anda ingin melampirkan tag ke semua VM dalam node pool, akun pengguna vCenter Anda harus memiliki hak istimewa pemberian tag vSphere berikut:

• vSphere Tagging.Assign or Unassign vSphere Tag
• vSphere Tagging.Assign or Unassign vSphere Tag on Object (vSphere 7)

nodePools[i].autoscaling

Dapat diubah

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

nodePools[i].autoscaling.minReplicas

Dapat diubah
Bilangan bulat
Nilai yang mungkin: Lebih besar dari atau sama dengan 1
Diisi otomatis: 0

Jumlah minimum node yang dapat ditetapkan oleh autoscaler untuk pool.

Contoh:

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

nodePools[i].autoscaling.maxReplicas

Dapat diubah
Bilangan bulat
Diisi otomatis: 0

Jumlah maksimum node yang dapat ditetapkan oleh autoscaler untuk pool.

Contoh:

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

nodePools[i].enableLoadBalancer

Relevan jika loadBalancer.kind = "MetalLB"
Dapat diubah
Boolean
Diisi otomatis: true
Default: false

1.32 dan yang lebih baru

Perilaku kolom ini sama saat enableAdvancedCluster ditetapkan ke true (cluster lanjutan diaktifkan) atau false (cluster lanjutan tidak diaktifkan). Dalam kedua kasus tersebut, tetapkan ini ke true jika Anda ingin mengizinkan speaker MetalLB berjalan di node dalam kumpulan. Jika tidak, tetapkan ke false.

1,31

Perilaku kolom ini bergantung pada apakah enableAdvancedCluster ditetapkan ke true (cluster lanjutan diaktifkan) atau false (cluster lanjutan tidak diaktifkan):

• Jika cluster lanjutan diaktifkan: kolom ini tidak berpengaruh karena speaker MetalLB akan selalu berjalan di node bidang kontrol cluster pengguna.

• Jika cluster lanjutan tidak diaktifkan: tetapkan ini ke true jika Anda ingin mengizinkan speaker MetalLB berjalan pada node di pool. Jika tidak, tetapkan ke false.

1.29 dan yang lebih rendah

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

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

Catatan: Node pool load balancer (enableLoadBalancer: true) harus memiliki versi yang sama dengan versi cluster (gkeOnPremVersion). Ketidaksesuaian versi dan upgrade node pool load balancer secara terpisah dari cluster tidak didukung.

Contoh:

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

nodePools[i].updateStrategy.rollingUpdate.maxSurge

Pratinjau
Dapat diubah
Bilangan bulat
Default: 1

Jumlah maksimum mesin dalam node pool yang dapat diupdate secara bersamaan selama update atau upgrade.

nodePools:
- name: "my-node-pool"
  updateStrategy:
    rollingUpdate:
      maxSurge: 3

nodePools[i].topologyDomains

1.31 dan yang lebih baru

Jika infraConfigFilePath dikonfigurasi dalam file konfigurasi cluster admin (yang mengaktifkan domain topologi), sertakan kolom ini secara opsional.

Array string | Namun, hanya satu elemen yang didukung
Immutable
Default: vSphereInfraConfig.defaultTopologyDomain jika ditentukan dalam file konfigurasi infrastruktur vSphere

Node dalam node pool ini akan dimasukkan ke dalam domain topologi yang ditentukan oleh kolom ini. Untuk setiap node pool, hanya satu domain topologi yang diizinkan. Semua node dalam node pool akan dimasukkan ke dalam satu domain topologi.

1.30 dan yang lebih lama

Tidak tersedia.

schedulerConfiguration

1.32 dan yang lebih baru

Pratinjau
Opsional

Saat menyiapkan domain topologi, Anda dapat menyiapkan konfigurasi tambahan yang akan diteruskan ke kube-scheduler.

schedulerConfiguration.defaultTopologySpreadConstraint

Pratinjau
Opsional
Immutable

Objek yang menentukan aturan batasan penyebaran topologi default tingkat cluster yang diterapkan ke penjadwalan Pod. Saat cluster pengguna dibuat dengan domain topologi, jika aturan ini dikonfigurasi, kube-scheduler akan mengambil kunci topologi default dan menyebarkan Pod Deployment, Statefulset, dan Replicaset di dalamnya secara default. Strukturnya sama dengan batasan default level cluster Kubernetes.

Contoh:

schedulerConfiguration:
  defaultTopologySpreadConstraint:
    defaultConstraints:
    - maxSkew: 1
      topologyKey: topology.kubernetes.io/zone
      whenUnsatisfiable: ScheduleAnyway
    defaultingType: List

Untuk mengetahui detailnya, lihat Batasan default tingkat cluster dalam dokumentasi Kubernetes.

1.31 dan yang lebih lama

Tidak tersedia.

antiAffinityGroups.enabled

Dapat diubah
Boolean
Diisi otomatis: true
Default: true

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

Fitur ini mengharuskan lingkungan vSphere Anda memenuhi kondisi berikut:

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

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

• Tersedia minimal empat host ESXi.

Meskipun aturan mengharuskan node cluster tersebar di tiga host ESXi, kami sangat menyarankan agar Anda memiliki setidaknya empat host ESXi yang tersedia.

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

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

Perhatikan batasan berikut terkait cluster lanjutan:

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

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

Contoh:

antiAffinityGroups:
  enabled: false

enableVMTracking

Pratinjau
Tidak dapat diubah
Diisi otomatis: false

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

Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan pelacakan VM.

Contoh:

enableVMTracking: true

nodePoolUpdatePolicy.maximumConcurrentNodePoolUpdate

Dapat diubah
Bilangan bulat

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

Cluster lanjutan

Perhatikan batasan berikut terkait cluster lanjutan:

• Versi 1.31: jika kolom enableAdvancedCluster adalah true, kebijakan update node pool tidak didukung di cluster lanjutan, jadi hapus bagian ini dari file konfigurasi Anda.

• Versi 1.32: kebijakan update node pool didukung di cluster lanjutan.

• Nilai default maximumConcurrentNodePoolUpdate bervariasi menurut versi:

  • Versi 1.32.0-1.32.1000 : Nilai defaultnya adalah 1.
  • Versi 1.32.1100+: Nilai defaultnya adalah 0.
  • Versi 1.33.0-1.33.600: Nilai defaultnya adalah 1.
  • Versi 1.33.700+: Nilai defaultnya adalah 0.
  • Versi 1.34.0-1.34.200: Nilai defaultnya adalah 1.
  • Versi 1.34.300+: Nilai defaultnya adalah 0.

Cluster non-lanjutan

Nilai yang mungkin: 0 atau 1
Diisi otomatis: 0
Default: 0

Contoh:

nodePoolUpdatePolicy:
  maximumConcurrentNodePoolUpdate: 1

Catatan: Memperbarui konfigurasi ini saja tidak akan memengaruhi workload.

nodePoolUpdatePolicy.updateStrategy.rollingUpdate.maxSurge

Pratinjau
Dapat diubah
Bilangan bulat
Default: 1

Jumlah maksimum mesin dalam node pool yang dapat diupdate secara bersamaan selama update atau upgrade. Berlaku untuk node pool apa pun yang tidak menentukan strategi update-nya sendiri.

nodePools:
- name: "my-node-pool"
  updateStrategy:
    rollingUpdate:
      maxSurge: 3

authentication

Bagian ini berisi informasi tentang cara pengguna cluster diautentikasi dan diotorisasi.

authentication.oidc

Cluster lanjutan

authentication.oidc.issuerURL

Opsional
String

URL tempat permintaan otorisasi dikirim ke penyedia OpenID Connect (OIDC) Anda. Server Kubernetes API menggunakan URL ini untuk menemukan kunci publik agar dapat memverifikasi token. URL harus menggunakan HTTPS.

authentication.oidc.kubectlRedirectURL

Opsional
String

URL pengalihan yang digunakan kubectl untuk otorisasi. Saat mengaktifkan OIDC, Anda harus menentukan nilai kubectlRedirectURL.

authentication.oidc.clientID

Opsional
String

ID untuk aplikasi klien yang membuat permintaan autentikasi ke penyedia OpenID.

authentication.oidc.username

Opsional
String

Klaim JSON Web Token (JWT) yang akan digunakan sebagai nama pengguna.

authentication.oidc.usernamePrefix

Opsional
String

Awalan yang ditambahkan ke klaim nama pengguna.

authentication.oidc.group

Opsional
String

Klaim Token Web JSON (JWT) yang digunakan penyedia untuk menampilkan grup keamanan Anda.

authentication.oidc.groupPrefix

Opsional
String

Awalan ditambahkan ke klaim grup untuk mencegah konflik dengan nama yang sudah ada. Misalnya, jika ada grup dev dan awalan oidc:, oidc:dev.

authentication.oidc.scopes

Opsional
String

Cakupan tambahan yang akan dikirim ke OIDC sebagai comma separated list.

authentication.oidc.extraParams

Opsional
String

Parameter nilai kunci tambahan yang akan dikirim ke OIDC sebagai comma separated list.

authentication.oidc.deployCloudConsoleProxy

Opsional
Boolean
Default: false

Menentukan apakah reverse proxy di-deploy di cluster untuk menghubungkan konsolGoogle Cloud ke penyedia identitas lokal yang tidak dapat diakses secara publik melalui internet. Jika penyedia identitas Anda tidak dapat dijangkau melalui internet publik, tetapkan kolom ini ke true untuk melakukan autentikasi dengan konsolGoogle Cloud .

authentication.oidc.caPath

Opsional
String

Perhatian: Kolom ini hanya tersedia di 1.32.800+, 1.33.400+, 1.34.100+.

Jalur absolut atau relatif ke file CA.

Cluster non-lanjutan

Jangan gunakan bagian ini. Sebagai gantinya, setelah pembuatan cluster, edit resource kustom ClientConfig seperti yang dijelaskan dalam Menyiapkan cluster anggota fleet untuk autentikasi OIDC.

authentication.sni

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

Catatan: SNI untuk cluster pengguna Controlplane v2 didukung di versi 1.28 dan yang lebih baru.

authentication.sni.certPath

Immutable
String

Jalur sertifikat penyaluran untuk server Kubernetes API.

Contoh:

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

authentication.sni.keyPath

Opsional
Immutable
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 dan akun layanan Google Cloud yang ingin Anda gunakan untukmendaftarkan clusterke fleet Google Cloud .

gkeConnect.projectID

Wajib
Immutable
String

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

Contoh:

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

gkeConnect.location

Immutable
String
Default: global

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

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

• Cluster baru yang dibuat menggunakan klien GKE On-Prem API— konsol Google Cloud , Google Cloud CLI, atau Terraform—menggunakan region yang sama dengan yang Anda tentukan untuk GKE On-Prem API.

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

Penting: Jika Anda berencana menginstal Cloud Service Mesh di cluster regional, Anda harus menginstal versi 1.19.3 atau yang lebih baru.

Contoh:

gkeConnect:
  location: "us-central1"

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 tentang cara mengubah kunci akun layanan connect-register, lihat Merotasi kunci akun layanan.

Contoh:

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

gkeConnect.registerServiceAccountKey.secretRef.version

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

Versi Secret yang disiapkan di cluster admin yang berisi kunci JSON untuk akun layanan connect-register Anda.

Contoh:

gkeConnect:
  registerServiceAccountKey:
    secretRef:
      version: "1"

gkeOnPremAPI

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

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

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

Dengan mendaftarkan cluster pengguna di GKE On-Prem API, Anda dapat menggunakan alat standar—konsol Google Cloud , Google Cloud CLI, dan Terraform—untuk mengelola siklus proses cluster. Selain itu, mendaftarkan cluster memungkinkan Anda 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 selanjutnya Anda menghapus bagian tersebut dan mengupdate cluster, update akan gagal.

gkeOnPremAPI.enabled

Dapat diubah
Boolean
Default: true

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

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

gkeOnPremAPI:
  enabled: false

gkeOnPremAPI.location

Immutable
String
Default: stackdriver.clusterLocation

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

stackdriver

Wajib
Dapat diubah

Bagian ini berisi konfigurasi yang diperlukan untuk Cloud Logging dan Cloud Monitoring.

stackdriver.projectID

Diperlukan untuk Logging dan Monitoring
Immutable
String

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

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

Contoh:

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

stackdriver.clusterLocation

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

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

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

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

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

Contoh:

stackdriver:
  clusterLocation: "us-central1"

stackdriver.serviceAccountKeyPath

Diperlukan untuk Logging dan Pemantauan
Dapat diubah
String

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

Untuk memperbarui nilai kolom ini, gunakan gkectl update cluster.

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

Contoh:

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

stackdriver.serviceAccountKey.secretRef.version

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

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

Contoh:

stackdriver:
  serviceAccountKey:
    secretRef:
      version: "1"

stackdriver.disableVsphereResourceMetrics

Dapat diubah
Boolean
Diisi otomatis: false
Default: false

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

Contoh:

stackdriver:
  disableVsphereResourceMetrics: true

usageMetering

1.32 dan yang lebih baru

Fitur pengukuran penggunaan tidak didukung di versi 1.32 dan yang lebih tinggi. Jangan sertakan bagian ini saat Anda membuat cluster baru. Namun, cluster yang sudah ada yang menggunakan fitur ini akan terus berfungsi. Sebagai alternatif, sebaiknya gunakan dasbor standar, Anthos Cluster Utilization Metering, untuk memahami penggunaan resource di berbagai level. Hubungi Cloud Customer Care jika alternatif tersebut tidak memenuhi kasus penggunaan Anda.

1.30 dan 1.31

Sebaiknya jangan gunakan fitur pratinjau ini saat Anda membuat cluster baru. Namun, cluster yang sudah ada yang menggunakan fitur ini akan terus berfungsi. Sebagai alternatif, sebaiknya gunakan dasbor standar, Anthos Cluster Utilization Metering, untuk memahami penggunaan resource di berbagai level.

Jika kolom enableAdvancedCluster adalah true, hapus bagian ini. Pengukuran penggunaan tidak didukung di cluster lanjutan.

1.29 dan yang lebih rendah

Pratinjau
Immutable

Sebaiknya jangan gunakan fitur pratinjau ini saat Anda membuat cluster baru. Namun, cluster yang sudah ada yang menggunakan fitur ini akan terus berfungsi. Sebagai alternatif, sebaiknya gunakan dasbor standar, Anthos Cluster Utilization Metering, untuk memahami penggunaan resource di berbagai level.

usageMetering.bigQueryProjectID

Pratinjau
Diperlukan untuk pengukuran penggunaan
Immutable
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
Immutable
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
Immutable
String.

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

Dapat diubah
String
Nilai yang mungkin: String bilangan bulat atau "latest"
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
Immutable
Boolean
Diisi otomatis: false

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

Contoh:

usageMetering:
enableConsumptionMetering: true

cloudAuditLogging

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

cloudAuditLogging.projectID

Diperlukan untuk Cloud Audit Logs
Immutable
String

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

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

Contoh:

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

cloudAuditLogging.clusterLocation

Diperlukan untuk Cloud Audit Logs
Immutable
String

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

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

Contoh:

cloudAuditLogging:
  clusterLocation: "us-central1"

cloudAuditLogging.serviceAccountKeyPath

Diperlukan untuk Cloud Audit Logs
Dapat diubah
String

Jalur file kunci JSON untuk akun layanan logging audit Anda.

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

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

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

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

Contoh:

cloudAuditLogging:
  serviceAccountKey:
    secretRef:
      version: "1"

autoRepair.enabled

Opsional
Dapat diubah
Boolean
Diisi otomatis: true

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

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

secretsEncryption.mode

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

Mode enkripsi Secret.

secretsEncryption:
  mode: "GeneratedKey"

secretsEncryption.generatedKey.keyVersion

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

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

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

Dapat diubah
Boolean
Diisi otomatis: false

Tetapkan ini ke true untuk menonaktifkan enkripsi Secrets. Jika tidak, 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