管理員叢集設定檔 1.30 以上版本

本文說明 1.30 以上版本 Google Distributed Cloud 的管理員叢集設定檔欄位。

產生設定檔範本

如果您使用 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 修補程式，在產生的設定範本中填入值。

範本

必填欄位和預設值

如果欄位標示為「Required」，則填妥的設定檔必須填入該欄位的值。

如果欄位有「Default」(預設) 值，且您未在欄位中輸入任何內容，叢集就會使用該值。您可以輸入值來覆寫預設值。

如果欄位未標示為「必填」，則為選填。您可以視需要填寫，但並非必要。

填寫設定檔

在設定檔中，按照下列各節所述輸入欄位值。

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，請移除這個欄位。

預先發布版
選用
不可變更
布林值
預先填入：false
預設：false

如要在管理員叢集中使用預先準備的憑證，請將這個值設為 true。否則，請將其設為 false 或省略該欄位。

範例：

preparedSecrets:
  enabled: true

vCenter

這個部分包含 vSphere 環境和 vCenter Server 連線的相關資訊。

如果已設定 infraConfigFilePath，請移除整個部分。否則，這個部分為必填且不可變更。

vCenter.address

必要
不可變動
字串

vCenter 伺服器的 IP 位址或主機名稱。

詳情請參閱「尋找 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 叢集的相對路徑，代表要執行管理員叢集 VM 的 ESXi 主機。這個 vSphere 叢集代表 vCenter 資料中心內的部分實體 ESXi 主機。

您指定的值是相對於 /.../DATA_CENTER/vm/。

如果 vSphere 叢集位於 /.../DATA_CENTER/vm/ 資料夾，則值為 vSphere 叢集的名稱。

範例：

vCenter:
  cluster: "my-vsphere-cluster"

否則，值會是相對路徑，包含一或多個資料夾以及 vSphere 叢集的名稱。

範例：

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

vCenter.resourcePool

必要
不可變動
字串

管理員叢集 VM 的 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，則為必要
不可變動
字串

叢集節點的 VM 儲存空間政策名稱。

管理員叢集必須具備高可用性 (HA)，才能與儲存空間政策搭配使用。

詳情請參閱「設定儲存空間政策」。

您必須指定 vCenter.datastore 或 vCenter.storagePolicyName 的值，但不能同時指定兩者。如果您為這個欄位指定值，請勿為 vCenter.datastore 指定值。

vCenter.caCertPath

必要
可變動
字串

vCenter Server CA 憑證的路徑。

詳情請參閱「取得 vCenter CA 憑證」。

如要瞭解如何更新現有叢集的這個欄位，請參閱「更新 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 資料夾。這個資料夾會存放管理員叢集 VM。

如未指定值，管理員叢集 VM 會放在 /.../DATA_CENTER/vm/。

如果指定值，則會相對於 /.../DATA_CENTER/vm/。

值可以是資料夾名稱。

範例：

vCenter:
  folder: "my-folder"

或者，值也可以是包含多個資料夾的相對路徑。

範例：

vCenter:
  folder: "folders/folder-1"

vCenter.dataDisk

請勿為這個欄位提供值。請刪除該欄位，或保留註解排除狀態。

network

必要
不可變更

這個部分包含管理員叢集網路的相關資訊。

network.hostConfig

這個部分包含 NTP 伺服器、DNS 伺服器和 DNS 搜尋網域的相關資訊，這些網域是由叢集節點 VM 使用。

如果已設定 infraConfigFilePath，請移除整個部分。否則，這個部分為必填且不可變更。

network.hostConfig.dnsServers

如果已填寫 network.hostConfig 區段，則為必填。
不可變動
字串陣列。
陣列中的元素數量上限為三個。

VM 的 DNS 伺服器位址。

範例：

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

network.hostConfig.ntpServers

如果已填寫 network.hostConfig 區段，則為必填。
不可變動
字串陣列

VM 要使用的時間伺服器位址。

範例：

network:
  hostConfig:
    ntpServers:
    - "216.239.35.0"

network.hostConfig.searchDomainsForDNS

選用
不可變動
字串陣列

