2021-10-19 13:55:02 +08:00
# Versioning and Compatibility
## Client versioning
The C client uses Semantic Versioning. We increment the major version number whenever we regenerate the client for a new Kubernetes release version (see table below). Whenever we do this there are new APIs added and possibly breaking changes in the generated Kubernetes API Stubs. Whenever you upgrade a major version, be prepared for potential breaking changes.
## Compatibility
2024-10-17 19:41:58 +08:00
| client version | 1.28 | 1.29 | 1.30 | 1.31 |
|------------------|----------|----------|-----------|-----------|
| 0.10.0 | + | + | ✓ | - |
| 0.11.0 | + | + | + | ✓ |
| HEAD | + | + | + | ✓ |
2024-09-10 14:33:21 +08:00
2024-05-21 17:17:42 +08:00
| client version | 1.17 | 1.18 | 1.19 | 1.20 | 1.21 | 1.22 | 1.23 | 1.24 | 1.25 | 1.26 | 1.27 | 1.28 | 1.29 | 1.30 |
|------------------|-----------|----------|----------|----------|----------|----------|----------|----------|----------|----------|----------|----------|----------|----------|
| 0.1.0 | ✓ | - | - | x | x | x | x | x | x | x | x | x | x | x |
| 0.2.0 | + | + | + | + | + | ✓ | - | - | x | x | x | x | x | x |
| 0.3.0 | + | + | + | + | + | + | ✓ | - | - | x | x | x | x | x |
| 0.4.0 | + | + | + | + | + | + | + | ✓ | - | - | x | x | x | x |
| 0.5.0 | + | + | + | + | + | + | + | + | ✓ | - | - | x | x | x |
| 0.6.0 | + | + | + | + | + | + | + | + | + | ✓ | - | - | x | x |
| 0.7.0 | + | + | + | + | + | + | + | + | + | + | ✓ | - | - | x |
| 0.8.0 | + | + | + | + | + | + | + | + | + | + | + | ✓ | - | - |
| 0.9.0 | + | + | + | + | + | + | + | + | + | + | + | + | ✓ | - |
2021-10-19 13:55:02 +08:00
2023-09-06 12:09:59 +08:00
Key:
2021-10-19 13:55:02 +08:00
2022-01-22 10:44:41 +08:00
* `✓` Exactly the same features / API objects in both the C client and the Kubernetes
2021-10-19 13:55:02 +08:00
version.
2022-01-22 10:44:41 +08:00
* `+` The C client has features or api objects that may not be present in the
2021-10-19 13:55:02 +08:00
Kubernetes cluster, but everything they have in common will work.
2022-01-22 10:44:41 +08:00
* `-` The Kubernetes cluster has features the C client library can't use
2021-10-19 13:55:02 +08:00
(additional API objects, etc).
* `x` The Kubernetes cluster has no guarantees to support the API client of
this version, as it only promises _n_ -2 version support. It is not tested,
and operations using API versions that have been deprecated and removed in
2023-09-06 12:09:59 +08:00
later server versions won't function correctly.
