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

PodGroup API

· 52CE 我爱测

虽然工作负载 API 定义了调度策略模板, 但 PodGroup 是运行时对应的对象,它同时承载了策略和该组特定实例的调度状态。

PodGroup 是一个运行时对象,代表一组作为单个单元一起调度的 Pod。

虽然工作负载 API 定义了调度策略模板, 但 PodGroup 是运行时对应的对象,它同时承载了策略和该组特定实例的调度状态。

什么是 PodGroup? {#what-is-a-podgroup}

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

PodGroup 是一个自包含的调度单元。它定义了应该一起调度的 Pod 组, 承载了控制放置的调度策略,并记录了该调度决策的运行时状态。

API 结构 {#api-structure}

PodGroup 由定义所需调度行为的 spec 和反映当前调度状态的 status 组成。

调度策略 {#scheduling-policy}

每个 PodGroup 在 spec.schedulingPolicy 中承载一个调度策略 (basic 或 Gang)。当工作负载控制器创建 PodGroup 时, 此策略在创建时从 Workload 的 PodGroupTemplate 复制。 对于独立的 PodGroup,你直接设置策略。

spec:
  schedulingPolicy:
    gang:
      minCount: 4

模板引用 {#template-reference}

可选的 spec.podGroupTemplateRef 将 PodGroup 链接回它所创建自的 Workload 中的 PodGroupTemplate。 这对于可观测性和工具非常有用。

spec:
  podGroupTemplateRef:
    workload:
      workloadName: training-policy
      podGroupTemplateName: worker

优先级和干扰模式 {#priority-and-disruption-mode}

每个 PodGroup 还可以定义自己的 spec.priority、spec.preemptionPolicy 和 spec.disruptionMode。优先级和抢占策略通过 spec.priorityClassName 字段设置, 该字段指向一个 PriorityClass 资源。有关这些字段的详细描述,请参阅 PodGroup 干扰和优先级。

当工作负载控制器创建 PodGroup 时,这些字段在创建时从 Workload 的 PodGroupTemplate 复制。 对于独立的 PodGroup,你直接设置这些字段。

spec:
  disruptionMode:
    all: {}
  priorityClassName: high-priority

为 PodGroup 请求 DRA 设备 {#requesting-dra-devices-for-a-podgroup}

通过 可获得的可以由 PodGroup 通过其 spec.resourceClaims 字段请求:

apiVersion: scheduling.k8s.io/v1beta1
kind: PodGroup
metadata:
  name: training-group
  namespace: some-ns
spec:
  ...
  resourceClaims:
  - name: pg-claim
    resourceClaimName: my-pg-claim
  - name: pg-claim-template
    resourceClaimTemplateName: my-pg-template

与 PodGroup 关联的

可以由属于该组的所有 Pod 共享。 只需在 ResourceClaim 的 status.reservedFor 中引用 PodGroup,而不是每个单独的 Pod, 同一 PodGroup 中的任意数量的 Pod 都可以共享一个 ResourceClaim。 还可以为每个 PodGroup 从

生成 ResourceClaim,允许分配给每个生成的 ResourceClaim 的设备由每个 PodGroup 中的 Pod 共享。

有关更多详细信息和更完整的示例,请参阅 DRA 文档。

状态 {#status}

调度器更新 status.conditions 以报告组是否已成功调度。 主要条件是 PodGroupInitiallyScheduled,当所有必需的 Pod 已放置时为 True, 当调度失败时为 False。

PodGroupInitiallyScheduled 条件仅反映初始调度决策。 如果 Pod 后续失败或被驱逐,调度器不会更新它。 有关详细信息,请参阅限制。

有关条件和原因的完整列表,请参阅 PodGroup 生命周期页面。

创建 PodGroup {#creating-a-podgroup}

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

以下清单创建一个具有 gang 调度策略的 PodGroup,该策略要求至少 4 个 Pod 同时可调度:

apiVersion: scheduling.k8s.io/v1beta1
kind: PodGroup
metadata:
  name: training-worker-0
  namespace: default
spec:
  schedulingPolicy:
    gang:
      minCount: 4

你可以在集群中检查 PodGroup:

kubectl get podgroups

要查看包括调度条件在内的完整状态:

kubectl describe podgroup training-worker-0

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

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

  1. 工作负载控制器创建一个 Workload,该 Workload 定义带有调度策略的 PodGroupTemplate。
  2. 对于每个运行时实例,控制器从 Workload 的其中一个 PodGroupTemplate 创建一个 PodGroup。
  3. 控制器创建通过 spec.schedulingGroup.podGroupName 字段引用 PodGroup 的 Pod。

Job 控制器是目前唯一遵循此模式的内置工作负载控制器。 自定义控制器可以为自己的工作负载类型实现相同的流程。

apiVersion: scheduling.k8s.io/v1beta1
kind: Workload
metadata:
  name: training-policy
spec:
  podGroupTemplates:
  - name: worker
    schedulingPolicy:
      gang:
        minCount: 4
---
apiVersion: scheduling.k8s.io/v1beta1
kind: PodGroup
metadata:
  name: training-worker-0
spec:
  podGroupTemplateRef:
    workload:
      workloadName: training-policy
      podGroupTemplateName: worker
  schedulingPolicy:
    gang:
      minCount: 4
---
apiVersion: v1
kind: Pod
metadata:
  name: worker-0
spec:
  schedulingGroup:
    podGroupName: training-worker-0
  containers:
  - name: ml-worker
    image: training:v1

Workload 充当长期存在的策略定义,而 PodGroup 处理瞬态的、每个实例的运行时状态。 这种分离意味着单个 PodGroup 的状态更新不会与共享的 Workload 对象发生冲突。

父组 {#parent-group}

当 CompositePodGroup 特性门控启用时,PodGroup 可以作为由 PodGroup 和 CompositePodGroup 组成的多级组层级中的叶节点。 PodGroup 可以使用 spec.parentCompositePodGroupName 字段指定其父组。 将工作负载组织为组层级可用于表达多级编组调度需求、多级拓扑约束以及工作负载各部分之间的干扰命运共享。

有关层级组结构和多级编组调度的更多详细信息,请参阅 CompositePodGroup API 概述。

指定了 spec.parentCompositePodGroupName 的 PodGroup 还必须指定 spec.workloadRef, 将 PodGroup 关联回其在 Workload 中的模板。不允许独立的 PodGroup 对象 (创建时没有 spec.workloadRef)指定父 CompositePodGroup。

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

资料来源与适用范围

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

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

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