KRM API cluster.gdc.goog/v1

cluster.gdc.goog/v1

包含集群组的 API 架构定义。

AcceleratorConfig

来源: - NodePool

字段 说明
gpuPartitionScheme 字符串 GPUPartitionScheme 表示将 GPU 划分为 MIG 的方案。此方案和 GPU DeviceModel 共同决定了 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 负载均衡器配置。如果未设置,则使用默认配置和入站流量服务 IP 地址大小。可选。可变。
nodePools NodePool 数组 集群工作器节点的节点池列表。可选。可变。

ClusterState

底层类型string 表示集群的状态。

来源: - ClusterStatus

ClusterStatus

定义观察到的集群状态。

来源: - 集群

字段 说明
conditions 条件数组 集群状态的最新观测结果。ReconcilingStalled 等条件表示上次集群协调是否成功。
errorStatus ErrorStatus 集群的观测到的错误状态。
workerNodePoolStatuses NodePoolStatus 数组 工作器节点池的观测状态列表。
controlPlaneConditions 条件数组 控制平面是否已就绪。
componentsConditions 条件数组 用户集群组件是否已成功部署。
versionStatus VersionStatus 集群的已安装版本信息。
clusterState ClusterState 集群的状态。以下状态可供选择:
  • Running:集群已创建并可供使用。
  • Reconciling:集群上正在积极执行某些工作。
  • Deleting:集群正在被删除。
  • Error:在协调/配置集群时发生了一些错误。

ClusterVersion

指定采用气隙配置的 GDC 用户集群的版本信息。

来源: - ClusterSpec

字段 说明
kubernetesVersion 字符串 GDC 用户集群的 Kubernetes 版本。

LoadBalancer

指定负载平衡器配置。

来源: - ClusterSpec

字段 说明
ingressServiceIPSize 整数 负载均衡器类型服务使用的非重叠 IP 池的大小。如果未设置,则使用默认值 20

节点池

指定 NodePool 自定义资源配置。

来源: - ClusterSpec

字段 说明
name 字符串 节点池的名称。
nodeCount 整数 已配置的节点池中所需的节点数。
machineTypeName 字符串 用于配置节点的机器类型的名称。
taints Taint数组 分配给此节点池的节点的污点。
labels 对象(键:字符串,值:字符串) 分配给此节点池的节点的标签。它包含一个键值对列表。
acceleratorOptions AcceleratorConfig AcceleratorOptions 用于指示 NodePool 中加速器的所需配置。仅当所选 MachineType 包含加速器时有效。

NodePoolStatus

定义观察到的 NodePool 资源的状态。

来源: - ClusterStatus

字段 说明
name 字符串 节点池的名称。
conditions 条件数组 节点池状态的最新观测结果。
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 条件数组 当前的升级状态。已知条件类型:成功。
startTime 时间 当前升级的观测开始时间。

VersionStatus

定义集群的已安装版本信息。

来源: - ClusterStatus

字段 说明
componentVersion 字符串 集群的组件版本。
kubernetesVersion 字符串 集群的 Kubernetes 版本。