Skip to content

Graduate PrioritySortingWithinCohort feature gate to GA#9259

Open
kannon92 wants to merge 1 commit intokubernetes-sigs:mainfrom
kannon92:graduate-priority-sorting-within-cohort
Open

Graduate PrioritySortingWithinCohort feature gate to GA#9259
kannon92 wants to merge 1 commit intokubernetes-sigs:mainfrom
kannon92:graduate-priority-sorting-within-cohort

Conversation

@kannon92
Copy link
Contributor

@kannon92 kannon92 commented Feb 15, 2026

What type of PR is this?

/kind cleanup

What this PR does / why we need it:

Graduates the PrioritySortingWithinCohort feature gate to GA in version 0.17, with LockToDefault: true.

This feature has been enabled by default since v0.6 (Beta). Priority sorting within cohorts is now permanently enabled and can no longer be disabled.

Changes:

  • Set the feature gate to GA with LockToDefault: true (to be removed in 0.19)
  • Removed conditional code paths guarded by the feature gate in scheduler.go, fair_sharing_iterator.go, and workload.go
  • Removed the dead code block in GetQueueOrderTimestamp that handled the disabled case with special preemption timestamp logic
  • Removed integration test context "When borrowWithinCohort is used and PrioritySortingWithinCohort disabled"
  • Removed unit test cases in TestEntryOrdering where prioritySorting: false
  • Updated English and Chinese documentation to remove references to disabling the feature
  • Updated versioned_feature_list.yaml in both site and test reference

Which issue(s) this PR fixes:

Part of #8855

Special notes for your reviewer:

The feature has been Beta and enabled by default since v0.6, so this graduation follows the standard lifecycle. The features import was removed from fair_sharing_iterator.go as it was the only usage in that file.

Does this PR introduce a user-facing change?

Graduate the PrioritySortingWithinCohort feature gate to GA. Priority sorting within cohorts is now always enabled and the feature gate is locked to true.

@k8s-ci-robot k8s-ci-robot added release-note Denotes a PR that will be considered when it comes time to generate release notes. kind/cleanup Categorizes issue or PR as related to cleaning up code, process, or technical debt. labels Feb 15, 2026
@netlify
Copy link

netlify bot commented Feb 15, 2026

Deploy Preview for kubernetes-sigs-kueue ready!

Name Link
🔨 Latest commit af7aa8e
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-sigs-kueue/deploys/69922b217a7f190008f5ac47
😎 Deploy Preview https://deploy-preview-9259--kubernetes-sigs-kueue.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Feb 15, 2026
Set PrioritySortingWithinCohort to GA with LockToDefault: true at version
0.17. Remove all conditional code paths guarded by the feature gate since
priority sorting within cohorts is now always enabled. Remove associated
disabled-feature test cases and update documentation to no longer reference
the ability to disable the feature.
@k8s-ci-robot k8s-ci-robot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Feb 15, 2026
@kannon92 kannon92 force-pushed the graduate-priority-sorting-within-cohort branch from 26c0127 to af7aa8e Compare February 15, 2026 20:22
@mbobrovskyi
Copy link
Contributor

/lgtm

Thank you!

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Feb 16, 2026
@k8s-ci-robot
Copy link
Contributor

LGTM label has been added.

DetailsGit tree hash: 3aa4431baddb40424fdc55650d9098b7111867b1

Copy link
Member

@tenzen-y tenzen-y left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can approve this GA graduation, but I think that we should recommend enabling FS (for preemption enabling users) or AFS (for preemption disabling users) in the release note.

cc @mimowo @gabesaba


As far as I can remember, this FG, we introduced this mechanism with FG since we want to rapidly ship this one.
#1283

Additionally, we discussed adding this setting to the Kueue Configuration rather than using FG gating because this enhancement allows evil users to prioritize their workloads within Cohort.

After some discussions, we introduced FS and AFS to mitigate such evil user behavior.

@mimowo
Copy link
Contributor

mimowo commented Feb 16, 2026

I can approve this GA graduation, but I think that we should recommend enabling FS (for preemption enabling users) or AFS (for preemption disabling users) in the release note.

+1 it will be better to say that users who disable PrioritySortingWithinCohort should transition to FairSharing or Admission Fair Sharing.

IIRC @amy used to use that, but AFAIK no longer uses it.

Additionally, we discussed adding this setting to the Kueue Configuration rather than using FG gating because this enhancement allows evil users to prioritize their workloads within Cohort.
After some discussions, we introduced FS and AFS to mitigate such evil user behavior.

Yes, but given we have FS I don't see a need to maintain this FG.

@tenzen-y
Copy link
Member

IIRC @amy used to use that, but AFAIK no longer uses it.

Additionally, we discussed adding this setting to the Kueue Configuration rather than using FG gating because this enhancement allows evil users to prioritize their workloads within Cohort.
After some discussions, we introduced FS and AFS to mitigate such evil user behavior.

Yes, but given we have FS I don't see a need to maintain this FG.

Yes, I agree with you. For now, we can just recommend FS / AFS. If we can get strong motivation for the disabling of that, we can revisit the dedicated knob.

@kannon92
Copy link
Contributor Author

What change should I make @mimowo and @tenzen-y?

@mimowo
Copy link
Contributor

mimowo commented Feb 16, 2026

What change should I make @mimowo and @tenzen-y?

No change needed. Let's wait a week or so with the PR in case some community members have objections. In particular, I would like to hear from @amy to confirm she successfully managed to stop using the FG.

If no objections raised we can move the PR forward.

@mimowo
Copy link
Contributor

mimowo commented Feb 16, 2026

/lgtm
/approve
For lazy consensus by the end of Feb. cc @tenzen-y
/hold

@k8s-ci-robot k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Feb 16, 2026
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: kannon92, mimowo

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:

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

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Feb 16, 2026
@tenzen-y
Copy link
Member

/lgtm /approve For lazy consensus by the end of Feb. cc @tenzen-y /hold

I agree with you. Let's bring this topic to the next wg-batch meeting.

@tenzen-y
Copy link
Member

/lgtm /approve For lazy consensus by the end of Feb. cc @tenzen-y /hold

I agree with you. Let's bring this topic to the next wg-batch meeting.

I added it to agenda.

[Michal Wozniak & Yuki Iwai] Kueue PrioritySortingWithinCohort GA graduation
#9259
https://docs.google.com/document/d/1XOeUN-K0aKmJJNq7H07r74n-mGgSFyiEDQ3ecwsGhec/edit?usp=sharing

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. kind/cleanup Categorizes issue or PR as related to cleaning up code, process, or technical debt. lgtm "Looks good to me", indicates that a PR is ready to be merged. release-note Denotes a PR that will be considered when it comes time to generate release notes. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants