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 之间的关系遵循以下模式:
- 工作负载控制器创建一个
Workload,其中定义了一棵由CompositePodGroupTemplate和叶子PodGroupTemplate组成的树。 - 对于每个运行时实例,控制器以自顶向下的方式创建一个根级
CompositePodGroup、 若干后代CompositePodGroup对象以及叶子PodGroup对象。 - 控制器创建通过
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 资源负责处理每个实例的运行时调度状态。
- 阅读 CompositePodGroup 生命周期。
- 了解 Workload API 和模板定义。
- 查看 PodGroup API 中叶子组的结构。
- 阅读 PodGroup 调度策略。
- 了解工作负载感知抢占。
来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。
