大网数据广告活动
Kubernetes 部署与运维

CompositePodGroup API

· 52CE 我爱测

`CompositePodGroup` 是一个运行时对象,表示多级工作负载层级结构中的非叶节点。 虽然 Workload API 定义了静态调度策略模板,但 `CompositePodGroup` 和 `PodGroup` 对象是运行时对应的对象, 它们为特定工作负载实例承载策略和层级引用。

CompositePodGroup 是一个运行时对象,表示多级工作负载层级结构中的非叶节点。 虽然 Workload API 定义了静态调度策略模板,但 CompositePodGroup 和 PodGroup 对象是运行时对应的对象, 它们为特定工作负载实例承载策略和层级引用。

什么是 CompositePodGroup? {#what-is-a-compositepodgroup}

CompositePodGroup API 资源是 scheduling.k8s.io/v1alpha3 的一部分。 在使用此 API 之前,你的集群必须启用该 API 组以及 CompositePodGroup 特性门控。

CompositePodGroup 表示一组子组(子组可以是 CompositePodGroup 或 PodGroup 对象)。 它承载调度策略、干扰模式、优先级设置,以及跨其子组集体生效的可选拓扑约束。

API 结构 {#api-structure}

CompositePodGroup 由定义其子组所需调度行为的 spec 和一个 status 子资源组成。

调度策略 {#scheduling-policy}

每个 CompositePodGroup 在 spec.schedulingPolicy 中承载一个调度策略(basic 或 gang)。 当工作负载控制器创建 CompositePodGroup 时, 此策略在创建时从 Workload 的 CompositePodGroupTemplate 复制。

对于 CompositePodGroup 上的 gang 策略, minGroupCount 字段指定必须可同时调度的最小组数量:

spec:
  schedulingPolicy:
    gang:
      minGroupCount: 2

父组引用 {#parent-group-reference}

非根级 CompositePodGroup 资源使用 spec.parentCompositePodGroupName 指定其父组。 根级 CompositePodGroup 对象不设置此字段。

spec:
  parentCompositePodGroupName: root-group-0

Workload 引用 {#workload-reference}

spec.workloadRef 字段将 CompositePodGroup 关联回其派生自的 Workload 对象中的 CompositePodGroupTemplate。

spec:
  workloadRef:
    workloadName: hierarchical-workload
    templateName: replica-group

状态 {#status}

CompositePodGroup API 模式中包含一个 status 子资源。 在 Alpha 版本中,API 类型里存在 status 字段, 但 kube-scheduler 不会为 CompositePodGroup 对象更新或填充状态状况。 复合组的状态跟踪将在未来的发行版本中实现。

创建 CompositePodGroup {#creating-a-compositepodgroup}

工作负载控制器在运行时自动从 Workload 模板创建 CompositePodGroup 对象。

以下清单创建一个带有 gang 调度策略的根级 CompositePodGroup, 该策略要求至少 2 个子组可同时调度:

apiVersion: scheduling.k8s.io/v1alpha3
kind: CompositePodGroup
metadata:
  name: root-group-0
  namespace: default
spec:
  workloadRef:
    workloadName: hierarchical-workload
    templateName: root
  schedulingPolicy:
    gang:
      minGroupCount: 2

你可以在集群中检查 CompositePodGroup 资源:

kubectl get compositepodgroups

要查看某个特定复合组的详细信息:

kubectl describe compositepodgroup root-group-0

如何组合使用 {#how-it-fits-together}

控制器、Workload、CompositePodGroup、PodGroup 和 Pod 之间的关系遵循以下模式:

  1. 工作负载控制器创建一个 Workload,其中定义了一棵由 CompositePodGroupTemplate 和叶子 PodGroupTemplate 组成的树。
  2. 对于每个运行时实例,控制器以自顶向下的方式创建一个根级 CompositePodGroup、 若干后代 CompositePodGroup 对象以及叶子 PodGroup 对象。
  3. 控制器创建通过 spec.schedulingGroup.podGroupName 引用其叶子 PodGroup 的 Pod。

以下示例展示了一个双层工作负载的完整清单层级结构:

apiVersion: scheduling.k8s.io/v1alpha3
kind: Workload
metadata:
  name: hierarchical-workload
  namespace: default
spec:
  compositePodGroupTemplates:
  - name: root
    schedulingPolicy:
      gang:
        minGroupCount: 2
    podGroupTemplates:
    - name: workers-a
      schedulingPolicy:
        gang:
          minCount: 4
    - name: workers-b
      schedulingPolicy:
        gang:
          minCount: 4
---
apiVersion: scheduling.k8s.io/v1alpha3
kind: CompositePodGroup
metadata:
  name: root-group-0
  namespace: default
spec:
  workloadRef:
    workloadName: hierarchical-workload
    templateName: root
  schedulingPolicy:
    gang:
      minGroupCount: 2
---
apiVersion: scheduling.k8s.io/v1alpha3
kind: PodGroup
metadata:
  name: workers-a-0
  namespace: default
spec:
  parentCompositePodGroupName: root-group-0
  workloadRef:
    workloadName: hierarchical-workload
    templateName: workers-a
  schedulingPolicy:
    gang:
      minCount: 4
---
apiVersion: scheduling.k8s.io/v1alpha3
kind: PodGroup
metadata:
  name: workers-b-0
  namespace: default
spec:
  parentCompositePodGroupName: root-group-0
  workloadRef:
    workloadName: hierarchical-workload
    templateName: workers-b
  schedulingPolicy:
    gang:
      minCount: 4
---
apiVersion: v1
kind: Pod
metadata:
  name: worker-a-0
  namespace: default
spec:
  schedulingGroup:
    podGroupName: workers-a-0
  containers:
  - name: worker
    image: registry.k8s.io/pause:3.9

Workload 充当长期存在的策略模板,而 CompositePodGroup 和 PodGroup 资源负责处理每个实例的运行时调度状态。

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。