Skip to content

Commit c858733

Browse files
authored
Merge pull request #8150 from k8s-infra-cherrypick-robot/cherry-pick-8117-to-release-1.3
[release-1.3] 📖 docs: document plan to remove v1alpha3 and v1alpha4 apiVersions
2 parents c35c5b4 + b36ee24 commit c858733

File tree

1 file changed

+17
-5
lines changed

1 file changed

+17
-5
lines changed

CONTRIBUTING.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -139,11 +139,11 @@ Cluster API maintains the most recent release/releases for all supported API and
139139
- The API version is determined from the GroupVersion defined in the top-level `api/` package.
140140
- The EOL date of each API Version is determined from the last release available once a new API version is published.
141141

142-
| API Version | Supported Until |
143-
|--------------|----------------------|
144-
| **v1beta1** | TBD (current stable) |
145-
| **v1alpha4** | EOL since 2022-04-06 |
146-
| **v1alpha3** | EOL since 2022-02-23 |
142+
| API Version | Supported Until |
143+
|--------------|-----------------------------------------------------------------------------------------|
144+
| **v1beta1** | TBD (current stable) |
145+
| **v1alpha4** | EOL since 2022-04-06 ([apiVersion removal](#removal-of-v1alpha3--v1alpha4-apiversions)) |
146+
| **v1alpha3** | EOL since 2022-02-23 ([apiVersion removal](#removal-of-v1alpha3--v1alpha4-apiversions)) |
147147

148148
- For the latest API version we support the two most recent minor releases; older minor releases are immediately unsupported when a new major/minor release is available.
149149
- For older API versions we only support the most recent minor release until the API version reaches EOL.
@@ -161,6 +161,18 @@ Cluster API maintains the most recent release/releases for all supported API and
161161

162162
- Exceptions can be filed with maintainers and taken into consideration on a case-by-case basis.
163163

164+
### Removal of v1alpha3 & v1alpha4 apiVersions
165+
166+
We are going to remove the apiVersions in upcoming releases:
167+
* v1.5:
168+
* Kubernetes API server will stop serving the v1alpha3 apiVersion
169+
* v1.6:
170+
* v1alpha3 apiVersion will be removed from the CRDs
171+
* Kubernetes API server will stop serving the v1alpha4 apiVersion
172+
* v1.7
173+
* v1alpha4 apiVersion will be removed from the CRDs
174+
For more details and latest information please see the following issue: [Removing v1alpha3 & v1alpha4 apiVersions](https://github.com/kubernetes-sigs/cluster-api/issues/8038).
175+
164176
## Contributing a Patch
165177

166178
1. If you haven't already done so, sign a Contributor License Agreement (see details above).

0 commit comments

Comments
 (0)