供 VM 使用的 DNS 搜尋網域，可做為部分的網域搜尋清單。

範例：

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

network.ipMode.type

不可變更
字串
預先填入：「static」
預設值：「dhcp」

如要讓叢集節點從 DHCP 伺服器取得 IP 位址，請將這個值設為 "dhcp"。如要讓叢集節點從您提供的清單中選擇靜態 IP 位址，請將此值設為 "static"。

在大多數情況下，您應指定 static，因為您一律須提供管理員叢集控制層節點的 IP 位址。DHCP 僅用於在下列情況提供 IP 位址：

  • 如果使用者叢集未啟用 enableControlplaneV2，則可對使用者叢集的控制層節點 (位於管理員叢集) 使用 DHCP。

  • 在 1.16 以下版本中，非高可用性管理員叢集的附加元件節點可從 DHCP 取得 IP 位址。在 1.28 以上版本中，管理員叢集必須具備高可用性，且沒有外掛程式節點。

範例：

network:
  ipMode:
    type: "static"

network.ipMode.ipBlockFilePath

叢集 IP 區塊檔案的絕對或相對路徑。

如果已設定 infraConfigFilePath，則必須填寫這個欄位。

在下列情況下，也必須提供這個欄位：

  • 1.16 以下非高可用性管理員叢集：在 IP 區塊檔案中，列出控制層節點和外掛程式節點的 IP 位址。

  • 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」

叢集內 Service 使用的 IP 位址範圍，格式為 CIDR。

範例：

network:
  serviceCIDR: "10.96.232.0/24"

network.podCIDR

必填
不可變更
字串
最小可能範圍：/18
最大可能範圍：/8
預先填入：「192.168.0.0/16」

叢集內 Pod 使用的 IP 位址範圍，格式為 CIDR。

範例：

network:
  podCIDR: "192.168.0.0/16"

Service 範圍不得與 Pod 範圍重疊。

Service 和 Pod 範圍不得與您要從叢集內部連線的任何外部位址重疊。

舉例來說，假設 Service 範圍是 10.96.232.0/24，Pod 範圍是 192.168.0.0/16。從 Pod 傳送至任一範圍內位址的流量，都會視為叢集內流量，不會傳送至叢集外的任何目的地。

具體來說，Service 和 Pod 範圍不得與下列項目重疊：

  • 任何叢集內節點的 IP 位址

  • 負載平衡器機器使用的 IP 位址

  • 控制層節點和負載平衡器使用的 VIP

  • vCenter 伺服器、DNS 伺服器和 NTP 伺服器的 IP 位址

建議您將 Service 和 Pod 範圍設在 RFC 1918 位址空間中。

這就是建議使用 RFC 1918 位址的原因之一。假設 Pod 或 Service 範圍包含外部 IP 位址。從 Pod 傳送至這些外部位址的任何流量，都會視為叢集內流量，不會到達外部目的地。

network.vCenter.networkName

叢集節點的 vSphere 網路名稱。

如果已設定 infraConfigFilePath，請移除這個欄位。否則，這個欄位為必填且不可變更。

範例：

network:
  vCenter:
    networkName: "my-network"

如果名稱包含特殊字元，則必須使用逸出序列。

特殊字元 逸出序列
斜線 (/) %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：移除這個欄位。啟用拓撲網域時，不支援預先準備的憑證。移除這個欄位。

  • 必填欄位包括：

使用者叢集設定檔變更

  • 從使用者叢集設定檔中移除下列內容。您可以在 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，為 vSphere 基礎架構設定檔中的每個拓撲網域設定 VM 主機親和性。

    • multipleNetworkInterfaces：將這個欄位設為 false。啟用拓撲網域時，Pod 不支援多個網路介面。

    • storage.vSphereCSIDisabled：將這個欄位設為 true，即可停用 vSphere CSI 元件的部署作業

  • 必填欄位包括：

1.30 以下版本

不適用。

loadBalancer

這個部分包含管理員叢集的負載平衡器資訊。

loadBalancer.vips.controlPlaneVIP

必要
不可變動
字串

您選擇在負載平衡器上設定的 IP 位址，用於管理員叢集的 Kubernetes API 伺服器。

