‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

קובץ תצורה של אשכול משתמש בגרסה 1.30 ואילך

קובץ התצורה של אשכול המשתמש מאפשר להגדיר מפרטים והגדרות לאשכולות משתמשים בתוכנת Distributed Cloud ל-VMware בלבד. אתם יכולים ליצור תבנית לקובץ, ואז לבדוק את שדות החובה, ערכי ברירת המחדל ושדות אחרים שזמינים בגרסאות 1.30 ואילך.

יצירת תבנית לקובץ התצורה

אם השתמשתם ב-gkeadm כדי ליצור את תחנת העבודה של האדמין, gkeadm יצר תבנית לקובץ התצורה של אשכול המשתמשים. בנוסף, gkeadm מילא בשבילך חלק מהשדות.

אם לא השתמשתם ב-gkeadm כדי ליצור את תחנת העבודה של האדמין, אתם יכולים להשתמש ב-gkectl כדי ליצור תבנית לקובץ התצורה של אשכול המשתמשים.

כדי ליצור תבנית לקובץ התצורה של אשכול המשתמש:

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

מחליפים את מה שכתוב בשדות הבאים:

‫OUTPUT_FILENAME: נתיב לבחירתכם לתבנית שנוצרה. אם לא משתמשים בדגל הזה, gkectl נותן לקובץ את השם user-cluster.yaml וממקם אותו בספרייה הנוכחית.

‫VERSION: מספר הגרסה של Google Distributed Cloud. לדוגמה: gkectl create-config cluster --gke-on-prem-version=1.36.200-gke.118.

תבנית

כדי לראות את התבנית שנוצרה לגרסה 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

שדות חובה וערכי ברירת מחדל

אם שדה מסומן כחובה, צריך למלא ערך בשדה בקובץ התצורה.

חלק מהשדות נדרשים בתנאים מסוימים. לדוגמה, צריך להזין את loadBalancer.metalLB.addressPools אם הערך של loadBalancer.kind הוא MetalLB.

אם בשדה מסוים מופיע ערך ברירת מחדל, האשכול ישתמש בערך הזה אם לא תזינו שום דבר בשדה. כדי לשנות את ערך ברירת המחדל, פשוט מזינים ערך אחר.

אם שדה לא מסומן כחובה, הוא אופציונלי. אתם יכולים למלא אותו אם הוא רלוונטי לכם, אבל אתם לא חייבים למלא אותו.

מילוי קובץ התצורה

בקובץ התצורה, מזינים את ערכי השדות כמו שמתואר בקטעים הבאים.

`enableAdvancedCluster`

‫1.33 ומעלה

כל האשכולות החדשים נוצרים כאשכולות מתקדמים. אם אתם כוללים את השדה הזה בקובץ התצורה כשאתם יוצרים אשכול חדש, צריך להגדיר אותו ל-true. אם מגדירים את השדה הזה לערך false, יצירת האשכול תיחסם.

1.32

אופציונלי
ניתן לשינוי (מ-false ל-true)
בוליאני
מאוכלס מראש: true
ברירת מחדל: true

אם לא רוצים להפעיל אשכול מתקדם כשיוצרים אשכול חדש, מגדירים את enableAdvancedCluster ל-false. כשהדגל הזה מוגדר ל-true (אשכול מתקדם מופעל), תוכנת Google Distributed Cloud הבסיסית פורסת בקרים שמאפשרים ארכיטקטורה שניתנת להרחבה. כשמפעילים את התכונה "אשכול מתקדם", מקבלים גישה לתכונות וליכולות חדשות, כמו דומיינים של טופולוגיה. הערך בשדה הזה צריך להיות זהה לערך בשדה enableAdvancedCluster של אשכול האדמין.

לפני שמפעילים אשכול מתקדם, חשוב לקרוא את המאמר ההבדלים בהפעלת אשכולות מתקדמים.

כדי לעדכן אשכול קיים לאשכול מתקדם, קראו את המאמר עדכון אשכול לאשכול מתקדם. אחרי שמעדכנים לאשכול מתקדם, אי אפשר להשבית אותו.

1.31

זמין רק לאשכולות חדשים
תצוגה מקדימה
אופציונלי
לא ניתן לשינוי
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

כדי להפעיל את האשכול המתקדם כשיוצרים אשכול חדש, מגדירים את enableAdvancedCluster ל-true. כשהדגל הזה מוגדר לערך true (הפעלת אשכול מתקדם), תוכנת Google Distributed Cloud הבסיסית פורסת בקרים שמאפשרים ארכיטקטורה עם יותר אפשרויות הרחבה. כשמפעילים את התכונה "אשכול מתקדם", מקבלים גישה לתכונות וליכולות חדשות, כמו דומיינים של טופולוגיה. הערך בשדה הזה צריך להיות זהה לערך בשדה enableAdvancedCluster של אשכול האדמין.

‫1.30 ומטה

לא זמין.

`name`

חובה
מחרוזת

שם לבחירתכם לאשכול המשתמשים. השם צריך:

לכלול עד 40 תווים
להכיל רק תווים אלפאנומריים באותיות קטנות או מקף (-)
להתחיל באות
להסתיים בתו אלפאנומרי

דוגמה:

name: "my-user-cluster"

`gkeOnPremVersion`

חובה
ניתן לשינוי
מחרוזת

גרסת Google Distributed Cloud של אשכול המשתמשים.

דוגמה:

gkeOnPremVersion: "1.29.0-gke.1456"

`preparedSecrets.namespace`

אם השדה infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, צריך להסיר אותו. אם אתם רוצים להשתמש בפרטי כניסה מוכנים, מלאו את השדה הזה.

לא ניתנת לשינוי
מחרוזת
ערכים אפשריים: מחרוזת שמתחילה ב-"gke-onprem-secrets-‎"

השם של מרחב השמות של Kubernetes באשכול האדמין שבו מאוחסנים הסודות המוכנים לאשכול המשתמש הזה.

דוגמה:

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

`enableControlplaneV2`

‫1.30 ומעלה

ניתן לשינוי (מותר לשנות מ-false ל-true)
בוליאני
מאוכלס מראש: true
ברירת מחדל: true

בגרסה 1.30 ואילך, נדרש Controlplane V2 לאשכולות משתמשים חדשים. אם כוללים את השדה הזה בקובץ התצורה, צריך להגדיר אותו לערך true.

כדי להעביר אשכול קיים ל-Controlplane V2, קראו את המאמר העברת אשכול משתמש לתכונות מומלצות. אחרי המעבר ל-Controlplane V2, אי אפשר להשבית את Controlplane V2.

ב-Controlplane V2, מישור הבקרה של אשכול משתמש פועל בצומת אחד או יותר באשכול המשתמש עצמו. היתרונות של Controlplane V2 כוללים:

עקביות ארכיטקטונית בין אשכולות של אדמינים ושל משתמשים.
בידוד תקלות. כשל באשכול אדמין לא משפיע על אשכולות משתמשים.
הפרדה תפעולית. שדרוג של אשכול אדמין לא גורם להשבתה של אשכולות משתמשים.
הפרדת פריסה. אתם יכולים להציב את אשכולות האדמין ואשכולות המשתמשים בדומיינים שונים של כשל או באתרים גיאוגרפיים שונים. לדוגמה, אשכול משתמשים במיקום קצה יכול להיות באתר גיאוגרפי שונה מאשכול הניהול.

‫1.29 ומטה

לא ניתן לשינוי
בוליאני
מאוכלס מראש: true
ברירת מחדל: true

כדי להפעיל את Controlplane V2, מגדירים את enableControlplaneV2 ל-true או מסירים את ההגדרה מקובץ התצורה של אשכול המשתמשים. אחרת, מגדירים אותו לערך false. ב-Controlplane V2, מישור הבקרה של אשכול משתמש פועל בצומת אחד או יותר באשכול המשתמש עצמו. כש-Controlplane V2 לא מופעל, מישור הבקרה של אשכול המשתמש פועל באשכול האדמין.

מומלץ להפעיל את Controlplane V2.

דוגמה:

enableControlplaneV2: true

`vCenter`

הקטע הזה מכיל מידע על סביבת vSphere ועל החיבור ל-vCenter Server.

אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, צריך להסיר את כל הקטע הזה.

אם כללתם את הקטע vCenter בקובץ התצורה של אשכול האדמין:

אם רוצים ששדה בקטע הזה יהיה זהה למה שציינתם באשכול האדמין, צריך להסיר את השדה או להשאיר אותו מסומן כהערה.
אם רוצים ששדה מסוים יהיה שונה ממה שצוין באשכול האדמין, צריך למלא אותו כאן. כל השדות שתמלאו כאן בקטע vCenter יחליפו את השדות התואמים בקובץ התצורה של אשכול האדמין.

`vCenter.address`

לא ניתן לשינוי
מחרוזת
ברירת מחדל: ירושה מאשכול האדמין

כתובת ה-IP או שם המארח של המכונה של שרת vCenter שבה רוצים להשתמש באשכול המשתמש הזה.

מידע נוסף זמין במאמר איתור הכתובת של שרת vCenter.

אם מציינים ערך שונה מהמופע של שרת vCenter שמשמש את אשכול האדמין, צריך להפעיל את Controlplane V2 ולספק ערכים ל-network.vCenter.networkName ולכל השדות הנדרשים בקטע vCenter.

דוגמאות:

vCenter:
  address: "203.0.113.101"

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

`vCenter.datacenter`

לא ניתן לשינוי
מחרוזת
ברירת מחדל: ירושה מאשכול האדמין

הנתיב היחסי של מרכז נתונים של vSphere.

אם מציינים ערך בשדה הזה, צריך לציין גם:

vCenter.networkName
‫vCenter.datastore או vCenter.storagePolicyName
‫vCenter.cluster או vCenter.resourcePool

הערך שמציינים הוא יחסי לתיקיית הבסיס שנקראת /.

אם מרכז הנתונים נמצא בתיקיית הבסיס, הערך הוא השם של מרכז הנתונים.

דוגמה:

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

אחרת, הערך הוא נתיב יחסי שכולל תיקייה אחת או יותר, יחד עם שם מרכז הנתונים.

דוגמה:

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

`vCenter.cluster`

לא ניתן לשינוי
מחרוזת
ברירת מחדל: ירושה מאשכול האדמין

הנתיב היחסי של אשכול vSphere שמייצג את מארחי ה-ESXi שבהם יפעלו המכונות הווירטואליות של אשכול המשתמשים. אשכול ה-vSphere הזה מייצג קבוצת משנה של מארחי ה-ESXi הפיזיים במרכז הנתונים של vCenter.

אם מציינים ערך בשדה הזה, צריך לציין גם:

vCenter.networkName
vCenter.datacenter
‫vCenter.datastore או vCenter.storagePolicyName

הערך שאתם מציינים הוא ביחס ל-/.../DATA_CENTER/vm/.

אם אשכול ה-vSphere נמצא בתיקייה /.../DATA_CENTER/vm/, הערך הוא השם של אשכול ה-vSphere

דוגמה:

vCenter:
  cluster: "my-uc-vsphere-cluster"

אחרת, הערך הוא נתיב יחסי שכולל תיקייה אחת או יותר, יחד עם השם של אשכול ה-vSphere.

דוגמה:

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

`vCenter.resourcePool`

לא ניתן לשינוי
מחרוזת
ברירת מחדל: ירושה מאשכול האדמין

מאגר משאבים של vCenter למכונות הווירטואליות של אשכול המשתמשים.

כדי להשתמש במאגר המשאבים שמוגדר כברירת מחדל, מגדירים את הערך VSPHERE_CLUSTER/Resources.

דוגמה:

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

הערך שאתם מציינים הוא ביחס ל-/.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/

אם מאגר המשאבים הוא צאצא ישיר של /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/, הערך הוא השם של מאגר המשאבים.

דוגמה:

vCenter:
  resourcePool: "my-uc-resource-pool"

אחרת, הערך הוא נתיב יחסי שיש בו שני מאגרי משאבים או יותר.

דוגמה:

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

`vCenter.datastore`

אופציונלי
לא ניתן לשינוי
מחרוזת
ברירת מחדל: ירושה מאשכול האדמין

השם של מאגר נתונים של vSphere לאשכול המשתמשים.

הערך שאתם מציינים חייב להיות שם, לא נתיב. אל תכללו תיקיות בערך.

דוגמה:

vCenter:
  datastore: "my-datastore"

אם מציינים ערך בשדה הזה, לא מציינים ערך בשדה vCenter.storagePolicyName. השדה vCenter.datastore לא ניתן לשינוי, אלא אם מגדירים אותו כמחרוזת ריקה כשמעבירים מאגר נתונים לניהול מבוסס-מדיניות של אחסון (SPBM).

`vCenter.storagePolicyName`

אופציונלי
לא ניתן לשינוי
מחרוזת

השם של מדיניות האחסון של המכונה הווירטואלית לצומתי האשכול.

אפשר גם לציין מדיניות אחסון של מכונות וירטואליות לצמתים במאגר צמתים מסוים. אבל המדיניות שצוינה כאן חלה על כל מאגר צמתים שאין לו מדיניות משלו.

מידע נוסף זמין במאמר הגדרת מדיניות אחסון.

אם מציינים ערך בשדה הזה, לא מציינים ערך בשדה vCenter.datastore.

`vCenter.caCertPath`

ניתן לשינוי
מחרוזת
ברירת מחדל: עובר בירושה מאשכול האדמין

הנתיב של אישור ה-CA לשרת vCenter. מידע נוסף זמין במאמר קבלת אישור CA של vCenter.

דוגמה:

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

במאמר עדכון הפניות לאישורים של vCenter מוסבר איך לעדכן את השדה הזה.

`vCenter.credentials.fileRef.path`

ניתן לשינוי
מחרוזת
ברירת מחדל: עובר בירושה מאשכול האדמין

