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

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

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

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

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

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

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

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

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

• ‫VERSION: מספר הגרסה של Google Distributed Cloud. לדוגמה: gkectl create-config admin --gke-on-prem-version=1.36.200-gke.118. הגרסה הזו חייבת להיות זהה לגרסה של gkectl או ישנה יותר. אם לא תציינו את הדגל הזה, תבנית ההגדרות שנוצרה תאוכלס בערכים שמבוססים על התיקון האחרון של גרסה 1.36.

תבנית

כדי לראות את התבנית שנוצרה לגרסה 1.36, צריך ללחוץ.

apiVersion: v1
kind: AdminCluster
# (Optional) A unique name for this admin cluster. This will default to a random name
# prefixed with 'gke-admin-'
name: ""
# (Required) Absolute path to a GKE bundle on disk
bundlePath: ""
# (Optional) Enable advanced cluster options
enableAdvancedCluster: true
# # (Optional/Preview) The absolute or relative path to the yaml file to use for topology
# # domains. Require advanced cluster is enabled
# infraConfigFilePath: ""
# # (Optional/Preview) Specify the prepared secret configuration which can be added
# # or edited only during cluster creation
# preparedSecrets:
#   # enable prepared credentials for the admin cluster; it is immutable
#   enabled: false
# (Required) vCenter configuration
vCenter:
  address: ""
  datacenter: ""
  cluster: ""
  # Resource pool to use. Specify [VSPHERE_CLUSTER_NAME]/Resources to use the default
  # resource pool
  resourcePool: ""
  # 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) vSphere folder where cluster VMs will be located. Defaults to the
  # datacenter wide folder if unspecified.
  folder: ""
  # # (Only used in 1.16 and older versions for non-HA admin cluster) Provide the name
  # # for the persistent disk to be used by the deployment (ending in .vmdk). Any directory
  # # in the supplied path must be created before deployment. Required for non-HA admin
  # # cluster. Invalid for HA admin cluster as the path is generated automatically under
  # # the root directory "anthos" in the specified datastore.
  # dataDisk: ""
# (Required) Network configuration
network:
  # (Required when using "static" ipMode.type; or "Seesaw" loadBalancer.kind; or using
  # amdin cluster HA mode) This section overrides ipMode.ipBlockFilePath values when
  # ipMode.type=static. It's also used for seesaw nodes
  hostConfig:
    # List of DNS servers
    dnsServers:
    - ""
    # List of NTP servers
    ntpServers:
    - ""
    # # List of DNS search domains
    # searchDomainsForDNS:
    # - ""
  ipMode:
    # (Required) Define what IP mode to use ("dhcp" or "static")
    type: 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.232.0/24
  # (Required) The Kubernetes pod CIDR range for the cluster. Must not overlap with
  # the service CIDR range
  podCIDR: 192.168.0.0/16
  vCenter:
    # vSphere network name
    networkName: ""
  # (Required for HA admin cluster) Specify the IPs to use for control plane machines
  # for HA admin cluster.
  controlPlaneIPBlock:
    netmask: ""
    gateway: ""
    ips:
    - ip: ""
      hostname: ""
    - ip: ""
      hostname: ""
    - ip: ""
      hostname: ""
# (Required) Load balancer configuration
loadBalancer:
  # (Required) The VIPs to use for load balancing
  vips:
    # Used to connect to the Kubernetes API
    controlPlaneVIP: ""
  # (Required) Which load balancer to use "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: 0
  #   # NodePort for ingress service's https (only needed for user cluster)
  #   ingressHTTPSNodePort: 0
  #   # NodePort for konnectivity server service (only needed for controlplane v1 user
  #   # cluster)
  #   konnectivityServerNodePort: 0
  #   # NodePort for control plane service (not needed for HA admin cluster or controlplane
  #   # V2 user cluster)
  #   controlPlaneNodePort: 30968
# Spread admin addon nodes and user masters across different physical hosts (requires
# at least three hosts)
antiAffinityGroups:
  # Set to false to disable DRS rule creation
  enabled: true
# Specify the admin master node configuration (default: 4 CPUs; 16384 MB memory; 3
# replicas). The replicas field has to be 3 for new admin cluster creation
adminMaster:
  cpus: 4
  memoryMB: 16384
  # How many machines of this type to deploy
  replicas: 3
  # # (Optional/Preview) Topology domains that admin 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:
  # - ""
  # # (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: ""
