Skip to content

Commit 0b216d8

Browse files
committed
update the kep to move to remove cgroup v1 support as our end goal
1 parent d5b2be7 commit 0b216d8

File tree

2 files changed

+32
-15
lines changed

2 files changed

+32
-15
lines changed

keps/sig-node/5573-cgroup-v1-unsupported/README.md

Lines changed: 30 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# KEP-5573: Move cgroup v1 to unsupported
1+
# KEP-5573: Remove cgroup v1
22

33
<!-- toc -->
44
- [Release Signoff Checklist](#release-signoff-checklist)
@@ -9,18 +9,18 @@
99
- [Proposal](#proposal)
1010
- [Risks and Mitigations](#risks-and-mitigations)
1111
- [Design Details](#design-details)
12-
- [Enable fail-cgroup-v1 by default](#enable-fail-cgroup-v1-by-default)
12+
- [Enable FailCgroupV1 by default](#enable-failcgroupv1-by-default)
1313
- [Update warning messages and events](#update-warning-messages-and-events)
1414
- [Documentation updates](#documentation-updates)
15+
- [Removal of cgroup v1](#removal-of-cgroup-v1)
1516
- [Test Plan](#test-plan)
1617
- [Prerequisite testing updates](#prerequisite-testing-updates)
1718
- [Unit tests](#unit-tests)
1819
- [Integration tests](#integration-tests)
1920
- [e2e tests](#e2e-tests)
2021
- [Graduation Criteria](#graduation-criteria)
21-
- [Alpha](#alpha)
2222
- [Beta](#beta)
23-
- [GA](#ga)
23+
- [Stable](#stable)
2424
- [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy)
2525
- [Version Skew Strategy](#version-skew-strategy)
2626
- [Production Readiness Review Questionnaire](#production-readiness-review-questionnaire)
@@ -75,7 +75,11 @@ Items marked with (R) are required *prior to targeting to a milestone / release*
7575

7676
## Summary
7777

78-
Formally move cgroup v1 into an unsupported state in Kubernetes, building upon the maintenance mode introduced in KEP-4569. This enhancement will disable cgroup v1 support by default and provide clear messaging that cgroup v1 is no longer supported.
78+
Remove cgroup v1 support from Kubernetes codebase, building upon the maintenance mode introduced in KEP-4569. This enhancement will remove cgroup v1 support.
79+
80+
This KEP will have a phased approach where beta will prevent kubelet from starting on a cgroup v1 node.
81+
82+
In n+3 releases, we will remove the cgroup v1 code.
7983

8084
## Motivation
8185

@@ -84,10 +88,10 @@ Following the transition of cgroup v1 support to maintenance mode in KEP-4569, t
8488
The motivation builds on the rationale established in KEP-4569:
8589
- The Linux kernel community has made cgroup v2 the focus for new features
8690
- Major Linux distributions are phasing out cgroup v1 support
87-
- systemd and other critical components are moving beyond cgroup v1
91+
- [systemd](https://github.com/systemd/systemd/releases/tag/v258) and other critical components are moving beyond cgroup v1
8892
- cgroup v2 offers better functionality, more consistent interfaces, and improved scalability
8993

90-
By formally moving cgroup v1 to unsupported status, Kubernetes provides a clear signal to the community about the deprecation path and encourages migration to the more secure and efficient cgroup v2 technology.
94+
By removing cgroup v1, Kubernetes provides a clear signal to the community about the removal path and encourages migration to the more secure and efficient cgroup v2 technology.
9195

9296
### Goals
9397

@@ -103,15 +107,16 @@ By formally moving cgroup v1 to unsupported status, Kubernetes provides a clear
103107

104108
6. **Remove testing cgroup v1**: Moving to unsupported means that Kubernetes will no longer run tests on cgroup v1 nodes.
105109

110+
7. **Remove cgroup v1 code**: Removing the code is the next logic step once we stop testing it. This will clean up
111+
the codebase.
112+
106113
### Non-Goals
107114

108-
- Complete removal of cgroup v1 code (this will be addressed in a future KEP)
109-
- Breaking existing clusters that explicitly enable cgroup v1 support
110-
- Removing the ability to override the default behavior
115+
NA.
111116

112117
## Proposal
113118

114-
This proposal builds upon the foundation laid by KEP-4569 (Moving cgroup v1 support into maintenance mode) and formally transitions cgroup v1 from maintenance mode to unsupported status.
119+
This proposal builds upon the foundation laid by KEP-4569 (Moving cgroup v1 support into maintenance mode) and formally removes cgroup v1 code from kubelet.
115120

116121
### Risks and Mitigations
117122

@@ -180,6 +185,14 @@ Update all relevant documentation across the Kubernetes ecosystem:
180185
- Release notes
181186
- Blog posts about the transition
182187

188+
### Removal of cgroup v1
189+
190+
<UNRESOLVED @haircommander>
191+
Once all supported releases of Kubernetes have `FailCGroupV1` set to true, we can begin the removal of the cgroup v1 support.
192+
193+
In this section, we should call the places where we are going to remove cgroup v1.
194+
</UNRESOLVED>
195+
183196
### Test Plan
184197

185198
<!--
@@ -249,13 +262,17 @@ We expect no non-infra related flakes in the last month as a GA graduation crite
249262

250263
### Graduation Criteria
251264

252-
#### GA
265+
#### Beta
253266

254267
- Default value for `FailCgroupV1` changed to `true`
255268
- Updated warning messages and events for unsupported status
256269
- Documentation updates in kubernetes/enhancements repository
257270
- All e2e testing removed for cgroup v1.
258271

272+
#### Stable
273+
274+
- Remove all cgroup v1 related code.
275+
259276
### Upgrade / Downgrade Strategy
260277

261278
<!--
@@ -460,7 +477,7 @@ This feature operates at the kubelet level and does not depend on API server or
460477

461478
## Implementation History
462479

463-
- **2025-09-26**: KEP for moving cgroup v1 to unsupported status created
480+
- **2025-09-26**: KEP for removing cgroup v1 created
464481

465482
## Drawbacks
466483

keps/sig-node/5573-cgroup-v1-unsupported/kep.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ approvers:
1616
- "@dchen1107"
1717

1818
# The target maturity stage in the current dev cycle for this KEP.
19-
stage: stable
19+
stage: beta
2020

2121
see-also: [
2222
"keps/sig-node/4569-cgroup-v1-maintenance-mode/README.md",
@@ -29,7 +29,7 @@ latest-milestone: "v1.35"
2929

3030
# The milestone at which this feature was, or is targeted to be, at each stage.
3131
milestone:
32-
stable: "v1.35"
32+
beta: "v1.35"
3333

3434
# The following PRR answers are required at alpha release
3535
# List the feature gate name and the components for which it must be enabled

0 commit comments

Comments
 (0)