More information about this feature
To use this feature, you (or a cluster administrator) will need to enable the CompositePodGroup feature gate for all relevant components in your cluster.
See Enable Or Disable Feature Gates for more information.
CompositePodGroup 是一个运行时对象，表示多级工作负载层级结构中的非叶节点。
虽然 Workload API
定义了静态调度策略模板，但 CompositePodGroup 和 PodGroup 对象是运行时对应的对象，
它们为特定工作负载实例承载策略和层级引用。
什么是 CompositePodGroup？
CompositePodGroup API 资源是 scheduling.k8s.io/v1alpha3
API 组的一部分。
在使用此 API 之前，你的集群必须启用该 API 组以及 CompositePodGroup
特性门控。
CompositePodGroup 表示一组子组（子组可以是 CompositePodGroup 或 PodGroup 对象）。
它承载调度策略、干扰模式、优先级设置，以及跨其子组集体生效的可选拓扑约束。
API 结构
CompositePodGroup 由定义其子组所需调度行为的 spec 和一个 status 子资源组成。
调度策略
每个 CompositePodGroup 在 spec.schedulingPolicy
中承载一个调度策略（basic 或 gang）。
当工作负载控制器创建 CompositePodGroup 时，
此策略在创建时从 Workload 的 CompositePodGroupTemplate 复制。
对于 CompositePodGroup 上的 gang 策略，
minGroupCount 字段指定必须可同时调度的最小组数量：
spec:
schedulingPolicy:
gang:
minGroupCount: 2
父组引用
非根级 CompositePodGroup 资源使用 spec.parentCompositePodGroupName 指定其父组。
根级 CompositePodGroup 对象不设置此字段。
spec:
parentCompositePodGroupName: root-group-0
Workload 引用
spec.workloadRef 字段将 CompositePodGroup 关联回其派生自的
Workload 对象中的 CompositePodGroupTemplate。
spec:
workloadRef:
workloadName: hierarchical-workload
templateName: replica-group
状态
CompositePodGroup API 模式中包含一个 status 子资源。
在 Alpha 版本中，API 类型里存在 status 字段，
但 kube-scheduler 不会为 CompositePodGroup 对象更新或填充状态状况。
复合组的状态跟踪将在未来的发行版本中实现。
创建 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
如何组合使用
控制器、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 调度策略。
- 了解工作负载感知抢占。