# # (Only used in 1.16 and older versions) Specify the addon node configuration which
# # can be added or edited only during cluster creation
# addonNode:
#   # Enable auto resize for addon node
#   autoResize:
#     # Whether to enable auto resize for master. Defaults to false.
#     enabled: false
# (Optional) Specify the proxy configuration
proxy:
  # The URL of the proxy
  url: ""
  # The domains and IP addresses excluded from proxying
  noProxy: ""
# # (Optional) Use a private registry to host GKE images
# privateRegistry:
#   # Do not include the scheme with your registry address
#   address: ""
#   credentials:
#     # reference to external credentials file
#     fileRef:
#       # read credentials from this file
#       path: ""
#       # entry in the credential file
#       entry: ""
#   # The absolute or relative path to the CA certificate for this registry
#   caCertPath: ""
# (Required): The absolute or relative path to the GCP service account key for pulling
# GKE images
componentAccessServiceAccountKeyPath: ""
# (Required) Specify which GCP project to register your GKE OnPrem cluster to
gkeConnect:
  projectID: ""
  # # (Optional) The location of the GKE Hub and Connect service where the cluster is
  # # registered to. It can be any GCP region or "global". Default to "global" when unspecified.
  # location: us-central1
  # The absolute or relative path to the key file for a GCP service account used to
  # register the cluster
  registerServiceAccountKeyPath: ""
# # (Optional) Specify if you wish to explicitly enable/disable the cloud hosted gkeonprem
# # API to enable/disable cluster lifecycle management from gcloud UI and Terraform.
# gkeOnPremAPI:
#   enabled: false
# (Required) Specify which GCP project to connect your logs and metrics to
stackdriver:
  # The project ID for logs and metrics. It should be the same with gkeconnect.projectID.
  projectID: ""
  # A GCP region where you would like to store logs and metrics for this cluster.
  clusterLocation: us-central1
  # The absolute or relative path to the key file for a GCP service account used to
  # send logs and metrics from the cluster
  serviceAccountKeyPath: ""
  # (Optional) Disable vsphere resource metrics collection from vcenter.  False by
  # default
  disableVsphereResourceMetrics: false
# (Optional) Configure kubernetes apiserver audit logging
cloudAuditLogging:
  # The project ID for logs and metrics. It should be the same with gkeconnect.projectID.
  projectID: ""
  # A GCP region where you would like to store audit logs for this cluster.
  clusterLocation: us-central1
  # The absolute or relative path to the key file for a GCP service account used to
  # send audit logs from the cluster
  serviceAccountKeyPath: ""
# # (Optional/Preview) Configure backups for admin cluster. Backups will be stored under
# # /anthos-backups/.
# clusterBackup:
#   # # datastore where admin cluster backups are desired
#   # datastore: ""
# Enable auto repair for the cluster
autoRepair:
  # Whether to enable auto repair feature. Set false to disable.
  enabled: true
# # Encrypt Kubernetes secrets at rest
# secretsEncryption:
#   # Secrets Encryption Mode. Possible values are: GeneratedKey
#   mode: GeneratedKey
#   # GeneratedKey Secrets Encryption config
#   generatedKey:
#     # # key version
#     # keyVersion: 1
#     # # disable secrets encryption
#     # disabled: false
# (Optional) Specify the type of OS image; available options can be set to "ubuntu_containerd"
# "cos" "ubuntu_cgv2" or "cos_cgv2". Default is "ubuntu_containerd".
osImageType: ubuntu_cgv2

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

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

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

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

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

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

enableAdvancedCluster

‫1.33 ומעלה

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

1.32

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

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

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

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

1.31

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

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

‫1.30 ומטה

לא זמין.

name

אופציונלי
מחרוזת
ברירת מחדל: שם אקראי שמתחיל בקידומת "gke-admin-‎"

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

דוגמה:

name: "my-admin-cluster"

bundlePath

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

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

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

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

דוגמה לחבילה מלאה:

bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.30.0-gke.1-full.tgz"

אם אתם מעדיפים להשתמש בחבילה רגילה (שמחייבת הורדת תמונות בזמן הריצה), צריך לציין את הנתיב שלה אחרי ההורדה:

