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 数组 |
集群工作器节点的节点池列表。可选。可变。 |
nodePoolDefaults NodePoolDefaults |
所有节点池的集群级配置。可选。可变。 |
ClusterState
底层类型： string
表示集群的状态。
来源： - ClusterStatus
ClusterStatus
定义观察到的集群状态。
来源： - 集群
| 字段 | 说明 |
|---|---|
conditions 条件数组 |
集群状态的最新观测结果。Reconciling 和 Stalled 等条件表示上次集群协调是否成功。 |
errorStatus ErrorStatus |
集群的观测到的错误状态。 |
workerNodePoolStatuses NodePoolStatus 数组NodePoolStatus |
工作器节点池的观测状态列表。 |
controlPlaneConditions 条件数组 |
控制平面是否已就绪。 |
componentsConditions 条件数组 |
用户集群组件是否已成功部署。 |
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 自定义资源配置。
来源： - ClusterSpec
| 字段 | 说明 |
|---|---|
name 字符串 |
节点池的名称。 |
nodeCount 整数 |
已配置的节点池中所需的节点数。 |
machineTypeName 字符串 |
用于配置节点的机器类型的名称。 |
taints 污点数组 |
分配给此节点池的节点的污点。 |
labels 对象（键：字符串，值：字符串） |
分配给此节点池的节点的标签。它包含一个键值对列表。 |
acceleratorOptions AcceleratorConfig |
AcceleratorOptions 用于指明 NodePool 中所需的加速器配置。仅当所选 MachineType 包含加速器时有效。 |
NodePoolDefaults
来源： - ClusterSpec
| 字段 | 说明 |
|---|---|
nodeConfigDefaults NodeConfigDefaults |
所有节点的集群级配置。可选。可变。 |
NodePoolStatus
定义观察到的 NodePool 资源的状态。
来源： - ClusterStatus
| 字段 | 说明 |
|---|---|
name 字符串 |
节点池的名称。 |
conditions 条件数组 |
节点池状态的最新观测结果。 |
readyNodes 整数 |
可供投放的节点数量。 |
reconcilingNodes 整数 |
正在调和的节点数。 |
stalledNodes 整数 |
处于停滞状态的节点数。 |
unknownNodes 整数 |
状态未知的节点数。 |
readyTimestamp 时间 |
节点池处于 ready 状态的时间。此值一经设置便永远不会更改。 |
kubernetesVersion 字符串 |
相应节点池的节点上运行的 Kubernetes 版本。 |
PrivateRegistry
来源： - ContainerdConfig
| 字段 | 说明 |
|---|---|
host 字符串 |
指定私有注册表主机。必须包含主机或 host:port。 |
caCertSecretRef SecretReference |
指定存储私有注册表的 CA 软件包的 Secret。该 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 布尔值 |
用于并发工作器节点池 ABM 升级的切换开关。True 表示同时升级所有工作器节点池，False 表示一次升级一个。 |
UserClusterUpgradeRequestStatus
来源： - UserClusterUpgradeRequest
| 字段 | 说明 |
|---|---|
conditions 条件数组 |
当前的升级状态。已知条件类型：成功。 |
startTime 时间 |
当前升级的观测开始时间。 |
VersionStatus
定义集群的已安装版本信息。
来源： - ClusterStatus
| 字段 | 说明 |
|---|---|
componentVersion 字符串 |
集群的组件版本。 |
kubernetesVersion 字符串 |
集群的 Kubernetes 版本。 |