Skip to content

Commit d96a6d0

Browse files
improve version support documentation
1 parent cca725c commit d96a6d0

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

docs/book/src/reference/versions.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,27 @@ All Infrastructure Providers are maintained by independent teams. Other Bootstra
1515

1616
## Supported Kubernetes Versions
1717

18-
The project aims to keep the current minor release compatible with the actively supported Kubernetes minor releases, i.e., the current release (N), N-1, and N-2. To find out the exact range of Kubernetes versions supported by each component, please see the [tables](#release-components) below.
18+
The project aims to keep the current minor release compatible with the actively supported Kubernetes minor releases, i.e.,
19+
the current release (N), N-1, and N-2. Where possible we will go above and beyond this trying to help our users support
20+
both newer and older versions of Kubernetes:
21+
22+
- For a given Cluster API minor release, we give best-effort support for future Kubernetes versions that are released
23+
during the release's active support period. Depending on the changes made in Kubernetes, users may be required to
24+
update to the next patch release of Cluster API to maintain compatibility.
25+
- In some cases where support for future Kubernetes versions can't be added, or is considered not practical or too risky
26+
adding it, the Kubernetes version support matrix for an existing Cluster API minor release will stop at the last supported version.
27+
- Cluster API offers best-effort support for older Kubernetes versions where possible.
28+
Important! this is not a replacement/alternative for upstream Kubernetes support policies!
29+
Support for older version of Kubernetes is limited to "Cluster API can start a Cluster with this Kubernetes version"
30+
and "Cluster API can upgrade to the next Kubernetes version"; it does not include any extended support to Kubernetes itself.
31+
32+
Whenever a new Cluster API release is cut, we will document the Kubernetes version compatibility matrix the release
33+
has been tested with. Summaries of Kubernetes versions supported by each component are additionally maintained in
34+
the [tables](#release-components) below.
35+
36+
On a final comment, let's praise all the contributors keeping care of such a wide support matrix.
37+
If someone is looking for opportunities to help with the project, this is definitely an area where additional hands
38+
and eyes will be more than welcome and greatly beneficial to the entire community.
1939

2040
See the [following section](#kubernetes-version-support-as-a-function-of-cluster-topology) to understand how cluster topology affects version support.
2141

0 commit comments

Comments
 (0)