Skip to content

Commit 71be489

Browse files
authored
Merge pull request #8659 from jackfrancis/ca-release-language
CA: Propose new release guidance
2 parents 6468783 + a3d1d3b commit 71be489

File tree

1 file changed

+35
-18
lines changed

1 file changed

+35
-18
lines changed

cluster-autoscaler/README.md

Lines changed: 35 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,7 @@ Starting from Kubernetes 1.12, versioning scheme was changed to match Kubernetes
5151

5252
| Kubernetes Version | CA Version | Chart Version |
5353
|--------------------|--------------------------|---------------|
54+
| 1.34.x | 1.34.x |9.51.0+|
5455
| 1.33.x | 1.33.x |9.47.0+|
5556
| 1.32.x | 1.32.x |9.45.0+|
5657
| 1.31.x | 1.31.x |9.38.0+|
@@ -86,24 +87,40 @@ Starting from Kubernetes 1.12, versioning scheme was changed to match Kubernetes
8687

8788
## Schedule
8889

89-
Cluster Autoscaler releases new minor versions shortly after OSS Kubernetes release
90-
and patches for versions corresponding to currently
91-
supported [Kubernetes versions](https://kubernetes.io/releases/) on a roughly 2
92-
month cadence. Currently planned schedule is below. Please note that target
93-
dates listed below are approximate and we expect up to a week difference between
94-
target ETA and the actual releases.
95-
96-
| Date | Maintainer Preparing Release | Backup Maintainer | Type |
97-
|------------|------------------------------|-------------------|-------|
98-
| 2025-06-11 | jackfrancis | gjtempleton | 1.33 |
99-
| 2025-07-16 | gjtempleton | towca | patch |
100-
| 2025-08-20 | towca | BigDarkClown | patch |
101-
| 2025-09-17 | BigDarkClown | x13n | 1.34 |
102-
| 2025-10-22 | x13n | jackfrancis | patch |
103-
| 2025-11-19 | jackfrancis | gjtempleton | patch |
104-
105-
Additional patch releases may happen outside of the schedule in case of critical
106-
bugs or vulnerabilities.
90+
Cluster Autoscaler synchronizes its releases with the [Kubernetes release schedule](https://kubernetes.io/releases/).
91+
92+
For Cluster Autoscaler releases of new minor versions, expect a release date of up to
93+
one month after the corresponding Kubernetes release. This is due the fact that upstream
94+
integrations of Kubernetes into Cluster Autoscaler can't be finalized until the Kubernetes
95+
release is official, and the time required to test and validate those integrations.
96+
97+
Cluster Autoscaler will also release patch versions in accordance with Kubernetes patch
98+
releases to ensure rapid integration of upstream Kubernetes fixes. The overhead to integrate
99+
and validate Kubernetes patch releases is less costly, and thus the Cluster Autoscaler
100+
release date should follow the corresponding Kubernetes release by no more than 1-2 weeks.
101+
102+
Bug fixes and Cloud Provider features to Cluster Autoscaler itself will be continually
103+
backported into the supported release branches (n - 3, where n is the latest release).
104+
Backporting into older release branches can be requested as an exception by filing an issue
105+
and bringing the request [to the official SIG Autoscaling Community](https://github.com/kubernetes/community/blob/master/sig-autoscaling/README.md).
106+
107+
Finally, additional Cluster Autoscaler patch releases may happen outside of the above schedule
108+
in case of critical bugs or vulnerabilities.
109+
110+
In summary, users should not be guided by a strict patch version equivalency between Kubernetes
111+
and Cluster Autoscaler (for example, there is no strict requirement to use Cluster Autoscaler v1.34.1 w/ a Kubernetes v1.34.1 cluster). Rather, we recommend that users always use the _latest_
112+
Cluster Autoscaler release that corresponds to the minor version of Kubernetes that their cluster
113+
is running.
114+
115+
For example, if the latest (hypothetical) Cluster Autoscaler releases are
116+
`v1.100.1`, `v1.99.5`, `v1.98.10`, and `v1.97.16`, any of the below scenarios follows the recommended guidance:
117+
118+
| Kubernetes Version | CA Version |
119+
|---------------------|--------------------------|
120+
| 1.100.0 | 1.100.1 |
121+
| 1.99.4 | 1.99.5 |
122+
| 1.98.4 | 1.98.10 |
123+
| 1.97.16 | 1.97.16 |
107124

108125
# Notable changes
109126

0 commit comments

Comments
 (0)