אם אתם מספקים ערך ל-preparedSecrets.namespace, אל תספקו ערך לשדה הזה. במקום זאת, צריך לספק ערך ל-vCenter.credentials.secretRef.version.

הנתיב של קובץ תצורה של פרטי כניסה שמכיל את שם המשתמש והסיסמה של חשבון המשתמש ב-vCenter. לחשבון המשתמש צריך להיות תפקיד אדמין או הרשאות מקבילות. לדרישות של vSphere

אפשר להשתמש ב-gkectl update credentials כדי לעדכן את השדה הזה באשכול קיים. מידע נוסף מופיע במאמר רוטציית מפתחות של חשבונות שירות.

למידע נוסף על עדכון פרטי הכניסה ל-vCenter, ראו עדכון פרטי הכניסה לאשכול.

דוגמה:

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

`vCenter.credentials.fileRef.entry`

ניתן לשינוי
מחרוזת
ברירת מחדל: עובר בירושה מאשכול האדמין

השם של בלוק פרטי הכניסה בקובץ התצורה של פרטי הכניסה, שמכיל את שם המשתמש והסיסמה של חשבון המשתמש ב-vCenter.

דוגמה:

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

`vCenter.credentials.secretRef.version`

מחרוזת
ערכים אפשריים: מחרוזת של מספר שלם או "latest"
ערך ברירת המחדל: "latest"

אם מציינים ערך בשדה preparedSecrets.namespace, צריך למלא את השדה הזה. אחרת, הסירו את השדה הזה או השאירו אותו מסומן כהערה.

גרסת הסוד המוכן באשכול האדמין, שמכיל את שם המשתמש והסיסמה של המכונה של שרת vCenter שבה אתם מתכוונים להשתמש באשכול המשתמש הזה.

דוגמה:

vCenter:
  credentials:
    secretRef:
      version: "1"

`vCenter.folder`

לא ניתן לשינוי
מחרוזת
ברירת מחדל: ירושה מאשכול האדמין

הנתיב היחסי של תיקיית vSphere שכבר יצרתם. התיקייה הזו תכיל את המכונות הווירטואליות של אשכול המשתמשים.

אם לא תציינו ערך, המכונות הווירטואליות של אשכול המשתמשים ימוקמו ב-/.../DATA_CENTER/vm/.

אם מציינים ערך, הוא יחסי ל-/.../DATA_CENTER/vm/.

הערך יכול להיות שם של תיקייה.

דוגמה:

vCenter:
  folder: "my-uc-folder"

הערך יכול להיות גם נתיב יחסי שכולל יותר מתיקייה אחת.

דוגמה:

vCenter:
  folder: "folders/folder-2"

`componentAccessServiceAccountKeyPath`

ניתן לשינוי
מחרוזת
ברירת מחדל: עובר בירושה מאשכול האדמין

הנתיב של קובץ המפתח בפורמט JSON של חשבון השירות עם גישה לרכיבים.

דוגמה:

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

`componentAccessServiceAccountKey.secretRef.version`

ניתן לשינוי
מחרוזת
ערכים אפשריים: מחרוזת של מספר שלם או "latest"
ערך ברירת המחדל: "latest"

גרסת הסוד המוכן באשכול האדמין, שמכיל מפתח JSON לחשבון השירות שלכם עם גישה לרכיבים.

דוגמה:

componentAccessServiceAccountKey:
  secretRef:
    version: "1"

`privateRegistry`

מלאו את הקטע הזה אם אשכול האדמין משתמש בContainer Registry פרטי, ואתם רוצים שאשכול המשתמש ישתמש ב-Container Registry פרטי אחר או בהגדרות אחרות. אם אתם רוצים להשתמש בכתובת אחרת של מאגר פרטי, צריך להפעיל באשכול את Controlplane V2. ההגדרות החדשות נבחרות במהלך היצירה והעדכון של האשכול.

אם רוצים להשתמש באותן הגדרות כמו באשכול האדמין, צריך להסיר את הקטע הזה או להשאיר אותו מסומן כהערה. אם משאירים את הקטע הזה ריק, קובצי האימג' של המערכת מוגדרים כברירת מחדל ל-gcr.io/gke-on-prem-release.

`privateRegistry.address`

לא ניתן לשינוי
מחרוזת
ברירת מחדל: ירושה מאשכול האדמין

כתובת ה-IP או ה-FQDN (שם דומיין שמוגדר במלואו) של המכונה שבה פועל מאגר Docker הפרטי.

דוגמאות:

privateRegistry:
  address: "203.0.113.10"

privateRegistry:
  address: "fqdn.example.com"

`privateRegistry.credentials.fileRef.path`

ניתן לשינוי
מחרוזת
ברירת מחדל: עובר בירושה מאשכול האדמין

אם אתם מתכננים להשתמש בסוד מוכן בשביל המרשם הפרטי, אל תזינו ערך בשדה הזה. במקום זאת, צריך לספק ערך ל-privateRegistry.credentials.secretRef.version.

הנתיב של קובץ תצורה של פרטי כניסה שמכיל את שם המשתמש והסיסמה של חשבון ש-Google Distributed Cloud יכול להשתמש בו כדי לגשת למאגר הפרטי של Docker.

דוגמה:

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

`privateRegistry.credentials.fileRef.entry`

ניתן לשינוי
מחרוזת
ברירת מחדל: עובר בירושה מאשכול האדמין

השם של בלוק פרטי הכניסה בקובץ התצורה של פרטי הכניסה, שמכיל את שם המשתמש והסיסמה של החשבון הפרטי שלכם במאגר Docker.

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

`privateRegistry.credentials.secretRef.version`

מחרוזת
ערכים אפשריים: מחרוזת של מספר שלם או "latest"
ערך ברירת המחדל: "latest"

אם אתם מספקים ערך ל-preparedSecrets.namespace ורוצים להשתמש בסוד מוכן למרשם פרטי, מלאו את השדה הזה. אחרת, צריך להסיר את השדה הזה או להשאיר אותו מסומן כהערה.

דוגמה:

privateRegistry:
  credentials:
    secretRef:
      version: "1"

`privateRegistry.caCertPath`

ניתן לשינוי
מחרוזת
ברירת מחדל: עובר בירושה מאשכול האדמין

כש-Docker שולף קובץ אימג' מהמרשם הפרטי, המרשם צריך להוכיח את הזהות שלו באמצעות הצגת אישור. האישור של המרשם נחתם על ידי רשות אישורים (CA). ‫Docker משתמש באישור של רשות האישורים כדי לאמת את האישור של המרשם.

מגדירים בשדה הזה את הנתיב לאישור של רשות האישורים.

דוגמה:

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

`network`

הקטע הזה מכיל מידע על רשת אשכולות המשתמשים.

`network.hostConfig`

‫1.30 ומעלה

בקטע הזה מופיע מידע על שרתי NTP, שרתי DNS ודומיינים לחיפוש DNS שמשמשים את המכונות הווירטואליות שהן הצמתים באשכול.

אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין (זמין בגרסה 1.31 ואילך), צריך להסיר את כל הקטע הזה. אחרת, חובה למלא את הקטע הזה אם מתקיים אחד או יותר מהתנאים הבאים:

הערך של network.ipMode.type הוא static.
הערך של enableControlplaneV2 מוגדר כ-true או מוגדר כברירת מחדל ל-true. שימו לב שצריך את Controlplane V2 לאשכולות משתמשים חדשים.

‫1.29 ומטה

בקטע הזה מופיע מידע על שרתי NTP, שרתי DNS ודומיינים לחיפוש DNS שמשמשים את המכונות הווירטואליות שהן הצמתים באשכול. אם אתם משתמשים במאזן העומסים Seesaw, המידע הזה רלוונטי גם למכונות הווירטואליות של Seesaw.

צריך למלא את הקטע הזה אם מתקיים אחד או יותר מהתנאים הבאים:

הערך של network.ipMode.type הוא static.
הערך של enableControlplaneV2 מוגדר כ-true או מוגדר כברירת מחדל ל-true. איזון העומסים של Seesaw לא נתמך באשכולות שבהם מופעל Controlplane V2.
הערך של loadBalancer.kind הוא "Seesaw".

`network.hostConfig.dnsServers`

חובה
לא ניתן לשינוי
מערך של מחרוזות.
מספר הרכיבים המקסימלי במערך הוא שלושה.

הכתובות של שרתי ה-DNS של המכונות הווירטואליות.

דוגמה:

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

`network.hostConfig.ntpServers`

חובה
לא ניתן לשינוי
מערך של מחרוזות

הכתובות של שרתי הזמן שבהם המכונות הווירטואליות ישתמשו.

דוגמה:

network:
  hostConfig:
    ntpServers:
    - "216.239.35.0"

`network.hostConfig.searchDomainsForDNS`

לא ניתן לשינוי
מערך של מחרוזות

דומיינים לחיפוש DNS שהמארחים ישתמשו בהם. הדומיינים האלה משמשים כחלק מרשימת חיפוש של דומיינים.

דוגמה:

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

`network.ipMode.type`

לא ניתנת לשינוי
מחרוזת
מאוכלסת מראש: "static"
ברירת מחדל: "dhcp"

אם רוצים שצומתי האשכול יקבלו את כתובת ה-IP שלהם משרת DHCP, צריך להגדיר את הערך "dhcp". אם רוצים שלצומתי האשכול יהיו כתובות IP סטטיות שנבחרו מרשימה שסיפקתם, צריך להגדיר את הערך "static". אם enableControlplaneV2 מוגדר ל-true, ההגדרה הזו חלה רק על צומתי עובדים.

דוגמה:

network:
  ipMode:
    type: "static"

`network.ipMode.ipBlockFilePath`

השדה הזה נדרש אם network.ipMode.type = static או אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין.

לא ניתן לשינוי
מחרוזת

הנתיב המוחלט או הנתיב היחסי של קובץ בלוק ה-IP של האשכול.

דוגמה:

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

`network.serviceCIDR`

Immutable
String
Prepopulated: "10.96.0.0/20"
>

טווח של כתובות IP בפורמט CIDR, שישמשו לשירותים באשכול. הטווח חייב להיות לפחות ‎ /24.

דוגמה:

network:
  serviceCIDR: "10.96.0.0/20"

`network.podCIDR`

לא ניתן לשינוי
מחרוזת
מאוכלס מראש: "192.168.0.0/16"
ברירת מחדל: "192.168.0.0/16"

טווח של כתובות IP בפורמט CIDR, שישמשו לפודים באשכול. הטווח חייב להיות לפחות ‎ /18.

דוגמה:

network:
  podCIDR: "192.168.0.0/16"

טווח השירות לא יכול לחפוף לטווח ה-Pod.

טווחי הכתובות של השירותים וה-Pods לא יכולים לחפוף לכתובות מחוץ לאשכול שאתם רוצים להגיע אליהן מתוך האשכול.

לדוגמה, נניח שטווח השירות הוא 10.96.232.0/24 וטווח ה-Pod הוא 192.168.0.0/16. כל תעבורת נתונים שנשלחת מ-Pod לכתובת באחד מהטווחים האלה תטופל כתעבורת נתונים בתוך האשכול, ולא תגיע ליעד מחוץ לאשכול.

באופן ספציפי, טווחי הכתובות של השירותים וה-Pods לא יכולים לחפוף ל:

כתובות IP של צמתים בכל אשכול
כתובות IP שמשמשות מכונות של מאזני עומסים
כתובות VIP שמשמשות את הצמתים של מישור הבקרה ומאזני העומסים
כתובת ה-IP של שרתי vCenter, שרתי DNS ושרתי NTP

מומלץ שהטווחים של השירותים וה-Pods יהיו במרחב הכתובות RFC 1918.

זו אחת מהסיבות להמלצה להשתמש בכתובות RFC 1918. נניח שטווח ה-Pod או השירות מכיל כתובות IP חיצוניות. כל תנועה שנשלחת מ-Pod לאחת מהכתובות החיצוניות האלה תטופל כתנועה בתוך האשכול ולא תגיע ליעד החיצוני.

`network.vCenter.networkName`

אם השדה infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, צריך להסיר אותו. אחרת, השדה הזה נדרש אם vCenter.address שונה מכתובת ה-vCenter שבה אתם משתמשים לאשכול האדמין.

לא ניתן לשינוי
מחרוזת

שם הרשת של vSphere לצומתי אשכול המשתמשים.

דוגמה:

network:
  vCenter:
    networkName: "my-network"

אם השם מכיל תו מיוחד, צריך להשתמש ברצף תווי בריחה (escape sequence).

