KEP-5547: Add docs for Workload APIs integration with Job controller by helayoty · Pull Request #54489 · kubernetes/website

helayoty · 2026-02-16T23:55:37Z

Description

Add new section in the Job controller for the Workload APIs integration. The documentation covers qualifying criteria, example YAML, opt-out mechanism for higher-level controllers, CronJob behavior, and alpha limitations
Added a note in the "Elastic Indexed Jobs" section that parallelism updates are rejected for gang-scheduled Jobs when EnableWorkloadWithJob is enabled
Added "Gang scheduling with Jobs" section in the scheduling doc explaining that the Job controller automatically creates Workload/PodGroup for qualifying parallel indexed Jobs

/sig apps
/sig scheduling
/area workload-aware

Issue

#5547

Closes: #

netlify · 2026-02-17T00:04:51Z

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`5ad50f0`
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/69d7667831bece000839c702
😎 Deploy Preview	https://deploy-preview-54489--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

linux-foundation-easycla · 2026-03-26T22:02:44Z

The committers listed above are authorized under a signed CLA.

✅ login: helayoty / name: Heba Elayoty (63242e4)
✅ login: helayoty / name: helayoty (5ad50f0)

andreyvelich

Thanks @helayoty, overall looks great!

andreyvelich · 2026-03-28T01:27:27Z

+1. Creates a `Workload` object in the same namespace with a `podGroupTemplate`
+   containing a gang policy where `minCount` equals the Job's parallelism.
+2. Creates a `PodGroup` object based on that template.
+3. Creates Pods with `spec.schedulingGroup.podGroupName` set to the `PodGroup` name,
+   linking each Pod to its scheduling group.


Can we also explain naming for Workload, PodGroupTemplate, and PodGroup ?

I guess this should link to changes that are also in review #54490

lmktfy · 2026-04-03T16:41:52Z

/remove-area release-eng

soltysh

Minor suggestions, but this lgtm from sig-apps pov

soltysh · 2026-04-07T14:15:52Z

+
+{{< feature-state feature_gate_name="EnableWorkloadWithJob" >}}
+
+When the [`EnableWorkloadWithJob`](/docs/reference/command-line-tools-reference/feature-gates/) feature gate is enabled,


If we land kubernetes/kubernetes#138210, this will need to get updated accordingly.

Can we update this in a follow-up PR?

@helayoty yes, this will definitely need to be updated in a follow-up PR once the the other lands, thanks (you can also create an issue for this as well, recommended)

reylejano · 2026-04-08T15:10:58Z

PR needs rebase

reylejano · 2026-04-08T15:59:22Z

/milestone 1.36

Signed-off-by: Heba Elayoty <[email protected]> Signed-off-by: helayoty <[email protected]>

Signed-off-by: helayoty <[email protected]>

macsko · 2026-04-09T08:50:24Z

/lgtm
From SIG Scheduling POV

k8s-ci-robot · 2026-04-09T08:50:33Z

LGTM label has been added.

Details

Git tree hash: 2891d613203060c374c47f7ca6317baf6e220437

natalisucks · 2026-04-09T11:23:33Z

good from docs, thanks
/approve

k8s-ci-robot · 2026-04-09T11:23:49Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: natalisucks, soltysh

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

~~content/en/docs/OWNERS~~ [natalisucks]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

github-project-automation Bot added this to SIG Apps and SIG Scheduling Feb 16, 2026

github-project-automation Bot moved this to Needs Triage in SIG Scheduling Feb 16, 2026

github-project-automation Bot moved this to Needs Triage in SIG Apps Feb 16, 2026

k8s-ci-robot added the language/en Issues or PRs related to English language label Feb 16, 2026

k8s-ci-robot requested review from divya-mohan0209 and katcosgrove February 16, 2026 23:55

k8s-ci-robot added sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Feb 16, 2026

helayoty changed the base branch from main to dev-1.36 February 16, 2026 23:55

k8s-ci-robot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Feb 16, 2026

helayoty moved this from Needs Triage to In Progress in SIG Apps Feb 16, 2026

helayoty moved this from Needs Triage to In Progress in SIG Scheduling Feb 16, 2026

helayoty mentioned this pull request Feb 16, 2026

WAS: Integrate Workload APIs with Job controller kubernetes/enhancements#5547

Open

4 tasks

helayoty added this to Workload-aware & Topology-aware Workstream Feb 17, 2026

github-project-automation Bot moved this to Backlog in Workload-aware & Topology-aware Workstream Feb 17, 2026

helayoty force-pushed the helayoty/5547-integrate-job-workload branch from 012aa63 to 732ee6a Compare March 26, 2026 22:02

k8s-ci-robot added the language/ja Issues or PRs related to Japanese language label Mar 26, 2026

helayoty moved this from In Progress to Needs Review in SIG Scheduling Mar 27, 2026

helayoty moved this from Backlog to Needs Review in Workload-aware & Topology-aware Workstream Mar 27, 2026

andreyvelich reviewed Mar 28, 2026

View reviewed changes

Argh4k reviewed Mar 30, 2026

View reviewed changes

Comment thread content/en/docs/reference/command-line-tools-reference/feature-gates/EnableWorkloadWithJob.md Outdated

kannon92 reviewed Mar 31, 2026

View reviewed changes

Comment thread content/en/docs/concepts/workloads/controllers/job.md

Argh4k mentioned this pull request Mar 31, 2026

KEP-5710: Update scheduler docs for workload aware preemption #54692

Merged

macsko reviewed Apr 1, 2026

View reviewed changes

Comment thread content/en/docs/concepts/scheduling-eviction/gang-scheduling.md Outdated

k8s-ci-robot removed the area/release-eng Issues or PRs related to the Release Engineering subproject label Apr 3, 2026

helayoty force-pushed the helayoty/5547-integrate-job-workload branch from 4696939 to 936f340 Compare April 6, 2026 11:22

helayoty requested review from Argh4k, andreyvelich, kannon92, lmktfy and macsko April 6, 2026 11:22

helayoty moved this from Needs Review to In Progress in SIG Scheduling Apr 6, 2026

helayoty moved this from Needs Review to In Review in Workload-aware & Topology-aware Workstream Apr 6, 2026

k8s-ci-robot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Apr 7, 2026

soltysh approved these changes Apr 7, 2026

View reviewed changes

k8s-ci-robot added this to the 1.36 milestone Apr 8, 2026

Update Job and gang scheduling documentation with Workload integration

63242e4

Signed-off-by: Heba Elayoty <[email protected]> Signed-off-by: helayoty <[email protected]>

macsko reviewed Apr 9, 2026

View reviewed changes

Comment thread content/en/docs/concepts/scheduling-eviction/gang-scheduling.md Outdated

move gang scheduling with jobs to workload-api

5ad50f0

Signed-off-by: helayoty <[email protected]>

kannon92 mentioned this pull request Apr 13, 2026

KEP-4671: Add Workload Aware Scheduling blog post for v1.36 #54667

Merged


		{{< feature-state feature_gate_name="EnableWorkloadWithJob" >}}

		When the [`EnableWorkloadWithJob`](/docs/reference/command-line-tools-reference/feature-gates/) feature gate is enabled,

Conversation

helayoty commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Issue

Uh oh!

netlify Bot commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Pull request preview available for checking

Uh oh!

linux-foundation-easycla Bot commented Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

andreyvelich left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

andreyvelich Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

Argh4k Mar 30, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

lmktfy commented Apr 3, 2026

Uh oh!

soltysh left a comment

Choose a reason for hiding this comment

Uh oh!

soltysh Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

helayoty Apr 9, 2026

Choose a reason for hiding this comment

Uh oh!

natalisucks Apr 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

reylejano commented Apr 8, 2026

Uh oh!

reylejano commented Apr 8, 2026

Uh oh!

Uh oh!

macsko commented Apr 9, 2026

Uh oh!

k8s-ci-robot commented Apr 9, 2026

Uh oh!

natalisucks commented Apr 9, 2026

Uh oh!

k8s-ci-robot commented Apr 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

helayoty commented Feb 16, 2026 •

edited

Loading

netlify Bot commented Feb 17, 2026 •

edited

Loading

linux-foundation-easycla Bot commented Mar 26, 2026 •

edited

Loading