Skip to content
KEP Brain

KEP-5832keps/sig-scheduling/5832-decouple-podgroup-api

Decouple PodGroup API

implementablealphasig-schedulinglatest v1.362 open findings
This KEP proposes decoupling the PodGroup API from the Workload API by introducing PodGroup as a standalone runtime object. In alpha1 design for gang scheduling, PodGroups were embedded within the Workload spec, which creates challenges around immutability, scaling, and lifecycle management. Under this proposal, the following changes are proposed as alpha2:… Full summary

This KEP proposes decoupling the PodGroup API from the Workload API by introducing PodGroup as a standalone runtime object. In alpha1 design for gang scheduling, PodGroups were embedded within the Workload spec, which creates challenges around immutability, scaling, and lifecycle management. Under this proposal, the following changes are proposed as alpha2: - Workload becomes a static template defining scheduling hierarchy and scheduling policy definition that specifies what workload behavior should be applied - PodGroup becomes a runtime self-contained runtime scheduling unit for a group of pods that encapsulates both the scheduling policy and status. It is automatically created by true controllers (Job, JobSet, LeaderWorkerSet) when they create workloads, rather than being embedded within the Workload spec. It will be created based on the podGroupTemplate defined in the referenced Workload.

Facts

PRR approvers
@wojtek-talpha
Tracking issue
#5832(opens GitHub in a new tab) closedcompletedclosed 2026-05-18 23:01 UTCsig/schedulingstage/alphatriage/accepted
Milestones
alpha v1.36beta v1.37stable v1.39
Participating SIGs
sig-appssig-api-machinery
Feature gates
GenericWorkload
Created / last updated
2026-01-23 / 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.