cluster.gdc.goog/v1
包含叢集群組的 API 結構定義。
AcceleratorConfig
顯示位置： - NodePool
| 欄位 | 說明 |
|---|---|
gpuPartitionScheme 字串 |
GPUPartitionScheme 表示將 GPU 分割為 MIG 的方案。這個配置和 GPU 裝置型號會共同決定 MIG 設定檔。舉例來說，H100L 94GB 上的 mixed-1 會將 GPU 分割為一個 4g.47gb 和一個 3g.47gb。 |
管道
基礎類型： string
指出特定類型的發布管道。
出現於： - ReleaseChannel
叢集
在無網路連線的設定中指定 GDC 使用者叢集。
顯示位置： - ClusterList
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
cluster.gdc.goog/v1 |
kind 字串 |
Cluster |
metadata ObjectMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
spec ClusterSpec |
|
status ClusterStatus |
ClusterList
代表叢集集合。
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
cluster.gdc.goog/v1 |
kind 字串 |
ClusterList |
metadata ListMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
items 叢集陣列 |
ClusterNetwork
指定叢集網路設定。
出現位置： - ClusterSpec
| 欄位 | 說明 |
|---|---|
podCIDRSize 整數 |
分配 Pod 虛擬 IP 位址的網路範圍大小。如未設定，系統會使用預設值 21。 |
serviceCIDRSize 整數 |
服務虛擬 IP 位址的分配網路範圍大小。如未設定，系統會使用預設值 23。 |
ClusterSpec
顯示位置： - 叢集
| 欄位 | 說明 |
|---|---|
initialVersion ClusterVersion |
使用者叢集在建立時的 GDC 氣隙版本資訊。(選用步驟) 預設使用最新適用版本。不可變更。 |
releaseChannel ReleaseChannel |
叢集訂閱的發布版本。叢集訂閱發布版本後，GDC 會為使用者維護叢集版本。(選用步驟) 可變動。 |
clusterNetwork ClusterNetwork |
叢集網路設定。如未設定，系統會使用預設設定，包括 Pod 和服務 CIDR 大小。(選用步驟) 可變動。 |
loadBalancer LoadBalancer |
負載平衡器設定。如未設定，系統會使用預設設定，並採用 Ingress 服務 IP 位址大小。(選用步驟) 可變動。 |
nodePools NodePool 陣列 |
叢集工作站節點的節點集區清單。(選用步驟) 可變動。 |
nodePoolDefaults NodePoolDefaults |
所有節點集區的叢集層級設定。(選用步驟) 可變動。 |
ClusterState
基礎類型： string
指出叢集的狀態。
顯示於： - ClusterStatus
ClusterStatus
定義叢集的觀察狀態。
顯示位置： - 叢集
| 欄位 | 說明 |
|---|---|
conditions Condition 陣列 |
叢集狀態的最新觀察結果。Reconciling 和 Stalled 等條件會指出上次叢集協調是否成功。 |
errorStatus ErrorStatus |
叢集的觀察錯誤狀態。 |
workerNodePoolStatuses NodePoolStatus 陣列 |
觀察到的工作站節點集區狀態清單。 |
controlPlaneConditions Condition 陣列 |
控制層是否已準備就緒。 |
componentsConditions Condition 陣列 |
使用者叢集元件是否已成功部署。 |
versionStatus VersionStatus |
叢集的已安裝版本資訊。 |
clusterState ClusterState |
叢集狀態。可用的州別如下：
|
ClusterVersion
指定無氣隙設定中 GDC 使用者叢集的版本資訊。
出現位置： - ClusterSpec
| 欄位 | 說明 |
|---|---|
kubernetesVersion 字串 |
GDC 使用者叢集的 Kubernetes 版本。 |
ContainerdConfig
出現位置： - NodeConfigDefaults
| 欄位 | 說明 |
|---|---|
privateRegistries PrivateRegistry 陣列 |
指定用於在節點上提取映像檔的私人登錄檔。系統僅支援 containerd 容器執行階段。 |
LoadBalancer
指定負載平衡器設定。
出現位置： - ClusterSpec
| 欄位 | 說明 |
|---|---|
ingressServiceIPSize 整數 |
負載平衡器型服務使用的非重疊 IP 集區大小。如未設定，系統會使用預設值 20。 |
NodeConfigDefaults
顯示於： - NodePoolDefaults
| 欄位 | 說明 |
|---|---|
containerdConfig ContainerdConfig |
指定所有節點的 containerd 設定。(選用步驟) 可變動。 |
NodePool
指定 NodePool 自訂資源設定。
出現位置： - ClusterSpec
| 欄位 | 說明 |
|---|---|
name 字串 |
節點集區的名稱。 |
nodeCount 整數 |
已佈建節點集區中所需的節點數量。 |
machineTypeName 字串 |
用於佈建節點的機器類型名稱。 |
taints Taint 陣列 |
指派給這個節點集區節點的污點。 |
labels 物件 (鍵：字串，值：字串) |
指派給這個節點集區節點的標籤。其中包含鍵/值組合清單。 |
acceleratorOptions AcceleratorConfig |
AcceleratorOptions 會指出 NodePool 中加速器的所需設定。只有在所選 MachineType 包含加速器時，這項設定才有效。 |
NodePoolDefaults
出現位置： - ClusterSpec
| 欄位 | 說明 |
|---|---|
nodeConfigDefaults NodeConfigDefaults |
所有節點的叢集層級設定。(選用步驟) 可變動。 |
NodePoolStatus
定義 NodePool 資源的觀察狀態。
顯示於： - ClusterStatus
| 欄位 | 說明 |
|---|---|
name 字串 |
節點集區的名稱。 |
conditions Condition 陣列 |
節點集區狀態的最新觀察結果。 |
readyNodes 整數 |
可提供服務的節點數量。 |
reconcilingNodes 整數 |
正在協調的節點數量。 |
stalledNodes 整數 |
停滯的節點數量。 |
unknownNodes 整數 |
狀態不明的節點數量。 |
readyTimestamp 時間 |
節點集區處於 ready 狀態的時間。設定後即無法變更。 |
kubernetesVersion 字串 |
這個節點集區節點上執行的 Kubernetes 版本。 |
PrivateRegistry
出現位置： - ContainerdConfig
| 欄位 | 說明 |
|---|---|
host 字串 |
指定私人登錄主機。這必須包含主機或主機:通訊埠。 |
caCertSecretRef SecretReference |
指定儲存私有登錄檔 CA 組合的密鑰。Secret 必須位於叢集命名空間中，或具有 baremetal.cluster.gke.io/mark-source 註解，才能轉送至叢集命名空間。 |
pullCredentialSecretRef SecretReference |
指定私人登錄存取憑證的密鑰。Secret 必須位於叢集命名空間中，或具有 baremetal.cluster.gke.io/mark-source 註解，才能轉送至叢集命名空間。 |
ReleaseChannel
指出叢集訂閱的發布版本。
出現位置： - ClusterSpec
| 欄位 | 說明 |
|---|---|
channel 管道 |
如未設定，預設值為 UNSPECIFIED。 |
UpgradePhaseConfig
出現位置： - UserClusterUpgradeRequestSpec
| 欄位 | 說明 |
|---|---|
maxConcurrency 整數 |
可同時升級的元素數量上限。如要指定所有剩餘項目，請輸入 -1。 |
completionThreshold 整數 |
將這組節點集區視為完成的成功百分比。 |
UserClusterUpgradeRequest
代表使用者叢集升級要求的設定，例如叢集參照和目標 Kubernetes 版本。
顯示於： - UserClusterUpgradeRequestList
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
cluster.gdc.goog/v1 |
kind 字串 |
UserClusterUpgradeRequest |
metadata ObjectMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
spec UserClusterUpgradeRequestSpec |
|
status UserClusterUpgradeRequestStatus |
UserClusterUpgradeRequestList
代表 UserClusterUpgradeRequest 資源的集合。
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
cluster.gdc.goog/v1 |
kind 字串 |
UserClusterUpgradeRequestList |
metadata ListMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
items UserClusterUpgradeRequest 陣列 |
UserClusterUpgradeRequestSpec
提供 UserClusterUpgradeRequest 資源的規格，例如所需狀態。
出現位置： - UserClusterUpgradeRequest
| 欄位 | 說明 |
|---|---|
clusterRef LocalObjectReference |
升級作業適用的 GDC 使用者叢集物件參照。 |
targetVersion 字串 |
目標 Kubernetes 使用者叢集版本。 |
nodePoolUpgradePhases UpgradePhaseConfig 陣列 |
節點升級平行處理的結構定義 |
concurrentUpgrades boolean |
切換並行工作站節點集區 ABM 升級的狀態。如果設為 True，系統會一併升級所有工作站節點集區；如果設為 False，則會一次升級一個。 |
UserClusterUpgradeRequestStatus
出現位置： - UserClusterUpgradeRequest
| 欄位 | 說明 |
|---|---|
conditions Condition 陣列 |
目前的升級狀態。已知條件類型：成功。 |
startTime 時間 |
目前升級作業的觀測開始時間。 |
VersionStatus
定義叢集的已安裝版本資訊。
顯示於： - ClusterStatus
| 欄位 | 說明 |
|---|---|
componentVersion 字串 |
叢集的元件版本。 |
kubernetesVersion 字串 |
叢集的 Kubernetes 版本。 |