דוגמה לחבילה רגילה:

bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.30.0-gke.1.tgz"

preparedSecrets.enabled

אם השדה infraConfigFilePath מוגדר, צריך להסיר אותו.

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

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

דוגמה:

preparedSecrets:
  enabled: true

vCenter

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

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

vCenter.address

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

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

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

דוגמאות:

vCenter:
  address: "203.0.113.100"

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

vCenter.datacenter

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

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

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

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

דוגמה:

vCenter:
  datacenter: "my-data-center"

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

דוגמה:

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

vCenter.cluster

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

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

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

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

דוגמה:

vCenter:
  cluster: "my-vsphere-cluster"

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

דוגמה:

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

vCenter.resourcePool

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

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

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

דוגמה:

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

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

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

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

דוגמה:

vCenter:
  resourcePool: "my-resource-pool"

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

דוגמה:

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

vCenter.datastore

חובה אם לא צוין vCenter.storagePolicyName
לא ניתן לשינוי
מחרוזת

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

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

דוגמה:

vCenter:
  datastore: "my-datastore"

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

vCenter.storagePolicyName

חובה אם לא צוין vCenter.datastore
לא ניתן לשינוי
מחרוזת

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

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

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

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

vCenter.caCertPath

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

הנתיב של אישור ה-CA לשרת vCenter.

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

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

דוגמה:

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

vCenter.credentials.fileRef.path

חובה
מחרוזת

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

אפשר להשתמש ב-gkectl update כדי לעדכן את השדה הזה באשכול קיים.

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

דוגמה:

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

vCenter.credentials.fileRef.entry

חובה
מחרוזת

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

אפשר להשתמש ב-gkectl update כדי לעדכן את השדה הזה באשכול קיים.

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

דוגמה:

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

vCenter.folder

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

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

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

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

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

דוגמה:

vCenter:
  folder: "my-folder"

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

דוגמה:

vCenter:
  folder: "folders/folder-1"

vCenter.dataDisk

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

network

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

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

network.hostConfig

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

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

network.hostConfig.dnsServers

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

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

דוגמה:

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

network.hostConfig.ntpServers

חובה אם הקטע network.hostConfig מולא.
לא ניתן לשינוי
מערך של מחרוזות

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

דוגמה:

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

ברוב המקרים צריך לציין את הערך static, כי תמיד צריך לספק כתובות IP לצומתי מישור הבקרה של אשכול האדמין. השימוש ב-DHCP הוא רק כדי לספק כתובות IP במקרים הבאים:

• אם enableControlplaneV2 לא מופעל באשכולות של משתמשים, אפשר להשתמש ב-DHCP לצומתי מישור הבקרה של אשכול המשתמשים, שנמצאים באשכול האדמין.

• בגרסה 1.16 ומטה, צומתי תוספים לאשכולות אדמין ללא זמינות גבוהה יכולים לקבל את כתובות ה-IP שלהם מ-DHCP. בגרסה 1.28 ואילך, אשכולות אדמין חייבים להיות HA, ואין להם צומתי תוספים.

דוגמה:

network:
  ipMode:
    type: "static"

network.ipMode.ipBlockFilePath

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

אם infraConfigFilePath מוגדר, השדה הזה נדרש.

השדה הזה נדרש גם במקרים הבאים:

• אשכול אדמין שאינו HA בגרסה 1.16 ומטה: מפרטים את כתובות ה-IP של צומת מישור הבקרה וצומתי התוספים בקובץ בלוק IP.

• אשכול אדמין HA בגרסה 1.16 ומטה: צריך לציין את כתובות ה-IP של צומתי התוספים בקובץ בלוק IP.

• אשכולות משתמשים בגרסה 1.29 ומטה של kubeception: מפרטים את כתובות ה-IP של הצמתים במישור הבקרה של אשכול המשתמשים בקובץ בלוק ה-IP של אשכול האדמין.

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

דוגמה:

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

network.serviceCIDR

חובה
לא ניתן לשינוי
מחרוזת
הטווח הקטן ביותר האפשרי: ‎/24
הטווח הגדול ביותר האפשרי: ‎/12
מאוכלס מראש: "10.96.232.0/24"

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

דוגמה:

