Skip to content

Commit 50c9876

Browse files
committed
4033: update to GA
Signed-off-by: Peter Hunt <pehunt@redhat.com>
1 parent 450bed9 commit 50c9876

File tree

3 files changed

+26
-6
lines changed

3 files changed

+26
-6
lines changed

content/en/docs/reference/command-line-tools-reference/feature-gates/KubeletCgroupDriverFromCRI.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,27 @@ stages:
1313
- stage: beta
1414
defaultValue: true
1515
fromVersion: "1.31"
16+
- stage: stable
17+
defaultValue: true
18+
fromVersion: "1.34"
1619
---
1720
Enable detection of the kubelet cgroup driver
1821
configuration option from the {{<glossary_tooltip term_id="cri" text="CRI">}}.
19-
You can use this feature gate on nodes with a kubelet that supports the feature gate
20-
and where there is a CRI container runtime that supports the `RuntimeConfig`
21-
CRI call. If both CRI and kubelet support this feature, the kubelet ignores the
22+
This feature gate is now on for all clusters. However, it only works on nodes
23+
where there is a CRI container runtime that supports the `RuntimeConfig`
24+
CRI call. If the CRI supports this feature, the kubelet ignores the
2225
`cgroupDriver` configuration setting (or deprecated `--cgroup-driver` command
23-
line argument). If you enable this feature gate and the container runtime
26+
line argument). If the container runtime
2427
doesn't support it, the kubelet falls back to using the driver configured using
2528
the `cgroupDriver` configuration setting.
29+
The kubelet will stop falling back to this configuration in Kubernetes 1.36.
30+
Thus, users must upgrade their CRI container runtime to a version that supports
31+
the `RuntimeConfig` CRI call by then. Admins can use the metric
32+
`kubelet_cri_losing_support` to see if there are any nodes in their cluster that
33+
will lose support in 1.36. The following CRI versions support this CRI call:
34+
35+
* containerd: Support was added in v2.0.0
36+
* CRI-O: Support was added in v1.28.0
37+
2638
See [Configuring a cgroup driver](/docs/tasks/administer-cluster/kubeadm/configure-cgroup-driver)
27-
for more details.
39+
for more details.

content/en/docs/reference/command-line-tools-reference/kubelet.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -420,7 +420,7 @@ JobBackoffLimitPerIndex=true|false (BETA - default=true)<br/>
420420
JobManagedBy=true|false (ALPHA - default=false)<br/>
421421
JobPodReplacementPolicy=true|false (BETA - default=true)<br/>
422422
JobSuccessPolicy=true|false (BETA - default=true)<br/>
423-
KubeletCgroupDriverFromCRI=true|false (BETA - default=true)<br/>
423+
KubeletCgroupDriverFromCRI=true|false (STABLE - default=true)<br/>
424424
KubeletCrashLoopBackOffMax=true|false (ALPHA - default=false)<br/>
425425
KubeletFineGrainedAuthz=true|false (ALPHA - default=false)<br/>
426426
KubeletInUserNamespace=true|false (ALPHA - default=false)<br/>

content/en/docs/setup/production-environment/container-runtimes.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -153,6 +153,14 @@ enabled and a container runtime that supports the `RuntimeConfig` CRI RPC,
153153
the kubelet automatically detects the appropriate cgroup driver from the runtime,
154154
and ignores the `cgroupDriver` setting within the kubelet configuration.
155155

156+
However, older versions of container runtimes (specifically,
157+
containerd 1.y and below) do not support the `RuntimeConfig` CRI RPC, and
158+
may not respond correctly to this query, and thus the Kubelet falls back to using the
159+
value in its own `--cgroup-driver` flag.
160+
161+
In Kubernetes 1.36, this fallback behavior will be dropped, and older versions
162+
of containerd will fail with newer kubelets.
163+
156164
{{< caution >}}
157165
Changing the cgroup driver of a Node that has joined a cluster is a sensitive operation.
158166
If the kubelet has created Pods using the semantics of one cgroup driver, changing the container

0 commit comments

Comments
 (0)