Skip to content
KEP Brain

KEP-6012keps/sig-scheduling/6012-composite-podgroup-api

CompositePodGroup API

implementablebetasig-schedulinglatest v1.38
This KEP describes the evolution in the workload-aware scheduling architecture that is necessary to support more complex, hierarchical scheduling requirements of modern high-performance distributed workloads. We focus on the API, framework and the basic building blocks - performance optimizations of the underlying algorithms can come as follow-ups. To achie… Full summary

This KEP describes the evolution in the workload-aware scheduling architecture that is necessary to support more complex, hierarchical scheduling requirements of modern high-performance distributed workloads. We focus on the API, framework and the basic building blocks - performance optimizations of the underlying algorithms can come as follow-ups. To achieve this, the KEP builds on the Workload and PodGroup APIs from [KEP-4671] and introduces a new core API called CompositePodGroup. This API allows expressing multi-level topology constraints, gang scheduling and preemption policies for heterogeneous groups of Pods and facilitates extending the Kubernetes scheduler with more policies in the future.

Facts

PRR approvers
@wojtek-talpha@wojtek-tbeta
Tracking issue
#6012(opens GitHub in a new tab) openmilestone v1.38sig/schedulingstage/betatracked/yeslead-opted-inwg/workload-aware-scheduling
Milestones
alpha v1.37beta v1.38stable v1.40
Participating SIGs
sig-apps
Feature gates
CompositePodGroup
Created / last updated
2026-04-15 / none
Loading decisions and status history

Keyboard shortcuts

Everywhere

?
Show or hide this list
/
Focus the question box on Ask, otherwise the page search
Ctrl Kor⌘ K
Focus the KEP search in the top bar
t
Switch the theme (system, light, dark)
Esc
Close a dialog, a search list or a menu

Go to a page

Press g, then the letter

g h
Home
g a
Ask
g e
Explore
g u
Audit
g m
Memory
g b
About

Ask

Enter
Send the question
Shift Enter
New line in the question
Esc
Cancel the running question

Search lists

KEP search and Explore search

↓or↑
Move through the results
HomeorEnd
First or last result (Explore)
Enter
Open the highlighted result, or KEP-n when the query is a number

KEP page

o
Open the KEP on GitHub
y
Open kep.yaml on GitHub
a
Ask about this KEP
←or→
Previous or next tab, when a tab is focused

Findings table

With a finding row focused (Tab into the table or click a row)

jork
Next or previous finding
EnterorSpace
Expand or collapse the finding
o
Open the finding's KEP page
d
Draft the fix as an issue text (nothing is posted)
]or[
Next or previous page of findings

Shortcuts pause while you type in a field. Press ? or Esc to close.