network:
  serviceCIDR: "10.96.232.0/24"

network.podCIDR

חובה
לא ניתן לשינוי
מחרוזת
הטווח הקטן ביותר האפשרי: ‎/18
הטווח הגדול ביותר האפשרי: ‎/8
מאוכלס מראש: "192.168.0.0/16"

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

דוגמה:

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

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

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

דוגמה:

network:
  vCenter:
    networkName: "my-network"

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

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

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

דוגמה:

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

network.controlPlaneIPBlock

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

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

network.controlPlaneIPBlock.netmask

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

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

דוגמה:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

network.controlPlaneIPBlock.gateway

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

כתובת ה-IP של שער ברירת המחדל של צומתי מישור הבקרה.

דוגמה:

network:
  controlPlaneIPBlock:
    gateway: "172.16.22.1"

network.controlPlaneIPBlock.ips

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

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

דוגמה:

network:
  controlPlaneIPBlock:
    ips:
    - ip: "172.16.22.6"
      hostname: "admin-cp-vm-1"
    - ip: "172.16.22.7"
      hostname: "admin-cp-vm-2"
    - ip: "172.16.22.8"
      hostname: "admin-cp-vm-3"

infraConfigFilePath

1.31

ציון נתיב בשדה הזה מפעיל דומיינים של טופולוגיה.

תצוגה מקדימה
אופציונלי
מחרוזת
ניתן לשינוי

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

דוגמה:

infraConfigFilePath: "/my-config-folder/vsphere-infrastructure.yaml"

בנוסף להוספת הנתיב, מעתיקים את קובץ התצורה של תשתית vSphere לספרייה הרלוונטית.

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

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

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

  • ‫vCenter: מסירים את כל הקטע vCenter.
  • ‫network.hostConfig: מסירים את כל הקטע network.hostConfig.
  • ‫network.vCenter.networkName: צריך להסיר את השדה הזה.

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

  • ‫network.controlPlaneIPBlock: הסרת הקטע כולו. במקום זאת, צריך לציין את כתובות ה-IP של הצמתים במישור הבקרה של אשכול האדמין בקובץ בלוקים של כתובות IP.

  • ‫preparedSecrets: צריך להסיר את השדה הזה. אי אפשר להשתמש בפרטי כניסה מוכנים מראש כשדומיינים של טופולוגיה מופעלים. הסירו את השדה הזה.

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

  • ‫enableAdvancedCluster: מוגדר לערך true.

  • ‫network.ipMode.ipBlockFilePath: מוגדר לנתיב המלא או לנתיב היחסי של קובץ בלוק ה-IP של אשכול האדמין.

  • ‫loadBalancer.kind: מוגדר לערך "ManualLB". ‫"ManualLB" היא האפשרות היחידה לאיזון עומסים בכמה רשתות משנה (שכבה 3) שזמינה ב-Google Distributed Cloud.

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

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

  • ‫vCenter: מסירים את כל הקטע vCenter.
  • ‫network.hostConfig: מסירים את כל הקטע network.hostConfig.
  • ‫network.vCenter.networkName: צריך להסיר את השדה הזה.
  • ‫masterNode.vsphere: הסרת הקטע כולו.
  • ‫nodePools[i].vsphere.datastore ו-nodePools[i].vsphere.storagePolicyName: צריך להסיר את השדות האלה.

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

  • ‫network.controlPlaneIPBlock: הסרת הקטע כולו. במקום זאת, צריך לציין את כתובות ה-IP של הצמתים במישור הבקרה של אשכול האדמין בקובץ בלוקים של כתובות IP.

  • ‫preparedSecrets: צריך להסיר את השדה הזה. אי אפשר להשתמש בפרטי כניסה מוכנים מראש כשדומיינים של טופולוגיה מופעלים.

  • ‫nodePools[i].vsphere.hostgroups: צריך להסיר את השדה הזה. בגרסאות 1.32.200 ו-1.33 ואילך, משתמשים ב-topologyDomains[i].compute.hostGroups כדי להגדיר שיוך מארח של VM לכל דומיין טופולוגיה בקובץ התצורה של תשתית vSphere.

  • ‫multipleNetworkInterfaces: מגדירים את השדה הזה לערך false. כשמפעילים דומיינים של טופולוגיה, אין תמיכה בכמה ממשקי רשת לפודים.

  • ‫storage.vSphereCSIDisabled: מגדירים את השדה הזה לערך true כדי להשבית את הפריסה של רכיבי vSphere CSI

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

  • ‫enableAdvancedCluster: מוגדר לערך true בקובץ התצורה של אשכול המשתמשים.

  • ‫network.ipMode.ipBlockFilePath: הנתיב המלא או הנתיב היחסי של קובץ בלוק ה-IP של אשכול המשתמש.

  • ‫loadBalancer.kind: מוגדר לערך "ManualLB". ‫"ManualLB" היא האפשרות היחידה לאיזון עומסים בכמה רשתות משנה (שכבה 3) שזמינה ב-Google Distributed Cloud.