範例：

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 控制台、gcloud CLI 或 Terraform 建立使用者叢集時，管理員叢集及其使用者叢集的負載平衡器類型必須相同。唯一的例外狀況是，如果管理員叢集使用 Seesaw，則使用者叢集可以使用 MetalLB。如要讓管理員和使用者叢集使用不同類型的負載平衡器，則必須使用 gkectl 指令列工具建立使用者叢集。

loadBalancer.manualLB

如果將 loadbalancer.kind 設為 "ManualLB"，請填寫這個部分。否則，請移除這個部分。
不可變

loadBalancer.manualLB.ingressHTTPNodePort

請從設定檔中移除這個欄位。不會用於管理員叢集。

loadBalancer.manualLB.ingressHTTPSNodePort

請從設定檔中移除這個欄位。不會用於管理員叢集。

loadBalancer.manualLB.konnectivityServerNodePort

請從設定檔中移除這個欄位。不會用於管理員叢集。

loadBalancer.f5BigIP

1.30 以上

在 1.30 以上版本中，新管理員叢集的 loadbalancer.kind 不得使用 "F5BigIP" 值。如果設定檔中有 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

請勿使用這個部分。1.28 以上版本的新管理員叢集不支援 Seesaw 負載平衡器。建議您改為設定 MetalLB 負載平衡器，用於新的管理員叢集。如要進一步瞭解如何設定 MetalLB，請參閱「使用 MetalLB 隨附的負載平衡功能」。

雖然我們仍支援已升級的非高可用性管理員叢集使用 Seesaw，但建議您遷移至 MetalLB。

antiAffinityGroups.enabled

選用
可變動
布林值
預先填入：true

將這個值設為 true，即可建立 DRS 規則。否則，請將此值設為 false。

如果這個欄位為 true，Google Distributed Cloud 會為管理員叢集節點建立 VMware Distributed Resource Scheduler (DRS) 反相依性規則，使其分散於資料中心內至少三個實體 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 VM 的主機，請將 antiAffinityGroups.enabled 設為 false。

請注意下列進階叢集限制：

  • 1.31 版：如果 enableAdvancedCluster 欄位為 true，則進階叢集不支援反親和性規則，且您必須將 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

預覽
選用
不可變更
整數
預先填入：4
預設：4

管理員叢集中每個控制層節點的 vCPU 數量。

範例：

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 以上

僅適用於新叢集
預先發布版
字串陣列 | 僅允許一個元素
選用
不可變更
預設值：vSphereInfraConfig.defaultTopologyDomain (如果在 vSphere 基礎架構設定檔中指定)

拓撲網域陣列。如果已設定 infraConfigFilePath (表示叢集將使用拓撲網域)，則可選擇加入這個欄位。管理員叢集控制層節點會部署在指定的拓撲網域中。

1.30 以下版本

不適用。

addonNode.autoResize.enabled

1.28 以上

建立新叢集時，請勿在設定檔中加入這項設定。在 1.28 以上版本建立的管理員叢集必須具備高可用性 (HA)，並有三個控制層節點。在 1.28 以上版本中，高可用性管理員叢集沒有外掛程式節點。

1.16 以下版本

選用
可變動
布林值
預先填入：false
預設：false

將這個值設為 true，即可啟用管理員叢集中外掛程式節點的自動調整大小功能。否則請設為 false。

如要更新這個欄位的值，請使用 gkectl update admin。

範例：

addonNode:
  autoResize:
    enabled: true

proxy

如果網路位於 Proxy 伺服器後方，請填寫這個部分。否則，請移除這個部分或將其註解排除。您在此指定的 Proxy 伺服器，會由這個管理員叢集管理的使用者叢集使用。
不可變動

proxy.url

如果已填寫 proxy 區段，則為必填。
不可變動
字串

Proxy 伺服器的 HTTP 位址。即使通訊埠編號與配置的預設通訊埠相同，也請一併加入。

範例：

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

您在此指定的 Proxy 伺服器會由 Google Distributed Cloud 叢集使用。此外，除非您在管理員工作站上設定 HTTPS_PROXY 環境變數，否則管理員工作站會自動設定為使用這個 Proxy 伺服器。

