kubernetes-client/c
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #87 from ityuhui/yh-versioning-1019

Browse Source 
[Doc] Add versioning-and-compatibility.md
This commit is contained in:
Kubernetes Prow Robot
2021-10-20 06:55:58 -07:00
committed by GitHub
parent 871d41973f 5d36be2fa1
commit 5d2e2026eb
1 changed files with 26 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
docs/versioning-and-compatibility.md Normal file
View File

@@ -0,0 +1,26 @@
# 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
| client version | 1.17 | 1.18 | 1.19 | 1.20 | 1.21 | 1.22 |
|------------------|-----------|----------|----------|----------|----------|----------|
| 0.1.0 | ✓ | - | - | x | x | x |
| HEAD | + | + | + | + | + | ✓ |
Key:
* `✓` Exactly the same features / API objects in both java-client and the Kubernetes
version.
* `+` c-client has features or api objects that may not be present in the
Kubernetes cluster, but everything they have in common will work.
* `-` The Kubernetes cluster has features the c-client library can't use
(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
later server versions won't function correctly.