‫1.30 ומטה

לא זמין.

loadBalancer

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

loadBalancer.vips.controlPlaneVIP

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

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

דוגמה:

loadBalancer:
  vips:
    controlplaneVIP: "203.0.113.3"

loadBalancer.kind

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

‫1.32 ומעלה

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

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

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

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

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

דוגמה:

loadBalancer:
  kind: "MetalLB"

1.31

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

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

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

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

דוגמה:

loadBalancer:
  kind: "MetalLB"

1.30

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

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

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

• בגרסה 1.30 ואילך, אי אפשר להשתמש בערך "F5BigIP" באשכולות אדמין חדשים.

• בגרסה 1.28 ואילך, אי אפשר להשתמש בערך "Seesaw" באשכולות אדמין חדשים.

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

דוגמה:

loadBalancer:
  kind: "MetalLB"

‫1.29 ו-1.28

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

צריך להגדיר את זה בתור "ManualLB", "F5BigIP" או "MetalLB"

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

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

דוגמה:

loadBalancer:
  kind: "MetalLB"

‫1.16 ומטה

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

מחרוזת. צריך להגדיר את זה בתור "ManualLB",‏ "F5BigIP",‏ "Seesaw" או "MetalLB"

אם מגדירים את adminMaster.replicas ל-3, אי אפשר להשתמש במאזן העומסים של Seesaw.

דוגמה:

loadBalancer:
  kind: "MetalLB"

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

loadBalancer.manualLB

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

loadBalancer.manualLB.ingressHTTPNodePort

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

loadBalancer.manualLB.ingressHTTPSNodePort

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

loadBalancer.manualLB.konnectivityServerNodePort

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

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 ומעלה, מומלץ לעבור לאיזון עומסים ידני.

‫1.28 ומטה

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

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

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.

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

אפשר להשתמש ב-gkectl update כדי לעדכן את השדה הזה באשכול קיים.

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

דוגמה:

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

‫1.29 ומטה

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

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

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

אפשר להשתמש ב-gkectl update כדי לעדכן את השדה הזה באשכול קיים.

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

דוגמה:

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

loadBalancer.f5BigIP.credentialsfileRef.entry

‫1.30 ומעלה

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

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

אפשר להשתמש ב-gkectl update כדי לעדכן את השדה הזה באשכול קיים.

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

דוגמה:

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

‫1.29 ומטה

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

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

אפשר להשתמש ב-gkectl update כדי לעדכן את השדה הזה באשכול קיים.

למידע על עדכון פרטי הכניסה של 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-admin-partition"

‫1.29 ומטה

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

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

דוגמה:

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

loadBalancer.f5BigIP.snatPoolName

‫1.30 ומעלה

אסור באשכולות חדשים
אופציונלי
רלוונטי אם loadBalancer.kind = "F5BigIp"
לא ניתן לשינוי
מחרוזת

אם אתם משתמשים ב-SNAT, השם של מאגר ה-SNAT. אם אתם לא משתמשים ב-SNAT, הסירו את השדה הזה.

דוגמה:

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

‫1.29 ומטה

אופציונלי
רלוונטי אם loadBalancer.kind = "F5BigIp"
לא ניתן לשינוי
מחרוזת

אם אתם משתמשים ב-SNAT, השם של מאגר ה-SNAT. אם אתם לא משתמשים ב-SNAT, הסירו את השדה הזה.

דוגמה:

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

loadBalancer.seesaw

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

אנחנו עדיין תומכים ב-Seesaw באשכולות ניהול שאינם HA ששודרגו, אבל מומלץ לעבור ל-MetalLB.