如果指定 proxy.url，也必須指定 proxy.noProxy。

設定管理員叢集的 Proxy 設定後，除非重建叢集，否則無法修改或刪除。

proxy.noProxy

選用
不可變動
字串

以逗號分隔的清單，列出不應透過 Proxy 伺服器的 IP 位址、IP 位址範圍、主機名稱和網域名稱。當 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 的網路速度緩慢。

如要將 Google 的 Artifact Registry 做為私人登錄檔，請參閱「將 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) 簽署。容器執行階段會使用 CA 的憑證來驗證登錄檔的憑證。

將這個欄位設為 CA 憑證的路徑。

範例：

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

componentAccessServiceAccountKeyPath

必要
可變動
字串

元件存取服務帳戶的 JSON 金鑰檔案路徑。

範例：

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

gkeConnect

必要
可變動

填寫 gkeConnect 區段後，管理員叢集建立後會自動註冊至機群。這個部分包含註冊叢集所需的 Google Cloud 專案和服務帳戶資訊。

建立或更新叢集時，系統會在管理員叢集上設定多項 RBAC 政策。您必須具備這些 RBAC 政策，才能在 Google Cloud 控制台中建立使用者叢集。

gkeConnect.projectID

必要
不可變動
字串

機群主專案的 ID。如果是新叢集，這個專案 ID 必須與 stackdriver.projectID 和 cloudAuditLogging.projectID 中設定的 ID 相同。如果專案 ID 不同，叢集建立作業就會失敗。這項規定不適用於現有叢集。

範例：

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

gkeConnect.location

選用
不可變動
字串
預設值：global

每個叢集的機群成員資格都由機群服務 (gkehub.googleapis.com) 和 Connect 服務 (gkeconnect.googleapis.com) 管理。服務的位置可以是全域或區域。在 1.28 以上版本中，您可以視需要指定 Google Cloud 機群和 Connect 服務執行的區域。如未指定，則會使用服務的全域執行個體。注意事項：

  • 1.28 版之前建立的管理員叢集，是由全域機群和 Connect 服務管理。

  • 如果是新叢集，當您加入這個欄位時，指定的區域必須與 cloudAuditLogging.clusterLocation、stackdriver.clusterLocation 和 gkeOnPremAPI.location 中設定的區域相同。如果區域不同，叢集建立作業就會失敗。

範例：

gkeConnect:
  location: "us-central1"

gkeConnect.registerServiceAccountKeyPath

必要
可變動
字串

connect-register 服務帳戶的 JSON 金鑰檔案路徑。

範例：

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

gkeOnPremAPI

選填

在 1.16 以上版本中，如果Google Cloud 專案已啟用 GKE On-Prem API，專案中的所有叢集都會在stackdriver.clusterLocation設定的區域中，自動註冊 GKE On-Prem API。

  • 如要將專案中的所有叢集註冊到 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，叢集預設會註冊至 GKE On-Prem API。如果不想註冊叢集，請設為 false。

叢集註冊 GKE On-Prem API 後，如需取消註冊，請進行下列變更，然後更新叢集：

gkeOnPremAPI:
  enabled: false

gkeOnPremAPI.location

不可變動
字串
預設：stackdriver.clusterLocation

GKE On-Prem API 執行及儲存叢集中繼資料的 Google Cloud 區域。選擇其中一個支援的地區。您必須使用 cloudAuditLogging.clusterLocation、gkeConnect.location 和 stackdriver.clusterLocation 中設定的相同區域。如果 gkeOnPremAPI.enabled 為 false，請勿加入這個欄位。

stackdriver

必要
可變動

stackdriver.projectID

記錄和監控功能必要
不可變動
字串

機群主專案的 ID。如果是新叢集，這個專案 ID 必須與 gkeConnect.projectID 和 cloudAuditLogging.projectID 中設定的 ID 相同。如果專案 ID 不同，叢集建立作業就會失敗。這項規定不適用於現有叢集。

如有需要，您可以在這項專案中設定記錄檔路由器，將記錄檔轉送至其他專案的記錄檔 bucket。如要瞭解如何設定記錄路由器，請參閱「支援的目的地」。

