KRM API cluster.gdc.goog/v1

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 陣列	叢集工作站節點的節點集區清單。(選用步驟) 可變動。

ClusterState

基礎類型： string 指出叢集的狀態。

顯示於： - ClusterStatus

ClusterStatus

定義叢集的觀察狀態。

顯示位置： - 叢集

欄位	說明
conditions Condition 陣列	叢集狀態的最新觀察結果。Reconciling 和 Stalled 等條件會指出上次叢集協調是否成功。
errorStatus ErrorStatus	叢集的觀察錯誤狀態。
workerNodePoolStatuses NodePoolStatus 陣列	觀察到的工作站節點集區狀態清單。
controlPlaneConditions Condition 陣列	控制層是否已準備就緒。
componentsConditions Condition 陣列	使用者叢集元件是否已成功部署。
versionStatus VersionStatus	叢集的已安裝版本資訊。
clusterState ClusterState	叢集狀態。可用的州別如下： Running：叢集已建立並可供使用。 Reconciling：叢集正在執行某些工作。 Deleting：正在刪除叢集。 Error：調解/佈建叢集時發生一些錯誤。

ClusterVersion

指定無氣隙設定中 GDC 使用者叢集的版本資訊。

出現位置： - ClusterSpec

欄位	說明
kubernetesVersion 字串	GDC 使用者叢集的 Kubernetes 版本。

LoadBalancer

指定負載平衡器設定。

出現位置： - ClusterSpec

欄位	說明
ingressServiceIPSize 整數	負載平衡器型服務使用的非重疊 IP 集區大小。如未設定，系統會使用預設值 20。

NodePool

指定 NodePool 自訂資源設定。

出現位置： - ClusterSpec

欄位	說明
name 字串	節點集區的名稱。
nodeCount 整數	已佈建節點集區中所需的節點數量。
machineTypeName 字串	用於佈建節點的機器類型名稱。
taints Taint 陣列	指派給這個節點集區節點的污點。
labels 物件 (鍵：字串，值：字串)	指派給這個節點集區節點的標籤。其中包含鍵/值組合清單。
acceleratorOptions AcceleratorConfig	AcceleratorOptions 會指出 NodePool 中加速器的所需設定。只有在所選 MachineType 包含加速器時，這項設定才有效。

NodePoolStatus

定義 NodePool 資源的觀察狀態。

顯示於： - ClusterStatus

欄位	說明
name 字串	節點集區的名稱。
conditions Condition 陣列	節點集區狀態的最新觀察結果。
readyNodes 整數	可提供服務的節點數量。
reconcilingNodes 整數	正在協調的節點數量。
stalledNodes 整數	停滯的節點數量。
unknownNodes 整數	狀態不明的節點數量。
readyTimestamp 時間	節點集區處於 ready 狀態的時間。設定後即無法變更。
kubernetesVersion 字串	這個節點集區節點上執行的 Kubernetes 版本。

ReleaseChannel

指出叢集訂閱的發布版本。

出現位置： - ClusterSpec

欄位	說明
channel 管道	如未設定，預設值為 UNSPECIFIED。

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 使用者叢集版本。

UserClusterUpgradeRequestStatus

出現位置： - UserClusterUpgradeRequest

欄位	說明
conditions Condition 陣列	目前的升級狀態。已知條件類型：成功。
startTime 時間	目前升級作業的觀測開始時間。

VersionStatus

定義叢集的已安裝版本資訊。

顯示於： - ClusterStatus

欄位	說明
componentVersion 字串	叢集的元件版本。
kubernetesVersion 字串	叢集的 Kubernetes 版本。