תווים מיוחדים	רצף בריחה (escape sequence)
לוכסן (`/`)	`%2f`
לוכסן הפוך (`\`)	`%5c`
סימן אחוז (`%`)	`%25`

אם שם הרשת לא ייחודי במרכז הנתונים, אפשר לציין נתיב מלא.

דוגמה:

network:
  vCenter:
    networkName: "/my-uc-datacenter/network/my-network"

`network.additionalNodeInterfaces`

אם הגדרתם את multipleNetworkInterfaces בתור true, אתם צריכים למלא את הקטע הזה. אחרת, צריך להסיר את הקטע הזה או להשאיר אותו מסומן כהערה.

לא ניתן לשינוי

מערך של אובייקטים, שכל אחד מהם מתאר ממשק רשת שאפשר להשתמש בו בכל הצמתים באשכול או בחלק מהם.

`network.additionalNodeInterfaces[i].networkName`

חובה אם multipleNetworkInterfaces = true
לא ניתן לשינוי
מחרוזת

שם הרשת של vSphere שאליה יתחבר ממשק הצומת הנוסף.

דוגמה:

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

`network.additionalNodeInterfaces[i].type`

חובה אם multipleNetworkInterfaces = true
לא ניתן לשינוי
מחרוזת

דוגמה:

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

`network.additionalNodeInterfaces[i].ipBlockFilePath`

חובה אם network.additionalNodeInterfaces[i].type = static
לא ניתן לשינוי
מחרוזת

הנתיב של קובץ בלוק IP שמכיל כתובות IP לשימוש בממשק הרשת הזה בצמתים שיש להם את ממשק הרשת הזה.

דוגמה:

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

`network.controlPlaneIPBlock`

אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, צריך להסיר את כל הקטע הזה.

אחרת, הכללת הקטע הזה תלויה בערך שהגדרתם ב-enableControlplaneV2:

אם enableControlplaneV2 הוא true, צריך למלא את הקטע הזה.
אם enableControlplaneV2 הוא false, צריך להסיר את הקטע הזה.

`network.controlPlaneIPBlock.netmask`

חובה אם enableControlplaneV2 = true
לא ניתן לשינוי
מחרוזת

דוגמה:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

`network.controlPlaneIPBlock.gateway`

חובה אם enableControlplaneV2 = true
לא ניתן לשינוי
מחרוזת

דוגמה:

network:
  controlPlaneIPBlock:
    gateway: "172.16.21.1"

`network.controlPlaneIPBlock.ips`

חובה אם enableControlplaneV2 = true
לא ניתן לשינוי
מערך של אובייקטים, שלכל אחד מהם יש כתובת IP ושם מארח. צריך לציין את שם המארח כשמעבירים מ-Controlplane V1 ל-Controlplane V2. אחרת, הוא אופציונלי. שמות המארחים חייבים להיות ייחודיים ב-vCenter.

באשכול משתמשים בזמינות גבוהה (HA), המערך כולל שלושה רכיבים. באשכול משתמשים שאינו HA, המערך מכיל רכיב אחד.

דוגמה:

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`

בקטע הזה מופיע מידע על מאזן העומסים של אשכול המשתמשים.

`loadBalancer.vips.controlPlaneVIP`

חובה
לא ניתן לשינוי
מחרוזת

כתובת ה-IP שבחרתם להגדיר במאזן העומסים לשרת ה-API של Kubernetes באשכול המשתמש.

דוגמה:

loadBalancer:
  vips:
    controlplaneVIP: "203.0.113.3"

`loadBalancer.vips.ingressVIP`

חובה אם disableBundledIngress = false
לא ניתן לשינוי
מחרוזת

כתובת ה-IP שבחרתם להגדיר במאזן העומסים בשביל שרת ה-proxy של Ingress.

דוגמה:

loadBalancer:
  vips:
    ingressVIP: "203.0.113.4"

`loadBalancer.kind`

מציינים את סוג מאזן העומסים שבו רוצים להשתמש.

‫1.32 ומעלה

חובה
לא ניתנת לשינוי
מחרוזת
מאוכלסת מראש: "MetalLB"

סוג מאזן העומסים שבו תוכלו להשתמש תלוי בשאלה אם תגדירו את האשכול לשימוש בדומיינים של טופולוגיה. אם השדה infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, ההנחה היא שאשכול האדמין משתמש בדומיינים של טופולוגיה.

עם דומיינים של טופולוגיה: מגדירים את הערך "ManualLB". אם אתם רוצים להשתמש בדומיינים של טופולוגיה, אתם צריכים להגדיר מאזן עומסים של צד שלישי (כמו F5 BIG-IP או Citrix).
בלי דומיינים של טופולוגיה: מגדירים את הערך "ManualLB" או "MetalLB". אם יש לכם מאזן עומסים של צד שלישי, השתמשו ב-"ManualLB", ואם אתם משתמשים בפתרון המשולב שלנו, השתמשו ב-"MetalLB". אפשר גם להגדיר סוג אחר של מאזן עומסים לתעבורת הנתונים במישור הבקרה. מידע נוסף זמין במאמר masterNode.controlPlaneLoadBalancer.

1.31

חובה
לא ניתנת לשינוי
מחרוזת
מאוכלסת מראש: "MetalLB"

עם דומיינים של טופולוגיה: מגדירים את הערך "ManualLB". כדי להשתמש בדומיינים של טופולוגיה, צריך להגדיר מאזן עומסים של צד שלישי (כמו F5 BIG-IP או Citrix).
בלי דומיינים של טופולוגיה: מגדירים את הערך "ManualLB" או "MetalLB". אם יש לכם מאזן עומסים של צד שלישי, השתמשו ב-"ManualLB", ואם אתם משתמשים בפתרון המשולב שלנו, השתמשו ב-"MetalLB".

1.30

חובה
לא ניתנת לשינוי
מחרוזת
מאוכלסת מראש: "MetalLB"

מגדירים את הערך "ManualLB" או "MetalLB". אם יש לכם מאזן עומסים של צד שלישי (כמו F5 BIG-IP או Citrix), השתמשו ב-"ManualLB", או ב-"MetalLB" בשביל הפתרון המשולב שלנו.

אפשר לשדרג אשכול שבו kind מוגדר ל-"F5BigIP" או ל-"Seesaw", אבל אי אפשר ליצור אשכולות חדשים. מידע על העברת הגדרות של איזון עומסים זמין במאמר תכנון העברת אשכולות לתכונות מומלצות.

דוגמה:

loadBalancer:
  kind: "MetalLB"

‫1.29 וגרסאות קודמות

חובה
לא ניתנת לשינוי
מחרוזת
מאוכלסת מראש: "MetalLB"

צריך להגדיר את הערך "ManualLB", ‏"F5BigIP", ‏"Seesaw" או "MetalLB".

כדי להפעיל את Dataplane V2 ואת Controlplane V2, מומלץ להשתמש ב-"ManualLB" אם יש לכם מאזן עומסים של צד שלישי (כמו F5 BIG-IP או Citrix) או ב-"MetalLB" בשביל הפתרון המשולב שלנו.

דוגמה:

loadBalancer:
  kind: "MetalLB"

כשיוצרים אשכולות של משתמשים באמצעות מסוף Google Cloud , ה-CLI של gcloud או Terraform, סוג מאזן העומסים של אשכול האדמין ושל אשכולות המשתמשים שלו חייב להיות זהה. החריג היחיד הוא אם אשכול האדמין משתמש ב-Seesaw, ואז אשכולות המשתמשים יכולים להשתמש ב-MetalLB. אם אתם רוצים שאשכולות המשתמשים והאדמינים ישתמשו בסוגים שונים של מאזני עומסים, אתם צריכים ליצור אשכולות משתמשים באמצעות כלי שורת הפקודה gkectl.

`loadBalancer.manualLB`

אם הגדרתם את loadbalancer.kind בתור "manualLB", אתם צריכים למלא את הקטע הזה. אחרת, הסירו את הקטע הזה או השאירו אותו מסומן כהערה.

`loadBalancer.manualLB.ingressHTTPNodePort`

חובה אם loadBalancer.kind = ManualLB (ראו הערה לגבי הגרסה)
לא ניתן לשינוי
מספר שלם
מאוכלס מראש: 30243

שרת ה-proxy של ה-ingress באשכול משתמש נחשף על ידי שירות Kubernetes מסוג LoadBalancer. לשירות יש ServicePort ל-HTTP. בוחרים ערך nodePort ל-HTTP ServicePort ומגדירים את השדה הזה לערך nodePort.

הערה לגבי הגרסה: בגרסה 1.30 ואילך, יציאות של צומתי כניסה הן אופציונליות לאשכולות שמשתמשים ב-Controlplane V2.

דוגמה:

loadBalancer:
  manualLB:
    ingressHTTPNodePort: 32527

`loadBalancer.manualLB.ingressHTTPSNodePort`

חובה אם loadBalancer.kind = ManualLB (see Version note)
לא ניתן לשינוי
מספר שלם
מאוכלס מראש: 30879

שרת ה-proxy של ה-ingress באשכול משתמש נחשף על ידי שירות מסוג LoadBalancer. לשירות יש ServicePort ל-HTTPS. בוחרים ערך nodePort ל-HTTPS ServicePort, ומגדירים את השדה הזה לערך nodePort.

הערה לגבי הגרסה: בגרסה 1.30 ואילך, יציאות של צומתי כניסה הן אופציונליות לאשכולות שמשתמשים ב-Controlplane V2.

דוגמה:

loadBalancer:
  manualLB:
    ingressHTTPSNodePort: 30139

`loadBalancer.manualLB.controlPlaneNodePort`

חובה אם loadBalancer.kind = ManualLB וגם enableControlplaneV2 = false
לא ניתן לשינוי
מספר שלם
מאוכלס מראש: 30562

שרת ה-API של Kubernetes באשכול משתמש פועל באשכול האדמין, ונחשף על ידי שירות מסוג LoadBalancer. צריך לבחור ערך בשדה nodePort של השירות.

מגדירים את השדה הזה לערך nodePort.

דוגמה:

loadBalancer:
  manualLB:
    controlPlaneNodePort: 30968

`loadBalancer.manualLB.konnectivityServerNodePort`

חובה אם loadBalancer.kind = ManualLB וגם enableControlplaneV2 = false
לא ניתן לשינוי
מספר שלם
מאוכלס מראש: 30563

שרת ה-API של Kubernetes באשכול משתמש שמשתמש ב-kubeception פועל באשכול האדמין, ונחשף על ידי שירות מסוג LoadBalancer. שרת Konnectivity משתמש מחדש בשירות הזה עם ערך nodePort אחר. צריך לבחור ערך nodePort לשרת Konnectivity.

מגדירים את השדה הזה לערך nodePort של שרת Konnectivity.

דוגמה:

loadBalancer:
  manualLB:
    konnectivityServerNodePort: 30969

`loadBalancer.f5BigIP`

‫1.30 ומעלה

בגרסה 1.30 ואילך, הערך "F5BigIP" לא מותר ל-loadbalancer.kind באשכולות משתמשים חדשים. אם הקטע loadBalancer.f5BigIP מופיע בקובץ התצורה, צריך להסיר אותו או להפוך אותו להערה.

אתם עדיין יכולים להשתמש במאזן העומסים F5 BIG-IP עם אשכולות משתמשים חדשים, אבל ההגדרה שונה. לפרטים על ההגדרה, קראו את המאמר הפעלת מצב איזון עומסים ידני.

אם הקטע הזה מוגדר באשכול קיים, אי אפשר לשדרג לגרסה 1.32. לפני שמשדרגים לגרסה 1.32, צריך להעביר את האשכולות לתכונות המומלצות.

‫1.29 ומטה

אם הגדרתם את loadbalancer.kind בתור "F5BigIP", אתם צריכים למלא את הקטע הזה. אחרת, הסירו את הקטע הזה או השאירו אותו מסומן כהערה.

כדי להפעיל תכונות חדשות ומתקדמות, מומלץ להגדיר איזון עומסים ידני למאזן העומסים F5 BIG-IP. כדי להפעיל איזון עומסים ידני, מגדירים את loadbalancer.kind לערך "ManualLB" וממלאים את הקטע loadBalancer.manualLB. איך מפעילים את מצב איזון העומסים הידני

אם יש לכם מאזן עומסים קיים מסוג F5-BIG-IP והגדרת האשכול משתמשת בקטע הזה, אחרי השדרוג לגרסה 1.29 ומעלה, מומלץ לעבור לאיזון עומסים ידני.

`loadBalancer.f5BigIP.address`

‫1.30 ומעלה

אסור לאשכולות חדשים
חובה אם loadBalancer.kind = "F5BigIP"
מחרוזת

הכתובת של מאזן העומסים F5 BIG-IP.

דוגמה:

loadBalancer:
  f5BigIP:
      address: "203.0.113.2"

‫1.29 ומטה

חובה אם loadBalancer.kind = "F5BigIP"
מחרוזת

הכתובת של מאזן העומסים F5 BIG-IP.

דוגמה:

loadBalancer:
  f5BigIP:
      address: "203.0.113.2"

`loadBalancer.f5BigIP.credentials.fileRef.path`

‫1.30 ומעלה

אסור לאשכולות חדשים
חובה אם loadBalancer.kind = "F5BigIP"
מחרוזת

הנתיב של קובץ פרטי הכניסה שמכיל את שם המשתמש והסיסמה של חשבון ש-Google Distributed Cloud יכול להשתמש בו כדי להתחבר למאזן העומסים F5 BIG-IP.

לחשבון המשתמש צריך להיות תפקיד משתמש עם הרשאות מספיקות להגדרה ולניהול של מאזן העומסים. מספיק שיהיה לכם תפקיד אדמין או תפקיד אדמין של משאבים.

למידע על עדכון פרטי הכניסה של F5 BIG-IP, ראו עדכון פרטי הכניסה של האשכול.

דוגמה:

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

‫1.29 ומטה

חובה אם loadBalancer.kind = "F5BigIP"
מחרוזת

למידע על עדכון פרטי הכניסה של F5 BIG-IP, ראו עדכון פרטי הכניסה של האשכול.

דוגמה:

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

`loadBalancer.f5BigIP.credentials.fileRef.entry`

‫1.30 ומעלה

אסור לאשכולות חדשים
חובה אם loadBalancer.kind = "F5BigIP"
מחרוזת

השם של בלוק פרטי הכניסה בקובץ התצורה של פרטי הכניסה, שמכיל את שם המשתמש והסיסמה של החשבון ב-F5 BIG-IP.

דוגמה:

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

‫1.29 ומטה

חובה אם loadBalancer.kind = "F5BigIP"
מחרוזת

השם של בלוק פרטי הכניסה בקובץ התצורה של פרטי הכניסה, שמכיל את שם המשתמש והסיסמה של החשבון ב-F5 BIG-IP.

דוגמה:

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

`loadBalancer.f5BigIP.partition`

‫1.30 ומעלה

אסור לאשכולות חדשים
חובה אם loadBalancer.kind = "F5BigIP"
מחרוזת

השם של מחיצת BIG-IP שיצרתם לאשכול המשתמשים.

דוגמה:

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

‫1.29 ומטה

חובה אם loadBalancer.kind = "F5BigIP"
מחרוזת

השם של מחיצת BIG-IP שיצרתם לאשכול המשתמשים.

דוגמה:

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

`loadBalancer.f5BigIP.snatPoolName`

‫1.30 ומעלה

לא מותר לאשכולות חדשים
נדרש אם loadBalancer.kind = "F5BigIP" ואתם משתמשים ב-SNAT
מחרוזת

השם של מאגר ה-SNAT.

דוגמה:

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

‫1.29 ומטה

חובה אם loadBalancer.kind = "F5BigIP" ומשתמשים ב-SNAT
מחרוזת

השם של מאגר ה-SNAT.

דוגמה:

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

`loadBalancer.seesaw`

‫1.30 ומעלה

בגרסה 1.30 ואילך, הערך "Seesaw" לא מותר ל-loadbalancer.kind באשכולות משתמשים חדשים, כי מאזן העומסים הזה לא נתמך בתכונות חדשות ומתקדמות. אם הקטע loadBalancer.seesaw מופיע בקובץ התצורה, צריך להסיר אותו או להפוך אותו להערה.

במקום זאת, אתם יכולים להגדיר את מאזן העומסים המצורף של MetalLB. כדי להפעיל את מאזן העומסים MetalLB, מגדירים את loadbalancer.kind כ-"MetalLB" וממלאים את הקטע loadBalancer.metalLB. מידע נוסף מופיע במאמר איזון עומסים בחבילה עם MetalLB.

‫1.29 ומטה

אם הגדרתם את loadbalancer.kind בתור "Seesaw", אתם צריכים למלא את הקטע הזה. אחרת, הסירו את הקטע הזה או השאירו אותו מסומן כהערה.

שימו לב למגבלות הבאות של מאזן העומסים SeeSaw:

אם אשכול אדמין בזמינות גבוהה מנהל את אשכול המשתמש הזה, אשכול המשתמש לא יכול להשתמש במאזן העומסים Seesaw.
באשכולות משתמשים שבהם מופעל Controlplane V2 אי אפשר להשתמש במאזן העומסים Seesaw.

כדי להשתמש בתכונות האלה, מומלץ להגדיר את מאזן העומסים MetalLB. כדי להפעיל את מאזן העומסים MetalLB, מגדירים את loadbalancer.kind כ-"MetalLB" וממלאים את הקטע loadBalancer.metalLB. מידע נוסף מופיע במאמר איזון עומסים בחבילה עם MetalLB.

`loadBalancer.seesaw.ipBlockFilePath`

‫1.30 ומעלה

אסור באשכולות חדשים
חובה אם loadBalancer.kind = Seesaw
לא ניתן לשינוי
מחרוזת

הנתיב של קובץ בלוק ה-IP למכונות הווירטואליות של Seesaw.

דוגמה:

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

‫1.29 ומטה

חובה אם loadBalancer.kind = Seesaw
לא ניתן לשינוי
מחרוזת

הנתיב של קובץ בלוק ה-IP למכונות הווירטואליות של Seesaw.

דוגמה:

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

`loadBalancer.seesaw.vrid`

‫1.30 ומעלה

לא מותר לאשכולות חדשים
נדרש אם loadBalancer.kind = Seesaw
לא ניתן לשינוי
מספר שלם
ערכים אפשריים: 1 - 255
מאוכלס מראש: 0

המזהה של הנתב הווירטואלי של ה-VM של Seesaw. המזהה הזה, שהוא מספר שלם לבחירתכם, חייב להיות ייחודי ב-VLAN.

דוגמה:

loadBalancer:
  seesaw:
    vrid: 125

‫1.29 ומטה

חובה אם loadBalancer.kind = Seesaw
לא ניתן לשינוי
מספר שלם
ערכים אפשריים: 1 עד 255
מאוכלס מראש: 0

המזהה של הנתב הווירטואלי של ה-VM של Seesaw. המזהה הזה, שהוא מספר שלם לבחירתכם, חייב להיות ייחודי ב-VLAN.

דוגמה:

loadBalancer:
  seesaw:
    vrid: 125

`loadBalancer.seesaw.masterIP`

‫1.30 ומעלה

אסור באשכולות חדשים
חובה אם loadBalancer.kind = Seesaw
לא ניתן לשינוי
מחרוזת

כתובת ה-IP הווירטואלית שמוגדרת ב-Master Seesaw VM.

דוגמה:

loadBalancer:
  seesaw:
    masterIP: 172.16.20.21

‫1.29 ומטה

חובה אם loadBalancer.kind = Seesaw
לא ניתן לשינוי
מחרוזת

כתובת ה-IP הווירטואלית שמוגדרת ב-Master Seesaw VM.

דוגמה:

loadBalancer:
  seesaw:
    masterIP: 172.16.20.21

`loadBalancer.seesaw.cpus`

‫1.30 ומעלה

אסור באשכולות חדשים
חובה אם loadBalancer.kind = Seesaw
ניתן לשינוי
מספר שלם
מאוכלס מראש: 4

מספר המעבדים (CPU) לכל אחת מהמכונות הווירטואליות של Seesaw.

דוגמה:

loadBalancer:
  seesaw:
    cpus: 8

‫1.29 ומטה

חובה אם loadBalancer.kind = Seesaw
ניתן לשינוי
מספר שלם
מאוכלס מראש: 4

מספר המעבדים (CPU) לכל אחת מהמכונות הווירטואליות של Seesaw.

דוגמה:

loadBalancer:
  seesaw:
    cpus: 8

`loadBalancer.seesaw.memoryMB`

‫1.30 ומעלה

אסור באשכולות חדשים
חובה אם loadBalancer.kind = Seesaw
ניתן לשינוי
מספר שלם
מאוכלס מראש: 3072

מספר המגה-בייטים (MiB) של הזיכרון לכל אחת מהמכונות הווירטואליות של Seesaw.

דוגמה:

loadBalancer:
  seesaw:
    memoryMB: 8192

הערה: השדה הזה מציין את מספר המגה-בייטים (MiB) של הזיכרון, ולא את מספר המגה-בייטים (MB). מגה-בייט אחד הוא 2²⁰ = 1,048,576 בייטים. מגה-בייט אחד הוא 10⁶ = 1,000,000 בייטים.

‫1.29 ומטה

חובה אם loadBalancer.kind = Seesaw
ניתן לשינוי
מספר שלם
מאוכלס מראש: 3072

מספר המגה-בייטים (MiB) של הזיכרון לכל אחת מהמכונות הווירטואליות של Seesaw.

דוגמה:

loadBalancer:
  seesaw:
    memoryMB: 8192

`loadBalancer.seesaw.vCenter.networkName`

‫1.30 ומעלה

לא מותר לאשכולות חדשים
לא ניתן לשינוי
מחרוזת
ברירת מחדל: זהה לצומתי האשכול

השם של רשת vCenter שמכילה את המכונות הווירטואליות של Seesaw.

דוגמה:

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

‫1.29 ומטה

לא ניתן לשינוי
מחרוזת
ברירת מחדל: זהה לצומתי האשכול

השם של רשת vCenter שמכילה את המכונות הווירטואליות של Seesaw.

דוגמה:

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

`loadBalancer.seesaw.enableHA`

‫1.30 ומעלה

אסור באשכולות חדשים
לא ניתן לשינוי
רלוונטי אם loadBalancer.kind = Seesaw
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

אם רוצים ליצור מאזן עומסים של Seesaw בזמינות גבוהה (HA), מגדירים את הערך true. אחרת, צריך להגדיר את הערך false. מאזן עומסים מסוג HA Seesaw משתמש בצמד(ראשי, גיבוי) של מכונות וירטואליות.

דוגמה:

loadBalancer:
  seesaw:
    enableHA: true

‫1.29 ומטה

לא ניתן לשינוי
רלוונטי אם loadBalancer.kind = Seesaw
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

דוגמה:

loadBalancer:
  seesaw:
    enableHA: true

`loadBalancer.seesaw.disableVRRPMAC`

‫1.30 ומעלה

לא מותר לאשכולות חדשים
לא ניתן לשינוי
רלוונטי אם loadBalancer.kind = Seesaw
בוליאני
מאוכלס מראש: true
ברירת מחדל: true

אם הערך הוא true (מומלץ), מאזן העומסים של Seesaw לא משתמש בלמידת MAC ליתירות כשל. במקום זאת, הוא משתמש ב-gratuitous ARP. אם השדה הזה מוגדר לערך false, מאזן העומסים של Seesaw משתמש בלמידת MAC. אם אתם משתמשים ב-vSphere 7 ואילך, ויש לכם מאזן עומסים Seesaw בזמינות גבוהה, צריך להגדיר את השדה הזה לערך true.

דוגמה:

loadBalancer:
  seesaw:
    disableVRRPMAC: true

‫1.29 ומטה

לא ניתן לשינוי
רלוונטי אם loadBalancer.kind = Seesaw
בוליאני
מאוכלס מראש: true
ברירת מחדל: true

אם מגדירים את הערך true (מומלץ), מאזן העומסים של Seesaw לא משתמש בלמידת MAC ליתירות כשל. במקום זאת, הוא משתמש ב-gratuitous ARP. אם מגדירים את הערך false, מאזן העומסים של Seesaw משתמש בלמידת MAC. אם אתם משתמשים ב-vSphere 7 ואילך, ויש לכם מאזן עומסים של Seesaw בזמינות גבוהה, צריך להגדיר את השדה הזה לערך true.

דוגמה:

loadBalancer:
  seesaw:
    disableVRRPMAC: true

`loadBalancer.metalLB`

אם הגדרתם את loadbalancer.kind בתור "MetalLB", אתם צריכים למלא את הקטע הזה. אחרת, הסירו את הקטע הזה או השאירו אותו מסומן כהערה.

מידע נוסף מופיע במאמר איזון עומסים בחבילה עם MetalLB.

`loadBalancer.metalLB.addressPools`

חובה אם loadBalancer.kind = MetalLB
ניתן לשינוי (יש חריג)

מערך של אובייקטים, שכל אחד מהם מכיל מידע על מאגר כתובות שמשמש את מאזן העומסים MetalLB.

‫1.32 ומעלה

ההתנהגות של השדה הזה זהה כשמגדירים את enableAdvancedCluster לערך true (אשכול מתקדם מופעל) או לערך false (אשכול מתקדם לא מופעל). בשני המקרים, המערך לא ניתן לשינוי באופן מלא. אפשר להוסיף מאגרי כתובות, אבל אי אפשר להסיר מאגרי כתובות ממערך קיים של מאגרי כתובות.

1.31

ההתנהגות של השדה הזה תלויה בשאלה אם בשדה enableAdvancedCluster מוגדר הערך true (אשכול מתקדם מופעל) או false (אשכול מתקדם לא מופעל):

אם אשכול מתקדם מופעל: המערך לא ניתן לשינוי באופן מלא. אפשר להוסיף מאגרי כתובות, אבל אי אפשר להסיר מאגרי כתובות ממערך קיים של מאגרי כתובות.
אם אשכול מתקדם לא מופעל: המערך ניתן לשינוי. אפשר להוסיף ולהסיר מאגרי כתובות ממערך קיים של מאגרי כתובות.

‫1.30 וגרסאות קודמות

אפשר להוסיף ולהסיר מאגרי כתובות ממערך קיים של מאגרי כתובות.

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

חובה אם loadBalancer.kind = MetalLB
ניתן לשינוי (יש חריג)
מחרוזת

שם לבחירתכם למאגר הכתובות.

‫1.32 ומעלה

ההתנהגות של השדה הזה זהה למצב שבו enableAdvancedCluster מוגדר לערך true (אשכול מתקדם מופעל) או false (אשכול מתקדם לא מופעל). בשני המקרים, אי אפשר לשנות את השם אחרי שיוצרים את האשכול.

1.31

אם הפעלתם את האשכול המתקדם: אי אפשר לשנות את השם אחרי שיוצרים את האשכול.
אם לא הפעלתם את האשכול המתקדם: אתם יכולים לשנות את שם המאגר אחרי שאתם יוצרים את האשכול.

‫1.30 וגרסאות קודמות

אפשר לשנות את שם המאגר אחרי שיוצרים את האשכול.

דוגמה:

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

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

חובה אם loadBalancer.kind = MetalLB
ניתן לשינוי (יש חריג)

מערך של מחרוזות, שכל אחת מהן היא טווח של כתובות. כל טווח צריך להיות בפורמט CIDR או בפורמט של טווח עם מקפים.

‫1.32 ומעלה

ההתנהגות של השדה הזה זהה למצב שבו enableAdvancedCluster מוגדר לערך true (אשכול מתקדם מופעל) או false (אשכול מתקדם לא מופעל). בשני המקרים, אתם יכולים להוסיף כתובות למאגר כתובות קיים, אבל אי אפשר להסיר כתובות.

1.31

אם הפעלתם את האשכול המתקדם: אתם יכולים להוסיף כתובות למאגר כתובות קיים, אבל אי אפשר להסיר כתובות.
אם לא הפעלתם את האשכול המתקדם: אתם יכולים להוסיף ולהסיר כתובות ממאגר כתובות קיים.

‫1.30 וגרסאות קודמות

אתם יכולים להוסיף כתובות למאגר כתובות קיים ולהסיר ממנו כתובות.

דוגמה:

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`

רלוונטי אם loadBalancer.kind = MetalLB
ניתן לשינוי
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

אם מגדירים את הערך true, בקר MetalLB לא יקצה לשירותים כתובות IP שמסתיימות ב-‎ .0 או ב-‎ .255. כך נמנעת הבעיה של מכשירים צרכניים עם באגים, שמשמיטים בטעות תעבורת נתונים שנשלחת לכתובות ה-IP המיוחדות האלה.

דוגמה:

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`

רלוונטי אם loadBalancer.kind = MetalLB
ניתן לשינוי
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

אם אתם לא רוצים שהבקר של MetalLB יקצה באופן אוטומטי כתובות IP מהמאגר הזה לשירותים, הגדירו את הערך true. לאחר מכן, מפתח יכול ליצור שירות מסוג LoadBalancer ולציין באופן ידני את אחת מהכתובות במאגר.

אחרת, מגדירים את הערך false.

דוגמה:

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

`enableDataplaneV2`

‫1.30 ומעלה

ניתן לשינוי (מותר לשנות מ-false ל-true)
בוליאני
מאוכלס מראש: true
ברירת מחדל: false

השדה הזה קובע את ממשק הרשת של הקונטיינר (CNI) שבו משתמש האשכול. כדי להשתמש ב-Controlplane V2, צריך להפעיל את Dataplane V2. אפשר לשנות את השדה מ-false ל-true כדי להפעיל את Dataplane V2, אבל אי אפשר להשבית את Dataplane V2.

בגרסה 1.30 ואילך, צריך להשתמש ב-Dataplane V2 באשכולות משתמשים חדשים, ולהגדיר אותו ל-true. כדי להעביר אשכול קיים בגרסה 1.30 ל-Dataplane V2, קראו את המאמר העברת אשכול משתמש לתכונות המומלצות.
בגרסה 1.31, חובה להשתמש ב-Dataplane V2 בכל האשכולות. לפני השדרוג לגרסה 1.31, צריך לבצע את השלבים שמפורטים במאמר הפעלת Dataplane V2.

היתרונות של Dataplane V2 כוללים:

Dataplane V2 מספק ממשק רשת מתקדם יותר לקונטיינרים (CNI) בהשוואה לאפשרות הקודמת של CNI, ‏Calico. ‫Calico נמצא במצב תחזוקה, כלומר הוא מקבל רק תיקוני באגים קריטיים ועדכוני אבטחה, אבל לא מפתחים בו תכונות חדשות. לעומת זאת, Dataplane V2 מפותח ומשופר באופן פעיל, כדי להבטיח שתהיה לכם גישה לחידושים וליכולות העדכניים ביותר בתחום הרשתות.
‫Dataplane V2 הוא ה-CNI המועדף ל-GKE ולמוצרים אחרים של Google Distributed Cloud.

‫1.29 ומטה

לא ניתן לשינוי
בוליאני
מאוכלס מראש: true
ברירת מחדל: false

אם רוצים להפעיל את Dataplane V2 או להשתמש ב-Controlplane V2, צריך להגדיר את הערך true. אחרת, צריך להגדיר את הערך false.

מומלץ להפעיל את Dataplane V2.

דוגמה:

  enableDataplaneV2: true

פתרון בעיות ב-Google Distributed Cloud NFS וב-DataPlane v2

`dataplaneV2.forwardMode`

ניתן לשינוי
מחרוזת
ערכים אפשריים: "snat",‏ "dsr"
מאוכלס מראש: "snat"
ברירת מחדל: "snat"

מצב ההעברה של אשכול שבו Dataplane V2 מופעל.

במצב תרגום כתובת רשת של מקור (SNAT), חבילת נתונים עוברת תרגום SNAT כשהיא מועברת מצומת של מאזן עומסים ל-Pod בקצה העורפי. ה-Pod לא יכול לראות את כתובת ה-IP של המקור המקורי, וחבילת הנתונים שמוחזרת חייבת לעבור דרך הצומת של מאזן העומסים.

במצב החזרה ישירה לשרת (DSR), חבילה שומרת על כתובת ה-IP המקורית שלה כשהיא מועברת מצומת של מאזן עומסים ל-Pod לקצה העורפי. ה-Pod יכול לראות את כתובת ה-IP של המקור המקורי, וחבילת הנתונים שמוחזרת עוברת ישירות ללקוח בלי לעבור דרך צומת מאזן העומסים.

דוגמה:

dataplaneV2:
  forwardMode: "dsr"

`multipleNetworkInterfaces`

לא ניתן לשינוי
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, השדה הזה חייב להיות false.

אם רוצים להפעיל כמה ממשקי רשת ל-Pods, צריך להגדיר את הערך true.

מידע נוסף מופיע במאמר הגדרת כמה ממשקי רשת לפודים.

דוגמה:

multipleNetworkInterfaces: true

`advancedNetworking`

Immutable
boolean
Prepopulated: false
Default: false

אם אתם מתכננים ליצור שער NAT לתעבורת נתונים יוצאת, הגדירו את הערך true. אחרת, מגדירים אותו לערך false.

אם מגדירים את השדה הזה לערך true, צריך להגדיר גם את enableDataplaneV2 לערך true.

דוגמה:

advancedNetworking: true

`disableBundledIngress`

מגדירים את הערך true אם רוצים להשבית את ה-Ingress המצורף לאשכול. אחרת, מגדירים אותו לערך false.

בוליאני
ניתן לשינוי
מאוכלס מראש: false
ברירת מחדל: false

דוגמה:

disableBundledIngress: true

`storage.vSphereCSIDisabled`

כדי להשבית את הפריסה של רכיבי vSphere CSI, מגדירים את הערך true. אחרת, מגדירים אותו לערך false.

אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, השדה הזה חייב להיות true.

ניתן לשינוי
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

דוגמה:

storage:
  vSphereCSIDisabled: false

`masterNode`

בקטע הזה מופיע מידע על הצמתים שמשמשים כצמתים של מישור הבקרה באשכול המשתמש הזה.

`masterNode.controlPlaneLoadBalancer`

‫1.32 ומעלה

אפשר להוסיף את הקטע הזה כדי לציין את סוג מאזן העומסים שבו רוצים להשתמש לתעבורת הנתונים של מישור הבקרה באשכול המשתמש. כדי להגדיר באופן מפורש את סוג מאזן העומסים שבו רוצים להשתמש, במקום להסתמך על ערך ברירת המחדל, צריך לכלול את masterNode.controlPlaneLoadBalancer.mode בקובץ התצורה. בנוסף, צריך להגדיר את loadBalancer.kind בקובץ התצורה כדי לציין את סוג מאזן העומסים שבו רוצים להשתמש במישור הנתונים.

`masterNode.controlPlaneLoadBalancer.mode`

אופציונלי
לא ניתן לשינוי
מחרוזת
ברירת מחדל: תלוי אם האשכול משתמש בדומיינים של טופולוגיה

עם דומיינים של טופולוגיה: מציינים את ערך ברירת המחדל "manual". אם אתם רוצים להשתמש בדומיינים של טופולוגיה, אתם צריכים להגדיר מאזן עומסים של צד שלישי (כמו F5 BIG-IP או Citrix).
בלי דומיינים של טופולוגיה: מציינים את "manual" או את "bundled". משתמשים ב-"manual" אם יש לכם מאזן עומסים של צד שלישי, או ב-"bundled" בשביל הפתרון המשולב שלנו, שמשתמש ב-keepalived + haproxy שפועלים בצומתי מישור הבקרה. ערך ברירת המחדל הוא "bundled".

דוגמה:

adminMaster:
  controlPlaneLoadBalancer:
    mode: "manual"

‫1.31 ומטה

הקטע הזה לא זמין. במקום זאת, צריך להשתמש ב-loadBalancer.kind כדי לציין את סוג מאזן העומסים שבו ישתמש אשכול המשתמשים.

`masterNode.cpus`

ניתן לשינוי
מספר שלם
מאוכלס מראש: 4
ברירת מחדל: 4

מספר המעבדים לכל צומת שמשמש כמישור בקרה באשכול המשתמש הזה.

דוגמה:

masterNode:
  cpus: 8

`masterNode.memoryMB`

ניתן לשינוי
מספר שלם
מאוכלס מראש: 8192
ברירת מחדל: 8192

זיכרון ב-MiB לכל צומת שמשמש כמישור בקרה לאשכול המשתמשים הזה. חייב להיות כפולה של 4.

דוגמה:

masterNode:
  memoryMB: 8192

הערה: השדה הזה מציין את מספר המגה-בייטים (MiB) של הזיכרון, ולא את מספר המגה-בייטים (MB). מגה-בייט בינארי אחד הוא ‎2^20 = 1,048,576‎ בייטים. מגה-בייט אחד הוא 10‎^6 = 1,000,000 בייטים.

`masterNode.replicas`

לא ניתן לשינוי
מספר שלם
ערכים אפשריים: 1 או 3
מאוכלס מראש: 1
ברירת מחדל: 1

מספר הצמתים של מישור הבקרה באשכול המשתמש הזה. אי אפשר לשנות את המספר הזה אחרי שיוצרים את האשכול. אם תרצו לעדכן את מספר הרפליקות מאוחר יותר, תצטרכו ליצור מחדש את אשכול המשתמשים.

אם הערך בשדה enableAdvancedCluster הוא true, צריך להגדיר את השדה הזה לערך 3. באשכולות מתקדמים יש תמיכה רק באשכולות משתמשים בזמינות גבוהה (HA).

דוגמה:

masterNode:
  replicas: 3

`masterNode.autoResize.enabled`

ניתן לשינוי
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

כדי לאפשר שינוי גודל אוטומטי של צומתי מישור הבקרה באשכול המשתמש, צריך להגדיר את הערך true. אחרת, מגדירים את הערך false.

למידע נוסף, קראו את המאמר הפעלת שינוי גודל של צומתי מישור הבקרה באשכול משתמש.

דוגמה:

masterNode:
  autoResize:
    enabled: true

`masterNode.vsphere`

אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, צריך להסיר את כל הקטע הזה.

`masterNode.vsphere.datastore`

אופציונלי
לא ניתן לשינוי
מחרוזת
ברירת מחדל: הערך של vCenter.datastore

מאגר הנתונים שבו ייווצרו הצמתים של מישור הבקרה של אשכול המשתמש הזה.

הערך שאתם מציינים חייב להיות שם, לא נתיב. אל תכללו תיקיות בערך.

דוגמה:

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

אם מציינים ערך בשדה הזה, לא מציינים ערך בשדה masterNode.vsphere.storagePolicyName. השדה masterNode.vsphere.datastore לא ניתן לשינוי, אלא אם מגדירים אותו כמחרוזת ריקה כשמעבירים מאגר נתונים לניהול מבוסס מדיניות אחסון (SPBM).

`masterNode.vsphere.storagePolicyName`

אופציונלי
לא ניתן לשינוי
מחרוזת
ברירת מחדל: הערך של vCenter.storagePolicyName

השם של מדיניות האחסון של המכונה הווירטואלית לצומתי מישור הבקרה.

מידע נוסף זמין במאמר הגדרת מדיניות אחסון.

דוגמה:

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

אם מציינים ערך בשדה הזה, לא מציינים ערך בשדה masterNode.vsphere.datastore.

`masterNode.topologyDomains`

‫1.32 ומעלה

תצוגה מקדימה
אופציונלי
מערך של מחרוזות | מאפשר רכיב אחד או שלושה רכיבים שונים
לא ניתן לשינוי
ברירת מחדל: vSphereInfraConfig.defaultTopologyDomain אם צוין בקובץ התצורה של תשתית vSphere

מערך של דומיינים של טופולוגיה. אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין (מה שמציין שהאשכול ישתמש בדומיינים של טופולוגיה), אפשר לכלול את השדה הזה. מספר הדומיינים של הטופולוגיה במערך קובע איך הצמתים של מישור הבקרה באשכול המשתמשים נפרסים, באופן הבא:

רכיב אחד: כל הצמתים של מישור הבקרה באשכול המשתמשים ייפרסו בדומיין הטופולוגיה שצוין.
שלושה רכיבים: כל צומת של מישור הבקרה באשכול המשתמשים ייפרס בדומיין טופולוגיה אחר (כלומר, צומת אחד לכל דומיין טופולוגיה).

1.31

תצוגה מקדימה
אופציונלי
מערך של מחרוזות | אבל יש תמיכה רק ברכיב אחד
לא ניתן לשינוי
ברירת מחדל: vSphereInfraConfig.defaultTopologyDomain אם צוין בקובץ התצורה של תשתית vSphere

מערך של דומיינים של טופולוגיה. אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין (מה שמציין שהאשכול ישתמש בדומיינים של טופולוגיה), אפשר לכלול את השדה הזה. הצמתים של מישור הבקרה באשכול המשתמשים ייפרסו בדומיין הטופולוגיה שצוין.

‫1.30 ומטה

לא זמין.

`nodePools`

חובה
ניתן לשינוי
מערך של אובייקטים, שכל אחד מהם מתאר מאגר צמתים.

מידע נוסף זמין במאמר יצירה וניהול של מאגרי צמתים.

`nodePools[i].name`

חובה
לא ניתן לשינוי
מחרוזת

שם לבחירתכם למאגר הצמתים. השם צריך:

לכלול עד 40 תווים
להכיל רק תווים אלפאנומריים באותיות קטנות או מקף (-)
להתחיל באות
להסתיים בתו אלפאנומרי

דוגמה:

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

`nodePools[i].gkeOnPremVersion`

כשמשדרגים אשכול משתמש, אפשר לציין שמאגרי צומתי העובדים שנבחרו יישארו בגרסה הקודמת.

אם רוצים שמאגר הצמתים העובדים הזה יישאר בגרסה הקודמת, צריך להגדיר אותו לגרסה הקודמת. אחרת, צריך להסיר את השדה הזה או להגדיר אותו כמחרוזת ריקה. האפשרות הזו זמינה רק למאגרים של צומתי עובדים. מאגרי הצמתים של מאזן העומסים (מאגרי צמתים עם enableLoadBalancer: true) חייבים להתאים ל-gkeOnPremVersion של האשכול. מידע נוסף זמין במאמר שדרוג אשכול משתמש.

ניתן לשינוי
מחרוזת
ברירת מחדל: האשכול gkeOnPremVersion

דוגמה:

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

`nodePools[i].cpus`

חובה
ניתן לשינוי
מספר שלם
מאוכלס מראש: 4

מספר המעבדים הווירטואליים לכל צומת במאגר.

דוגמה:

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

`nodePools[i].memoryMB`

חובה
ניתן לשינוי
מספר שלם
מאוכלס מראש: 8192

כמות הזיכרון במגה-בייטים לכל צומת במאגר. חייב להיות כפולה של 4.

דוגמה:

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

`nodePools[i].replicas`

חובה
ניתן לשינוי
מספר שלם
מאוכלס מראש: 3
ערכים אפשריים: המספר הכולל של הצמתים ללא taint בכל מאגרי הצמתים באשכול חייב להיות לפחות 3.

מספר הצמתים במאגר.

דוגמה:

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

`nodePools[i].bootDiskSizeGB`

ניתן לשינוי
מספר שלם
מאוכלס מראש: 40
ברירת מחדל: 40

גודל דיסק האתחול ב-GiB לכל צומת במאגר.

דוגמה:

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

`nodePools[i].osImageType`

ניתן לשינוי
מחרוזת
ערכים אפשריים: לגרסאות 1.34 וגרסאות קודמות: "ubuntu_containerd",‏ "cos"
לגרסה 1.35 וגרסאות חדשות יותר: "ubuntu_cgv2",‏ "cos_cgv2"
מאוכלס מראש: "ubuntu_cgv2"
ברירת מחדל: "ubuntu_cgv2"

סוג קובץ האימג' של מערכת ההפעלה שיופעל במכונות הווירטואליות במאגר הצמתים.

בגרסה 1.32, מאגרי הצמתים של Windows Server הוצאו משימוש והם לא יהיו זמינים בגרסה 1.33 ואילך. התמיכה במאגרי צמתים של Windows Server תסתיים ב-5 במאי 2026. מומלץ לא להשתמש ב-"windows " כסוג קובץ האימג' של מערכת ההפעלה באשכולות חדשים.

שימו לב למגבלה הבאה באשכולות מתקדמים:

גרסה 1.31: אם השדה enableAdvancedCluster הוא true, רק ubuntu-cgroupv2 ו-ubuntu_containerd נתמכים באשכולות מתקדמים.
גרסה 1.32: כל סוגי קובצי האימג' של מערכת ההפעלה, חוץ מ-"windows", נתמכים באשכולות מתקדמים.

דוגמה:

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

`nodePools[i].osImage`

חובה אם nodePools[i].osImageType = windows
ניתן לשינוי
מחרוזת

השם של תבנית Windows VM. התבנית צריכה להתבסס על קובץ ISO של Windows Server 2019 עם תג השפה/האזור en-US.

מידע נוסף זמין במאמר מדריך למשתמש למאגרי צמתים של מערכת ההפעלה Windows Server.

`nodePools[i].labels`

מיפוי
ניתן לשינוי

תוויות שצריך להחיל על כל אובייקט של צומת Kubernetes במאגר.

דוגמה:

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

מסיבות אבטחה, ה-kubelet לא יכול להחיל תוויות על עצמו במרחבי שמות מסוימים.

מרחבי השמות השמורים של תוויות הצמתים הם : kubernetes.io, ‏ k8s.io, ‏ googleapis.com.

`nodePools[i].taints`

ניתן לשינוי
מערך של אובייקטים, שכל אחד מהם מתאר Kubernetes taint שמוחל על כל צומת במאגר. Taints הם צמדי מפתח/ערך שמשויכים ל-effect. הכתמות משמשות עם סבילות לתזמון Pod. צריך לציין אחת מהאפשרויות הבאות בשביל effect: NoSchedule, PreferNoSchedule, NoExecute.

דוגמה:

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

`nodePools[i].vsphere`

אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, צריך להסיר את כל השדות בקטע nodePools[i].vsphere חוץ מ-nodePools[i].vsphere.tags.

`nodePools[i].vsphere.datastore`

ניתן לשינוי
מחרוזת
ברירת מחדל: הערך של vCenter.datastore

השם של מאגר הנתונים ב-vCenter שבו ייווצרו הצמתים.

דוגמה:

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

אם מציינים ערך בשדה הזה, לא מציינים ערך בשדה nodePools[i].vsphere.storagePolicyName.

`nodePools[i].vsphere.storagePolicyName`

ניתן לשינוי
מחרוזת
ברירת מחדל: הערך של vCenter.storagePolicyName

השם של מדיניות האחסון של ה-VM לצמתים במאגר.

מידע נוסף זמין במאמר הגדרת מדיניות אחסון.

דוגמה:

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

אם מציינים ערך בשדה הזה, לא מציינים ערך בשדה nodePools[i].vsphere.datastore.

`nodePools[i].vsphere.hostgroups`

מלאו את הפרטים בקטע הזה אם אתם רוצים להגדיר את האשכול לשימוש בשיוך (affinity) של מארח VM. אם השדה infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין, צריך להגדיר קבוצות מארחים בשדה topologyDomains[i].compute.hostGroups בקובץ התצורה של תשתית vSphere.

ניתן לשינוי
מערך של מחרוזות, שכל אחת מהן היא שם של קבוצת DRS מארחת.

המערך יכול להכיל רק רכיב אחד.

דוגמה:

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

`nodePools[i].vsphere.tags`

ניתן לשינוי
מערך של אובייקטים, שכל אחד מהם מתאר תג vSphere שיוצב במכונות הווירטואליות במאגר הצמתים.

לכל תג יש קטגוריה ושם.

דוגמה:

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

אם אתם רוצים לצרף תגים לכל המכונות הווירטואליות במאגר צמתים, לחשבון המשתמש שלכם ב-vCenter צריכות להיות הרשאות התיוג הבאות ב-vSphere:

תיוג ב-vSphere.הקצאה או ביטול הקצאה של תג vSphere
תיוג ב-vSphere.הקצאה או ביטול הקצאה של תג vSphere באובייקט (vSphere 7)

`nodePools[i].autoscaling`

ניתן לשינוי

אם רוצים להפעיל התאמה אוטומטית לעומס (automatic scaling) של מאגר הצמתים, ממלאים את החלק הזה. אחרת, צריך להסיר את הקטע הזה או להשאיר אותו מסומן כהערה.

`nodePools[i].autoscaling.minReplicas`

ניתן לשינוי
מספר שלם
ערכים אפשריים: גדול מ-1 או שווה לו
מאוכלס מראש: 0

המספר המינימלי של צמתים שהמידרוג האוטומטי יכול להגדיר למאגר.

דוגמה:

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

`nodePools[i].autoscaling.maxReplicas`

ניתן לשינוי
מספר שלם
מאוכלס מראש: 0

המספר המקסימלי של צמתים שהמידרוג האוטומטי יכול להגדיר למאגר.

דוגמה:

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

`nodePools[i].enableLoadBalancer`

רלוונטי אם loadBalancer.kind = "MetalLB"
ניתן לשינוי
בוליאני
מאוכלס מראש: true
ברירת מחדל: false

‫1.32 ומעלה

ההתנהגות של השדה הזה זהה כשמגדירים את enableAdvancedCluster לערך true (אשכול מתקדם מופעל) או לערך false (אשכול מתקדם לא מופעל). בשני המקרים, צריך להגדיר את הערך true אם רוצים לאפשר ל-MetalLB speaker לפעול בצמתים שבמאגר. אחרת, מגדירים אותו לערך false.

1.31

אם מפעילים אשכול מתקדם: לשדה הזה אין השפעה כי ה-MetalLB speaker תמיד יפעל בצמתים של מישור הבקרה של אשכול המשתמש.
אם לא מופעל אשכול מתקדם: מגדירים את הערך true כדי לאפשר לרמקול MetalLB לפעול בצמתים במאגר. אחרת, מגדירים אותו לערך false.

‫1.29 ומטה

כדי לאפשר ל-MetalLB speaker לפעול בצמתים במאגר, צריך להגדיר את הערך true. אחרת, מגדירים אותו לערך false.

מידע נוסף מופיע במאמר איזון עומסים בחבילה עם MetalLB.

דוגמה:

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

`nodePools[i].updateStrategy.rollingUpdate.maxSurge`

תצוגה מקדימה
ניתן לשינוי
מספר שלם
ברירת מחדל: 1

המספר המקסימלי של מכונות במאגר הצמתים שאפשר לעדכן בו-זמנית במהלך עדכון או שדרוג.

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

`nodePools[i].topologyDomains`

‫1.31 ומעלה

אם infraConfigFilePath מוגדר בקובץ התצורה של אשכול האדמין (שמפעיל דומיינים של טופולוגיה), אפשר לכלול את השדה הזה.

מערך של מחרוזות | אבל יש תמיכה רק ברכיב אחד
לא ניתן לשינוי
ברירת המחדל: vSphereInfraConfig.defaultTopologyDomain אם צוין בקובץ התצורה של תשתית vSphere

הצמתים במאגר הצמתים הזה יועברו לדומיין הטופולוגיה שצוין בשדה הזה. לכל מאגר צמתים אפשר להגדיר רק דומיין טופולוגיה אחד. כל הצמתים במאגר צמתים ימוקמו בדומיין טופולוגיה אחד.

‫1.30 ומטה

לא זמין.

`schedulerConfiguration`

‫1.32 ומעלה

תצוגה מקדימה
אופציונלי

כשמגדירים דומיינים של טופולוגיה, אפשר להגדיר הגדרות נוספות שיועברו אל kube-scheduler.

`schedulerConfiguration.defaultTopologySpreadConstraint`

גרסת טרום-השקה (Preview)
אופציונלי
לא ניתן לשינוי

אובייקט שמגדיר כלל אילוץ של פריסת טופולוגיה כברירת מחדל ברמת האשכול, שמוחל על תזמון Pod. אם הכלל הזה מוגדר, כשיוצרים את אשכול המשתמש עם דומיינים של טופולוגיה, kube-scheduler לוקח את מפתח הטופולוגיה שמוגדר כברירת מחדל ומפזר עליו פודים של Deployments,‏ Statefulsets ו-Replicasets כברירת מחדל. המבנה זהה לאילוצי ברירת המחדל ברמת האשכול של Kubernetes.

דוגמה:

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

לפרטים, עיינו במאמר אילוצי ברירת מחדל ברמת האשכול במסמכי התיעוד של Kubernetes.

‫1.31 ומטה

לא זמין.

`antiAffinityGroups.enabled`

ניתן לשינוי
ערך בוליאני
מאוכלס מראש: true
ברירת מחדל: true

אם השדה הזה הוא true, מערכת Google Distributed Cloud יוצרת כללי אנטי-אפיניות של Distributed Resource Scheduler‏ (DRS) של VMware לצומתי אשכול המשתמשים, וכך הם מתפרסים על פני לפחות שלושה מארחי ESXi פיזיים במרכז הנתונים.

כדי להשתמש בתכונה הזו, סביבת vSphere צריכה לעמוד בתנאים הבאים:

‫VMware DRS מופעל. כדי להשתמש ב-VMware DRS, צריך רישיון ל-vSphere Enterprise Plus.
לחשבון המשתמש ב-vSphere יש את ההרשאה Host.Inventory.Modify cluster.
יש לפחות ארבעה מארחי ESXi זמינים.

למרות שהכלל דורש שצומתי האשכול יתפרסו על פני שלושה מארחי ESXi, מומלץ מאוד שיהיו לכם לפחות ארבעה מארחי ESXi זמינים.

חשוב לזכור שאם יש לכם רישיון vSphere Standard, אתם לא יכולים להפעיל את VMware DRS.

אם DRS לא מופעל, או אם אין לכם לפחות ארבעה מארחים שבהם אפשר לתזמן מכונות וירטואליות של vSphere, צריך להגדיר את antiAffinityGroups.enabled לערך false.

שימו לב למגבלה הבאה באשכולות מתקדמים:

גרסה 1.31: אם השדה enableAdvancedCluster הוא true, כללי anti-affinity לא נתמכים באשכולות מתקדמים, וצריך להגדיר את antiAffinityGroups.enabled ל-false.
גרסה 1.32: תמיכה בכללי אנטי-אפיניות באשכולות מתקדמים.

דוגמה:

antiAffinityGroups:
  enabled: false

`enableVMTracking`

גרסת טרום-השקה (Preview)
לא ניתנת לשינוי
מאוכלסת מראש: false

כדי להפעיל מעקב אחרי מכונות וירטואליות באמצעות תגי vSphere, מגדירים את הערך true. אחרת, מגדירים אותו לערך false.

מידע נוסף זמין במאמר הפעלת מעקב אחרי מכונות וירטואליות.

דוגמה:

enableVMTracking: true

`nodePoolUpdatePolicy.maximumConcurrentNodePoolUpdate`

ניתן לשינוי
מספר שלם

מספר מאגרי הצמתים שצריך לעדכן בכל פעם. הערך 1 מציין שאפשר לעדכן מאגר צמתים אחד בכל פעם. הערך 0 מציין שאפשר לעדכן מספר בלתי מוגבל של מאגרי צמתים בכל פעם.

אשכול מתקדם

שימו לב למגבלה הבאה באשכולות מתקדמים:

גרסה 1.31: אם השדה enableAdvancedCluster הוא true, מדיניות העדכון של מאגר הצמתים לא נתמכת באשכולות מתקדמים, ולכן צריך להסיר את הקטע הזה מקובץ התצורה.
גרסה 1.32: מדיניות עדכון של מאגרי צמתים נתמכת באשכולות מתקדמים.
ערך ברירת המחדל של maximumConcurrentNodePoolUpdate משתנה בהתאם לגרסה:
- גרסה 1.32.0-1.32.1000 : ערך ברירת המחדל הוא 1.
- גרסה 1.32.1100 ואילך: ערך ברירת המחדל הוא 0.
- גרסה 1.33.0 עד 1.33.600: ערך ברירת המחדל הוא 1.
- גרסה 1.33.700 ואילך: ערך ברירת המחדל הוא 0.
- גרסה 1.34.0-1.34.200: ערך ברירת המחדל הוא 1.
- גרסה 1.34.300 ואילך: ערך ברירת המחדל הוא 0.

אשכול לא מתקדם

ערכים אפשריים: 0 או 1
מאוכלס מראש: 0
ברירת מחדל: 0

דוגמה:

nodePoolUpdatePolicy:
  maximumConcurrentNodePoolUpdate: 1

nodePoolUpdatePolicy.updateStrategy.rollingUpdate.maxSurge

תצוגה מקדימה
ניתן לשינוי
מספר שלם
ברירת מחדל: 1

המספר המקסימלי של מכונות במאגר צמתים שאפשר לעדכן בו-זמנית במהלך עדכון או שדרוג. ההגדרה חלה על כל מאגר צמתים שלא צוינה בו אסטרטגיית עדכון משלו.

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

`authentication`

בקטע הזה מוסבר איך המשתמשים באשכול מאומתים ומורשים.

`authentication.oidc`

אשכול מתקדם

`authentication.oidc.issuerURL`

אופציונלי
מחרוזת

כתובת ה-URL שאליה נשלחות בקשות ההרשאה לספק OpenID Connect ‏ (OIDC). שרת ה-API של Kubernetes משתמש בכתובת ה-URL הזו כדי לגלות מפתחות ציבוריים לאימות אסימונים. כתובת ה-URL חייבת להשתמש ב-HTTPS.

`authentication.oidc.kubectlRedirectURL`

אופציונלי
מחרוזת

כתובת ה-URL להפניה אוטומטית שמשמשת את kubectl לצורך הרשאה. כשמפעילים את OIDC, צריך לציין ערך של kubectlRedirectURL.

`authentication.oidc.clientID`

אופציונלי
מחרוזת

המזהה של אפליקציית הלקוח ששולחת בקשות אימות לספק OpenID.

`authentication.oidc.username`

אופציונלי
מחרוזת

הצהרת JSON Web Token (JWT) לשימוש כשם המשתמש.

`authentication.oidc.usernamePrefix`

אופציונלי
מחרוזת

התחילית שנוספת לתביעות של שם המשתמש.

`authentication.oidc.group`

אופציונלי
מחרוזת

הצהרת JSON Web Token ‏ (JWT) שהספק משתמש בה כדי להחזיר את קבוצות האבטחה.

`authentication.oidc.groupPrefix`

אופציונלי
מחרוזת

קידומת שנוספת לתביעות של קבוצות כדי למנוע התנגשויות עם שמות קיימים. לדוגמה, אם יש קבוצה dev ותחילית oidc:, oidc:dev.

`authentication.oidc.scopes`

אופציונלי
מחרוזת

היקפים נוספים לשליחה ל-OIDC כרשימה מופרדת בפסיקים.

`authentication.oidc.extraParams`

אופציונלי
מחרוזת

פרמטרים נוספים של מפתח/ערך שיישלחו ל-OIDC כרשימה מופרדת בפסיקים.

`authentication.oidc.deployCloudConsoleProxy`

אופציונלי
בוליאני
ברירת מחדל: false

מציין אם שרת proxy הפוך נפרס באשכול כדי לחבר את מסוףGoogle Cloud לספק זהויות מקומי שלא נגיש באופן ציבורי דרך האינטרנט. אם אין גישה לספק הזהויות דרך האינטרנט הציבורי, צריך להגדיר את השדה הזה כ-true כדי לבצע אימות באמצעות מסוףGoogle Cloud .

`authentication.oidc.caPath`

אופציונלי
מחרוזת

הנתיב המוחלט או היחסי לקובץ ה-CA.

אשכול לא מתקדם

אל תשתמשו בקטע הזה. במקום זאת, אחרי שיוצרים את האשכול, עורכים את המשאב בהתאמה אישית ClientConfig, כמו שמתואר במאמר הגדרת אשכולות של חברים ב-fleet לאימות OIDC.

`authentication.sni`

אם רוצים לספק אישור נוסף להצגה לשרת ה-API של Kubernetes באשכול, ממלאים את הקטע הזה. אחרת, צריך להסיר את הקטע הזה או להשאיר אותו מסומן כהערה.

`authentication.sni.certPath`

לא ניתן לשינוי
מחרוזת

הנתיב של אישור להצגה לשרת ה-API של Kubernetes.

דוגמה:

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

`authentication.sni.keyPath`

אופציונלי
לא ניתן לשינוי
מחרוזת

הנתיב של קובץ המפתח הפרטי של האישור.

דוגמה:

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

`gkeConnect`

חובה
לא ניתן לשינוי

בקטע הזה מוסבר על Google Cloud הפרויקט וחשבון השירות שבהם רוצים להשתמש כדי לרשום את האשכול ל- Google Cloud fleet.

`gkeConnect.projectID`

חובה
לא ניתן לשינוי
מחרוזת

המזהה של הפרויקט המארח של ה-Fleet. באשכולות חדשים, מזהה הפרויקט הזה צריך להיות זהה למזהה שמוגדר ב-stackdriver.projectID וב-cloudAuditLogging.projectID. אם מזהי הפרויקטים לא זהים, יצירת האשכול תיכשל. הדרישה הזו לא חלה על אשכולות קיימים.

דוגמה:

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

`gkeConnect.location`

לא ניתן לשינוי
מחרוזת
ברירת מחדל: global

החברות ב-fleet של כל אשכול מנוהלת על ידי שירות Fleet‏ (gkehub.googleapis.com) ושירות Connect‏ (gkeconnect.googleapis.com). המיקום של השירותים יכול להיות גלובלי או אזורי. בגרסה 1.28 ואילך, אפשר לציין את האזור שבו פועלים שירותי Fleet ו-Connect. Google Cloudאם לא מציינים, המערכת משתמשת במכונות הגלובליות של השירותים. שימו לב לנקודות הבאות:

אשכולות של משתמשים שנוצרו לפני גרסה 1.28 מנוהלים על ידי השירותים הגלובליים Fleet ו-Connect.
אשכולות חדשים שנוצרים באמצעות לקוחות API של GKE On-Prem – מסוף Google Cloud ,‏ Google Cloud CLI או Terraform – משתמשים באותו אזור שציינתם ל-GKE On-Prem API.
באשכולות חדשים, אם אתם כוללים את השדה הזה, האזור שאתם מציינים חייב להיות זהה לאזור שהוגדר ב-cloudAuditLogging.clusterLocation, ב-stackdriver.clusterLocation וב-gkeOnPremAPI.location. אם האזורים לא זהים, יצירת האשכול תיכשל.

דוגמה:

gkeConnect:
  location: "us-central1"

`gkeConnect.registerServiceAccountKeyPath`

חובה
ניתן לשינוי
מחרוזת

הנתיב של קובץ המפתח בפורמט JSON של חשבון השירות connect-register.

כדי לעדכן את הערך של השדה הזה, צריך להשתמש ב-gkectl update cluster.

למידע על שינוי המפתח של חשבון השירות connect-register, קראו את המאמר רוטציית מפתחות של חשבונות שירות.

דוגמה:

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

`gkeConnect.registerServiceAccountKey.secretRef.version`

ניתן לשינוי
מחרוזת
ערכים אפשריים: מחרוזת של מספר שלם או "latest"
ערך ברירת המחדל: "latest"

גרסת הסוד המוכן באשכול האדמין, שמכילה מפתח JSON לחשבון השירות connect-register.

דוגמה:

gkeConnect:
  registerServiceAccountKey:
    secretRef:
      version: "1"

`gkeOnPremAPI`

בגרסה 1.16 ואילך, אם GKE On-Prem API מופעל בפרויקט ב-Google Cloud , כל האשכולות בפרויקט רשומים ל-GKE On-Prem API באופן אוטומטי באזור שהוגדר ב-stackdriver.clusterLocation.

אם אתם רוצים לרשום את כל האשכולות בפרויקט ל-GKE On-Prem API, הקפידו לבצע את השלבים שמפורטים בקטע לפני שמתחילים כדי להפעיל את GKE On-Prem API בפרויקט ולהשתמש בו.
אם אתם לא רוצים לרשום את האשכול ב-GKE On-Prem API, צריך לכלול את הקטע הזה ולהגדיר את gkeOnPremAPI.enabled כ-false. אם אתם לא רוצים לרשום אשכולות בפרויקט, השביתו את gkeonprem.googleapis.com (שם השירות של GKE On-Prem API) בפרויקט. הוראות מפורטות זמינות במאמר השבתת שירותים.

רישום אשכול המשתמשים ב-GKE On-Prem API מאפשר לכם להשתמש בכלים הרגילים – מסוף Google Cloud ,‏ Google Cloud CLI ו-Terraform – כדי לנהל את מחזור החיים של האשכול. בנוסף, רישום האשכול מאפשר לכם להשתמש במסוף או ב-CLI של gcloud כדי לראות את פרטי האשכול. לדוגמה, אתם יכולים להריץ פקודות gcloud כדי לקבל מידע על אשכול המשתמשים.

אם תוסיפו את הקטע הזה ותיצרו או תעדכנו את האשכול, ואחר כך תסירו את הקטע ותעדכנו את האשכול, העדכון ייכשל.

`gkeOnPremAPI.enabled`

ניתן לשינוי
בוליאני
ברירת מחדל: true

כברירת מחדל, האשכול רשום ל-GKE On-Prem API אם הוא מופעל בפרויקט. אם לא רוצים לרשום את האשכול, מגדירים את הערך false.

אחרי שרושמים את האשכול ל-GKE On-Prem API, אם רוצים לבטל את הרישום של האשכול, צריך לבצע את השינוי הבא ואז לעדכן את האשכול:

gkeOnPremAPI:
  enabled: false

`gkeOnPremAPI.location`

Immutable
String
Default: stackdriver.clusterLocation

Google Cloud האזור שבו GKE On-Prem API פועל ומאחסן את המטא-נתונים של האשכול. בוחרים באחד מהאזורים הנתמכים. צריך להשתמש באותו אזור שמוגדר ב-gkeConnect.location, ב-stackdriver.clusterLocation וב-cloudAuditLogging.clusterLocation. אם הערך של gkeOnPremAPI.enabled הוא false, אל תכללו את השדה הזה.

`stackdriver`

חובה
ניתן לשינוי

בקטע הזה מפורטות ההגדרות הנדרשות ל-Cloud Logging ול-Cloud Monitoring.

`stackdriver.projectID`

חובה לרישום ביומן ולמעקב
לא ניתן לשינוי
מחרוזת

המזהה של הפרויקט המארח של ה-Fleet. באשכולות חדשים, מזהה הפרויקט הזה צריך להיות זהה למזהה שמוגדר ב-gkeConnect.projectID וב-cloudAuditLogging.projectID. אם מזהי הפרויקטים לא זהים, יצירת האשכול תיכשל. הדרישה הזו לא חלה על אשכולות קיימים.

במקרה הצורך, אפשר להגדיר נתב יומנים בפרויקט הזה כדי לנתב יומנים לקטגוריות של יומנים בפרויקט אחר. במאמר יעדים נתמכים מוסבר איך להגדיר את נתב היומנים.

דוגמה:

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

`stackdriver.clusterLocation`

נדרש לרישום ביומן ולמעקב
לא ניתן לשינוי
מחרוזת
מאוכלס מראש: "us-central1"

האזור ב- Google Cloud שבו רוצים לנתב ולאחסן את המדדים של Cloud Monitoring. מומלץ לבחור אזור שקרוב למרכז הנתונים המקומי.

בהגדרות של Log Router אתם מציינים את מיקום הניתוב והאחסון של היומנים ב-Cloud Logging. מידע נוסף על ניתוב יומנים מופיע במאמר סקירה כללית על ניתוב ואחסון.

ה-Stackdriver Operator (stackdriver-operator) מצרף את הערך מהשדה הזה לכל רשומת יומן ומדד לפני שהם מנותבים אל Google Cloud. התוויות המצורפות האלה יכולות לעזור לכם לסנן את היומנים והמדדים ב-Logs Explorer וב-Metrics Explorer, בהתאמה.

באשכולות חדשים, אם אתם כוללים את הקטעים gkeOnPremAPI ו-cloudAuditLogging בקובץ התצורה, האזור שאתם מגדירים כאן חייב להיות אותו אזור שהגדרתם ב-gkeConnect.location, ב-gkeOnPremAPI.location וב-cloudAuditLogging.clusterLocation. אם האזורים לא זהים, יצירת האשכול תיכשל.

דוגמה:

stackdriver:
  clusterLocation: "us-central1"

`stackdriver.serviceAccountKeyPath`

נדרש לרישום ביומן ולמעקב
ניתן לשינוי
מחרוזת

הנתיב של קובץ המפתח בפורמט JSON של חשבון השירות למעקב אחרי רישום ביומן.

כדי לעדכן את הערך של השדה הזה, צריך להשתמש ב-gkectl update cluster.

מידע נוסף על שינוי המפתח של חשבון השירות למעקב אחרי רישום ביומן זמין במאמר רוטציית מפתחות של חשבונות שירות.

דוגמה:

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

`stackdriver.serviceAccountKey.secretRef.version`

ניתן לשינוי
מחרוזת
ערכים אפשריים: מחרוזת של מספר שלם או "latest"
ערך ברירת המחדל: "latest"

הגרסה של Secret מוכן באשכול האדמין, שמכיל מפתח JSON לחשבון השירות שלכם למעקב אחרי רישום ביומן.

דוגמה:

stackdriver:
  serviceAccountKey:
    secretRef:
      version: "1"

`stackdriver.disableVsphereResourceMetrics`

ניתן לשינוי
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

כדי להשבית את איסוף המדדים מ-vSphere, מגדירים את הערך true. אחרת, מגדירים אותו לערך false.

דוגמה:

stackdriver:
  disableVsphereResourceMetrics: true

`usageMetering`

‫1.32 ומעלה

התכונה "מדידת השימוש" לא נתמכת בגרסה 1.32 ואילך. אל תכללו את הקטע הזה כשאתם יוצרים אשכולות חדשים. עם זאת, אשכולות קיימים שמשתמשים בתכונה הזו ימשיכו לפעול. במקום זאת, מומלץ להשתמש במרכז הבקרה המוגדר מראש Anthos Cluster Utilization Metering כדי להבין את השימוש במשאבים ברמות שונות. אם החלופה לא מתאימה לתרחישי השימוש שלכם, פנו ל-Cloud Customer Care.

‫1.30 ו-1.31

אנחנו ממליצים לא להשתמש בתכונה בגרסת טרום-השקה (Preview) הזו כשיוצרים אשכולות חדשים. עם זאת, אשכולות קיימים שמשתמשים בתכונה הזו ימשיכו לפעול. כחלופה, מומלץ להשתמש במרכז הבקרה המוגדר מראש Anthos Cluster Utilization Metering כדי להבין את השימוש במשאבים ברמות שונות.

אם הערך בשדה enableAdvancedCluster הוא true, צריך להסיר את הקטע הזה. אי אפשר למדוד את השימוש באשכולות מתקדמים.

‫1.29 ומטה

גרסת טרום-השקה (Preview)
לא ניתנת לשינוי

`usageMetering.bigQueryProjectID`

גרסת טרום-השקה (Preview)
נדרש למדידת השימוש
לא ניתן לשינוי
מחרוזת

מזהה הפרויקט ב- Google Cloud שבו רוצים לאחסן את נתוני מדידת השימוש.

דוגמה:

usageMetering:
bigQueryProjectID: "my-bq-project"

`usageMetering.bigQueryDatasetID`

גרסת טרום-השקה (Preview)
נדרש למדידת השימוש
לא ניתן לשינוי
מחרוזת

המזהה של מערך הנתונים ב-BigQuery שבו רוצים לאחסן את נתוני מדידת השימוש. דוגמה:

usageMetering:
bigQueryDatasetID: "my-bq-dataset"

`usageMetering.bigQueryServiceAccountKeyPath`

גרסת טרום-השקה (Preview)
נדרש למדידת השימוש
לא ניתן לשינוי
מחרוזת.

הנתיב של קובץ המפתח בפורמט JSON של חשבון השירות ב-BigQuery.

כדי לעדכן את הערך של השדה הזה, צריך להשתמש ב-gkectl update cluster.

מידע נוסף על שינוי המפתח של חשבון השירות ב-BigQuery זמין במאמר רוטציית מפתחות של חשבונות שירות.

דוגמה:

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

`usageMetering.bigQueryServiceAccountKey.secretRef.version`

ניתן לשינוי
מחרוזת
ערכים אפשריים: מחרוזת של מספר שלם או "latest"
ערך ברירת המחדל: "latest"

הגרסה של Secret מוכן באשכול האדמין, שמכיל מפתח JSON לחשבון השירות שלכם ב-BigQuery.

דוגמה:

gkeConnect:
bigQueryServiceAccountKey:
  secretRef:
    version: "1"

`usageMetering.enableConsumptionMetering`

גרסת טרום-השקה (Preview)
נדרש למדידת השימוש
לא ניתן לשינוי
בוליאני
מאוכלס מראש: false

כדי להפעיל מדידה לפי צריכה, צריך להגדיר את הערך true. אחרת, צריך להגדיר את הערך כ-false.

דוגמה:

usageMetering:
enableConsumptionMetering: true

`cloudAuditLogging`

אם אתם רוצים לשלב את יומני הביקורת משרת ה-API של Kubernetes באשכול עם יומני הביקורת של Cloud, מלאו את הקטע הזה. אחרת, הסירו את הקטע הזה או השאירו אותו מסומן כהערה.

`cloudAuditLogging.projectID`

נדרש ליומני ביקורת של Cloud
לא ניתן לשינוי
מחרוזת

המזהה של הפרויקט המארח של הצי. באשכולות חדשים, מזהה הפרויקט הזה צריך להיות זהה למזהה שמוגדר ב-gkeConnect.projectID וב-stackdriver.projectID. אם מזהי הפרויקטים לא זהים, יצירת האשכול תיכשל. הדרישה הזו לא חלה על אשכולות קיימים.

דוגמה:

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

`cloudAuditLogging.clusterLocation`

נדרש ליומני ביקורת של Cloud
לא ניתן לשינוי
מחרוזת

‫ Google Cloud : האזור שבו רוצים לאחסן את יומני הביקורת. מומלץ לבחור אזור שקרוב למרכז הנתונים המקומי,

באשכולות חדשים, אם אתם כוללים את הקטעים gkeOnPremAPI ו-stackdriver בקובץ התצורה, האזור שאתם מגדירים כאן חייב להיות אותו אזור שהגדרתם ב-gkeConnect.location, ב-gkeOnPremAPI.location וב-stackdriver.clusterLocation. אם האזורים לא זהים, יצירת האשכול תיכשל.

דוגמה:

cloudAuditLogging:
  clusterLocation: "us-central1"

`cloudAuditLogging.serviceAccountKeyPath`

נדרש ליומני ביקורת של Cloud
ניתן לשינוי
מחרוזת

הנתיב של קובץ מפתח ה-JSON של חשבון השירות לרישום ביומן הביקורת.

אם יוצרים את האשכול כשהערך של enableAdvancedCluster מוגדר כ-true (נדרש כדי להגדיר דומיינים של טופולוגיה), צריך להגדיר את cloudAuditLogging.serviceAccountKeyPath לאותו נתיב כמו stackdriver.serviceAccountKeyPath.

כדי לעדכן את הערך של השדה הזה, צריך להשתמש ב-gkectl update cluster.

מידע נוסף על שינוי המפתח של חשבון השירות לרישום ביומן הביקורת זמין במאמר רוטציית מפתחות של חשבונות שירות.

דוגמה:

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

`cloudAuditLogging.serviceAccountKey.secretRef.version`

ניתן לשינוי
מחרוזת
ערכים אפשריים: מחרוזת של מספר שלם או "latest"
ערך ברירת המחדל: "latest"

גרסת הסוד המוכן באשכול האדמין, שמכילה מפתח JSON לחשבון השירות של רישום הביקורת ביומן.

דוגמה:

cloudAuditLogging:
  serviceAccountKey:
    secretRef:
      version: "1"

`autoRepair.enabled`

אופציונלי
ניתן לשינוי
ערך בוליאני
מאוכלס מראש: true

כדי להפעיל תיקון אוטומטי של צמתים, מגדירים את הערך true. אחרת, מגדירים אותו לערך false.

דוגמה:

autoRepair:
  enabled: true

`secretsEncryption`

אם אתם רוצים להצפין סודות בלי להשתמש ב-KMS (שירות ניהול מפתחות) חיצוני או ביחסי תלות אחרים, מלאו את הפרטים בקטע הזה. אחרת, צריך להסיר את הקטע הזה או להשאיר אותו מסומן כהערה.

אם אתם יוצרים את האשכול כשהערך של enableAdvancedCluster מוגדר כ-true (נדרש כדי להגדיר דומיינים של טופולוגיה), הסירו את הקטע הזה. התכונה הזו לא נתמכת באשכולות מתקדמים.

`secretsEncryption.mode`

נדרש להצפנת סודות
לא ניתן לשינוי
מחרוזת
ערך אפשרי: "GeneratedKey"
מאוכלס מראש: "GeneratedKey"

מצב ההצפנה "סודי".

secretsEncryption:
  mode: "GeneratedKey"

`secretsEncryption.generatedKey.keyVersion`

נדרש להצפנת סודות
ניתן לשינוי
מספר שלם
מאוכלס מראש: 1

מספר שלם לבחירתכם שישמש כמספר גרסת המפתח. מומלץ להתחיל עם 1.

למידע על עדכון השדה הזה באשכול קיים, ראו הצפנה תמידית של סודות.

דוגמה:

secretsEncryption:
  generatedKey:
    keyVersion: 1

`secretsEncryption.generatedKey.disabled`

ניתן לשינוי
ערך בוליאני
מאוכלס מראש: false

כדי להשבית את ההצפנה של Secrets, צריך להגדיר את הערך true. אחרת, מגדירים אותו לערך false.

למידע על עדכון השדה הזה באשכול קיים, ראו הצפנה תמידית של סודות.

דוגמה:

secretsEncryption:
  generatedKey:
    disabled: false

קובץ תצורה של אשכול משתמש בגרסה 1.30 ואילך קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

יצירת תבנית לקובץ התצורה

שדות חובה וערכי ברירת מחדל

מילוי קובץ התצורה

enableAdvancedCluster

‫1.33 ומעלה

1.32

1.31

‫1.30 ומטה

name

gkeOnPremVersion

preparedSecrets.namespace

enableControlplaneV2

‫1.30 ומעלה

‫1.29 ומטה

vCenter

vCenter.address

vCenter.datacenter

vCenter.cluster

vCenter.resourcePool

vCenter.datastore

vCenter.storagePolicyName

vCenter.caCertPath

vCenter.credentials.fileRef.path

vCenter.credentials.fileRef.entry

vCenter.credentials.secretRef.version

vCenter.folder

componentAccessServiceAccountKeyPath

componentAccessServiceAccountKey.secretRef.version

privateRegistry

privateRegistry.address

privateRegistry.credentials.fileRef.path

privateRegistry.credentials.fileRef.entry

privateRegistry.credentials.secretRef.version

privateRegistry.caCertPath

network

network.hostConfig

‫1.30 ומעלה

‫1.29 ומטה

network.hostConfig.dnsServers

network.hostConfig.ntpServers

network.hostConfig.searchDomainsForDNS

network.ipMode.type

network.ipMode.ipBlockFilePath

network.serviceCIDR

network.podCIDR

network.vCenter.networkName

network.additionalNodeInterfaces

network.additionalNodeInterfaces[i].networkName

network.additionalNodeInterfaces[i].type

network.additionalNodeInterfaces[i].ipBlockFilePath

network.controlPlaneIPBlock

network.controlPlaneIPBlock.netmask

network.controlPlaneIPBlock.gateway

network.controlPlaneIPBlock.ips

loadBalancer

loadBalancer.vips.controlPlaneVIP

loadBalancer.vips.ingressVIP

loadBalancer.kind

‫1.32 ומעלה

1.31

1.30

‫1.29 וגרסאות קודמות

loadBalancer.manualLB

loadBalancer.manualLB.ingressHTTPNodePort

loadBalancer.manualLB.ingressHTTPSNodePort

loadBalancer.manualLB.controlPlaneNodePort

loadBalancer.manualLB.konnectivityServerNodePort

loadBalancer.f5BigIP

‫1.30 ומעלה

‫1.29 ומטה

loadBalancer.f5BigIP.address

‫1.30 ומעלה

‫1.29 ומטה

loadBalancer.f5BigIP.credentials.fileRef.path

‫1.30 ומעלה

‫1.29 ומטה

loadBalancer.f5BigIP.credentials.fileRef.entry

‫1.30 ומעלה

‫1.29 ומטה

קובץ תצורה של אשכול משתמש בגרסה 1.30 ואילך

`enableAdvancedCluster`

`name`

`gkeOnPremVersion`

`preparedSecrets.namespace`

`enableControlplaneV2`

`vCenter`

`vCenter.address`

`vCenter.datacenter`

`vCenter.cluster`

`vCenter.resourcePool`

`vCenter.datastore`

`vCenter.storagePolicyName`

`vCenter.caCertPath`

`vCenter.credentials.fileRef.path`

`vCenter.credentials.fileRef.entry`

`vCenter.credentials.secretRef.version`

`vCenter.folder`

`componentAccessServiceAccountKeyPath`

`componentAccessServiceAccountKey.secretRef.version`

`privateRegistry`

`privateRegistry.address`

`privateRegistry.credentials.fileRef.path`

`privateRegistry.credentials.fileRef.entry`

`privateRegistry.credentials.secretRef.version`

`privateRegistry.caCertPath`

`network`

`network.hostConfig`

`network.hostConfig.dnsServers`

`network.hostConfig.ntpServers`

`network.hostConfig.searchDomainsForDNS`

`network.ipMode.type`

`network.ipMode.ipBlockFilePath`

`network.serviceCIDR`

`network.podCIDR`

`network.vCenter.networkName`

`network.additionalNodeInterfaces`

`network.additionalNodeInterfaces[i].networkName`

`network.additionalNodeInterfaces[i].type`

`network.additionalNodeInterfaces[i].ipBlockFilePath`

`network.controlPlaneIPBlock`

`network.controlPlaneIPBlock.netmask`

`network.controlPlaneIPBlock.gateway`

`network.controlPlaneIPBlock.ips`

`loadBalancer`

`loadBalancer.vips.controlPlaneVIP`

`loadBalancer.vips.ingressVIP`

`loadBalancer.kind`

`loadBalancer.manualLB`

`loadBalancer.manualLB.ingressHTTPNodePort`

`loadBalancer.manualLB.ingressHTTPSNodePort`

`loadBalancer.manualLB.controlPlaneNodePort`

`loadBalancer.manualLB.konnectivityServerNodePort`

`loadBalancer.f5BigIP`

`loadBalancer.f5BigIP.address`

`loadBalancer.f5BigIP.credentials.fileRef.path`

`loadBalancer.f5BigIP.credentials.fileRef.entry`

`loadBalancer.f5BigIP.partition`

`loadBalancer.f5BigIP.snatPoolName`

`loadBalancer.seesaw`

`loadBalancer.seesaw.ipBlockFilePath`

`loadBalancer.seesaw.vrid`

`loadBalancer.seesaw.masterIP`

`loadBalancer.seesaw.cpus`

`loadBalancer.seesaw.memoryMB`

`loadBalancer.seesaw.vCenter.networkName`

`loadBalancer.seesaw.enableHA`

`loadBalancer.seesaw.disableVRRPMAC`

`loadBalancer.metalLB`

`loadBalancer.metalLB.addressPools`

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

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

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

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

`enableDataplaneV2`

`dataplaneV2.forwardMode`

`multipleNetworkInterfaces`

`advancedNetworking`

`disableBundledIngress`

`storage.vSphereCSIDisabled`