範例：

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

stackdriver.clusterLocation

記錄和監控功能必填
不可變動
字串
預先填入：「us-central1」

要轉送及儲存 Cloud Monitoring 指標的 Google Cloud 區域。建議您選擇靠近地端部署資料中心的區域。

您可以在記錄檔路由器設定中，指定 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

將這個屬性設為 true，即可停用 vSphere 指標收集功能。否則請設為 false。

如要在 Google Cloud 控制台管理使用者叢集的生命週期，管理員叢集必須包含這個區段。

範例：

stackdriver:
  disableVsphereResourceMetrics: true

cloudAuditLogging

如要將叢集 Kubernetes API 伺服器的稽核記錄與 Cloud 稽核記錄整合，請填寫這個部分。否則，請移除這個部分或將其註解排除。
Mutable

如要使用 GKE On-Prem API 用戶端管理使用者叢集的生命週期，則必須在管理員叢集中加入這個區段。

cloudAuditLogging.projectID

Cloud 稽核記錄必要
不可變動
字串

機群主專案的 ID。如果是新叢集，這個專案 ID 必須與 gkeConnect.projecID 和 stackdriver.projectID 中設定的 ID 相同。如果專案 ID 不同，叢集建立作業就會失敗。這項規定不適用於現有叢集。

如有需要，您可以在這項專案中設定記錄檔路由器，將記錄檔轉送至其他專案的記錄檔 bucket。如要瞭解如何設定記錄路由器，請參閱「支援的目的地」。

範例：

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 為預先發布版

    • 1.33 以上版本：clusterBackup.datastore 已正式發布。

  • 非進階叢集的 clusterBackup.datastore 仍處於預先發布版階段。

詳情請參閱下列資源：

autoRepair.enabled

選用
可變動
布林值
預先填入：true

將此值設為 true，即可啟用節點自動修復功能。否則，請將此值設為 false。

如要更新這個欄位的值，請使用 gkectl update admin。

範例：

autoRepair:
  enabled: true

secretsEncryption

如要加密 Secret，但不需要外部 KMS (金鑰管理服務) 或任何其他依附元件，請填寫這個部分。否則，請移除這個部分或保留註解排除。
不可變動

如果您要建立叢集，並將 enableAdvancedCluster 設為 true (設定拓撲網域時必須這麼做)，請移除這個部分。進階叢集不支援這項功能。

secretsEncryption.mode

加密 Secret 時必須提供
不可變動
字串
可能的值：「GeneratedKey」
預先填入：「GeneratedKey」

Secret 加密模式。

secretsEncryption:
  mode: "GeneratedKey"

secretsEncryption.generatedKey.keyVersion

Secret 加密功能必要
可變動
整數
預先填入：1

選擇要用於金鑰版本號碼的整數。建議您從 1 開始。

範例：

secretsEncryption:
  generatedKey:
    keyVersion: 1

secretsEncryption.generatedKey.disabled

選用 (用於 Secret 加密)
可變動
布林值
預先填入：false

將這個值設為 true，即可停用 Secret 加密功能。否則請設為 false。

範例：

secretsEncryption:
  generatedKey:
    disabled: false

osImageType

選用
可變動
字串
可能的值：1.34 以下版本：「ubuntu_containerd」、「cos」
1.35 以上版本：「ubuntu_cgv2」、「cos_cgv2」
預先填入：「ubuntu_cgv2」
預設值：「ubuntu_containerd」

要在管理員叢集節點執行的 OS 映像檔類型。

請注意下列進階叢集限制：

  • 1.31 版：如果 enableAdvancedCluster 欄位為 true，則進階叢集僅支援 ubuntu-cgroupv2 和 ubuntu_containerd。

  • 1.32 版：進階叢集支援所有 OS 映像檔類型。

注意：在 1.32 以下版本中，完整套件不含 cgroup v2 OS 映像檔。如果指定 ubuntu_cgv2 或 cos_cgv2，則必須使用一般套件。詳情請參閱「關於 Google Distributed Cloud 套件」。

範例：

osImageType: "cos_cgv2"