From 2520994c317f8c04235ebdfa98ca350d96e29034 Mon Sep 17 00:00:00 2001 From: Kensei Nakada Date: Wed, 13 Dec 2023 17:45:25 +0900 Subject: [PATCH 1/3] Feature gate SchedulerQueueingHints is disabled by default --- .../concepts/scheduling-eviction/scheduling-framework.md | 6 ++++-- .../reference/command-line-tools-reference/feature-gates.md | 3 ++- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md b/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md index 0e4bcb22f52da..760ea8e3bb750 100644 --- a/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md +++ b/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md @@ -84,8 +84,10 @@ the Pod is put into the active queue or the backoff queue so that the scheduler will retry the scheduling of the Pod. {{< note >}} -QueueingHint evaluation during scheduling is a beta-level feature and is enabled by default in 1.28. -You can disable it via the +QueueingHint evaluation during scheduling is a beta-level feature. +It's enabled by default in 1.28.0 - 1.28.5, +but is disabled by default in 1.29 because of excessive memory footprint. +You can enable it via the `SchedulerQueueingHints` [feature gate](/docs/reference/command-line-tools-reference/feature-gates/). {{< /note >}} diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md index 6b891d9709012..d7c1a2f29a178 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates.md @@ -184,7 +184,8 @@ For a reference to old feature gates that are removed, please refer to | `SELinuxMountReadWriteOncePod` | `false` | Alpha | 1.25 | 1.26 | | `SELinuxMountReadWriteOncePod` | `false` | Beta | 1.27 | 1.27 | | `SELinuxMountReadWriteOncePod` | `true` | Beta | 1.28 | | -| `SchedulerQueueingHints` | `true` | Beta | 1.28 | | +| `SchedulerQueueingHints` | `true` | Beta | 1.28.0 | 1.28.5 | +| `SchedulerQueueingHints` | `false` | Beta | 1.29 | | | `SecurityContextDeny` | `false` | Alpha | 1.27 | | | `SeparateTaintEvictionController` | `true` | Beta | 1.29 | | | `ServiceAccountTokenJTI` | `false` | Alpha | 1.29 | | From bad6aa429e59e4ff6136034598fe9b5b98e810d8 Mon Sep 17 00:00:00 2001 From: Kat Cosgrove Date: Wed, 13 Dec 2023 15:01:03 +0000 Subject: [PATCH 2/3] Update content/en/docs/reference/command-line-tools-reference/feature-gates.md Co-authored-by: Tim Bannister --- .../reference/command-line-tools-reference/feature-gates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md index d7c1a2f29a178..3f118e64a8799 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates.md @@ -184,7 +184,7 @@ For a reference to old feature gates that are removed, please refer to | `SELinuxMountReadWriteOncePod` | `false` | Alpha | 1.25 | 1.26 | | `SELinuxMountReadWriteOncePod` | `false` | Beta | 1.27 | 1.27 | | `SELinuxMountReadWriteOncePod` | `true` | Beta | 1.28 | | -| `SchedulerQueueingHints` | `true` | Beta | 1.28.0 | 1.28.5 | +| `SchedulerQueueingHints` | `true` | Beta | 1.28 | 1.28 | | `SchedulerQueueingHints` | `false` | Beta | 1.29 | | | `SecurityContextDeny` | `false` | Alpha | 1.27 | | | `SeparateTaintEvictionController` | `true` | Beta | 1.29 | | From 9010b97f01c65bd37b5e25bcefdc72ea4daec7c2 Mon Sep 17 00:00:00 2001 From: Tim Bannister Date: Wed, 13 Dec 2023 15:20:36 +0000 Subject: [PATCH 3/3] Revise message Avoid mentioning change we expect for a future (patch) release --- .../concepts/scheduling-eviction/scheduling-framework.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md b/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md index 760ea8e3bb750..18cfece94c760 100644 --- a/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md +++ b/content/en/docs/concepts/scheduling-eviction/scheduling-framework.md @@ -85,8 +85,10 @@ so that the scheduler will retry the scheduling of the Pod. {{< note >}} QueueingHint evaluation during scheduling is a beta-level feature. -It's enabled by default in 1.28.0 - 1.28.5, -but is disabled by default in 1.29 because of excessive memory footprint. +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 `SchedulerQueueingHints` [feature gate](/docs/reference/command-line-tools-reference/feature-gates/). {{< /note >}}