Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Promote SchedulerQueueingHints to beta in 1.32 #48406

Merged
merged 3 commits into from
Nov 14, 2024
Merged

Promote SchedulerQueueingHints to beta in 1.32 #48406

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
90bbc7b
KEP-4247: make QHint enabled by default
sanposhiho Oct 17, 2024
cc71610
fix: link to a doc page
sanposhiho Nov 6, 2024
3847493
fix: modify the note on the concept page
sanposhiho Nov 12, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 3 additions & 6 deletions content/en/docs/concepts/scheduling-eviction/scheduling-framework.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ Plugins that implement PreEnqueue, PreFilter, Filter, Reserve or Permit should i

### QueueingHint

{{< feature-state for_k8s_version="v1.28" state="beta" >}}
{{< feature-state for_k8s_version="v1.32" state="beta" >}}

QueueingHint is a callback function for deciding whether a Pod can be requeued to the active queue or backoff queue.
It's executed every time a certain kind of event or change happens in the cluster.
Expand All @@ -84,11 +84,8 @@ so that the scheduler will retry the scheduling of the Pod.

{{< note >}}
QueueingHint evaluation during scheduling is a beta-level feature.
The v1.28 release series initially enabled the associated feature gate; however, after the
discovery of an excessive memory footprint, the Kubernetes project set that feature gate
to be disabled by default. In Kubernetes {{< skew currentVersion >}}, this feature gate is
disabled and you need to enable it manually.
You can enable it via the
In Kubernetes {{< skew currentVersion >}}, this feature gate is enabled by default,
and you can disable it via the
`SchedulerQueueingHints` [feature gate](/docs/reference/command-line-tools-reference/feature-gates/).
{{< /note >}}

Expand Down
6 changes: 5 additions & 1 deletion ...eference/command-line-tools-reference/feature-gates/scheduler-queueing-hints.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,12 @@ stages:
- stage: beta
defaultValue: false
fromVersion: "1.29"
toVersion: "1.31"
- stage: beta
defaultValue: true
fromVersion: "1.32"
---
Enables [the scheduler's _queueing hints_ enhancement](https://github.com/kubernetes/enhancements/blob/master/keps/sig-scheduling/4247-queueinghint/README.md),
Enables [the scheduler's _queueing hints_ feature](/docs/concepts/scheduling-eviction/scheduling-framework/#queueinghint),
which benefits to reduce the useless requeueing.
The scheduler retries scheduling pods if something changes in the cluster that could make the pod scheduled.
Queueing hints are internal signals that allow the scheduler to filter the changes in the cluster
Expand Down