antiAffinityGroups.enabled

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

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

אם השדה הזה הוא 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 זמינים. כך מישור הבקרה של אשכול האדמין לא יאבד. לדוגמה, נניח שיש לכם רק שלושה מארחי ESXi, והצומת של מישור הבקרה באשכול האדמין נמצא במארח ESXi שנכשל. כלל ה-DRS ימנע את הצבת הצומת של מישור הבקרה באחד משני מארחי ה-ESXi שנותרו.

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

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

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

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

• גרסה 1.32: תמיכה בכללי אנטי-אפיניות באשכולות מתקדמים.

דוגמה:

antiAffinityGroups:
  enabled: true

adminMaster

בלתי ניתנת לשינוי

הגדרות לצומתי מישור הבקרה באשכול האדמין.

adminMaster.controlPlaneLoadBalancer

‫1.32 ומעלה

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

adminMaster.controlPlaneLoadBalancer.mode

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

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

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

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

דוגמה:

adminMaster:
  controlPlaneLoadBalancer:
    mode: "manual"

‫1.31 ומטה

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

adminMaster.cpus

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

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

דוגמה:

adminMaster:
  cpus: 4

adminMaster.memoryMB

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

מספר המגה-בייטים (MiB) של הזיכרון לכל צומת במישור הבקרה באשכול האדמין.

דוגמה:

adminMaster:
  memoryMB: 16384

adminMaster.replicas

‫1.28 ומעלה

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

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

דוגמה:

adminMaster:
  replicas: 3

‫1.16 ומטה

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

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

אם מגדירים את השדה הזה כ-3, צריך למלא גם את הקטע network.controlPlaneIPBlock ואת הקטע network.hostConfig.

אם מגדירים את הערך 3, אי אפשר להשתמש במאזן העומסים של Seesaw.

דוגמה:

adminMaster:
  replicas: 3

adminMaster.topologyDomains

‫1.32 ומעלה

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

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

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

‫1.31 ומעלה

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

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

‫1.30 ומטה

לא זמין.

addonNode.autoResize.enabled

‫1.28 ומעלה

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

‫1.16 ומטה

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

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

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

דוגמה:

addonNode:
  autoResize:
    enabled: true

proxy

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

proxy.url

חובה אם הקטע proxy מולא.
Immutable
מחרוזת

כתובת ה-HTTP של שרת ה-proxy. צריך לכלול את מספר היציאה גם אם הוא זהה ליציאת ברירת המחדל של הסכימה.

דוגמה:

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

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

אם מציינים את proxy.url, צריך לציין גם את proxy.noProxy.

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

proxy.noProxy

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

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

דוגמה:

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

privateRegistry

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

אם מגדירים את הקטע privateRegistry, כשמריצים את gkectl prepare לפני יצירת האשכול או השדרוג, gkectl מעביר את קובצי האימג' של מערכת Google Distributed Cloud למרשם הפרטי. במהלך היצירה או השדרוג של האשכול, קובצי האימג' של המערכת נשלפים מהמרשם הפרטי. אם לא מגדירים את הקטע privateRegistry, קובצי האימג' של המערכת נשלפים מ-gcr.io/gke-on-prem-release באמצעות חשבון השירות לגישה לרכיבים.

במקרים הבאים, יכול להיות שתרצו להגדיר את הקטע privateRegistry כך שהאשכולות ישלפו תמונות מערכת מהמרשם הפרטי במקום מ-gcr.io/gke-on-prem-release:

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

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

privateRegistry.address

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

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

דוגמאות:

privateRegistry:
  address: "203.0.113.10"

privateRegistry:
  address: "fqdn.example.com"

privateRegistry.credentials.fileRef.path

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

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

דוגמה:

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

privateRegistry.credentials.fileRef.entry

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

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

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

privateRegistry.caCertPath

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

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

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

דוגמה:

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

componentAccessServiceAccountKeyPath

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

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

דוגמה:

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

gkeConnect

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

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

במהלך היצירה או העדכון של האשכול, מוגדרות כמה כללי מדיניות RBAC באשכול האדמין. מדיניות ה-RBAC הזו נדרשת כדי שתוכלו ליצור אשכולות משתמשים במסוף Google Cloud .

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 הגלובליים.

• באשכולות חדשים, אם אתם כוללים את השדה הזה, האזור שאתם מציינים חייב להיות זהה לאזור שהוגדר ב-cloudAuditLogging.clusterLocation, ב-stackdriver.clusterLocation וב-gkeOnPremAPI.location. אם האזורים לא זהים, יצירת האשכול תיכשל.

דוגמה:

gkeConnect:
  location: "us-central1"

gkeConnect.registerServiceAccountKeyPath

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

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

דוגמה:

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

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 – כדי לשדרג את אשכולות המשתמשים שאשכול האדמין מנהל. רישום האשכול גם מאפשר להריץ פקודות gcloud כדי לקבל מידע על האשכולות.

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

gkeOnPremAPI.enabled

חובה אם המקטע gkeOnPremAPI נכלל.
ניתן לשינוי
בוליאני
ברירת מחדל: true

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

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

gkeOnPremAPI:
  enabled: false

gkeOnPremAPI.location

לא ניתן לשינוי
מחרוזת
ברירת מחדל:stackdriver.clusterLocation

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

stackdriver

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

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 בקובץ התצורה, האזור שאתם מגדירים כאן חייב להיות אותו אזור שהגדרתם ב-cloudAuditLogging.clusterLocation, ב-gkeConnect.location וב-gkeOnPremAPI.location. אם האזורים לא זהים, יצירת האשכול תיכשל.

דוגמה:

stackdriver:
  clusterLocation: "us-central1"

stackdriver.serviceAccountKeyPath

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

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

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

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

דוגמה:

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

stackdriver.disableVsphereResourceMetrics

אופציונלי
ניתן לשינוי
רלוונטי ל-Logging ול-Monitoring
בוליאני
מאוכלס מראש: false
ברירת מחדל: false

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

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

דוגמה:

stackdriver:
  disableVsphereResourceMetrics: true

cloudAuditLogging

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

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

cloudAuditLogging.projectID

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

המזהה של הפרויקט המארח של הצי. באשכולות חדשים, מזהה הפרויקט הזה צריך להיות זהה למזהה שמוגדר ב-gkeConnect.projecID וב-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.

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

דוגמה:

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

clusterBackup.datastore

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

כברירת מחדל, קובצי tar של גיבוי האשכול נשמרים בספרייה gkectl-workspace/backups בתחנת העבודה של האדמין. אם רוצים לאחסן קובצי גיבוי של אשכולות ב-vSphere, צריך להגדיר בשדה הזה את מאגר הנתונים של vSphere שבו רוצים לשמור את הגיבויים.

דוגמה:

clusterBackup:
  datastore: "my-datastore"

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

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

  • גרסה 1.31: צריך להסיר את clusterBackup.datastore מקובץ התצורה. אי אפשר לגבות אשכולות למאגר נתונים של vSphere.

  • גרסה 1.32: clusterBackup.datastore נמצאת בגרסת טרום-השקה (Preview)

  • גרסה 1.33 ואילך: clusterBackup.datastore היא GA.

• באשכולות לא מתקדמים, clusterBackup.datastore נשאר בגרסת טרום-השקה (Preview).

מידע נוסף זמין במאמרים הבאים:

• אשכולות לא מתקדמים: גיבוי ושחזור של אשכול אדמין באמצעות gkectl

• אשכולות מתקדמים: גיבוי ושחזור של אשכולות מתקדמים באמצעות gkectl

autoRepair.enabled

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

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

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

דוגמה:

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

osImageType

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

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

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

• גרסה 1.31: אם השדה enableAdvancedCluster הוא true, רק ubuntu-cgroupv2 ו-ubuntu_containerd נתמכים באשכולות מתקדמים.

• גרסה 1.32: כל סוגי קובצי האימג' של מערכת ההפעלה נתמכים באשכולות מתקדמים.

הערה: בגרסאות 1.32 ומטה, חבילות מלאות לא כוללות קובצי אימג' של מערכת ההפעלה cgroup v2. אם מציינים את ubuntu_cgv2 או את cos_cgv2, צריך להשתמש בחבילה רגילה. פרטים נוספים זמינים במאמר מידע על חבילות של Google Distributed Cloud.

דוגמה:

osImageType: "cos_cgv2"