+0
Daily
9,913
stars
3,025
forks
166
watchers
0
prs
0
issues
0
releases
README
⚠️ This is an automatically published staged repository for Kubernetes. Contributions, including issues and pull requests, should be made to the main Kubernetes repository: https://github.com/kubernetes/kubernetes. This repository is read-only for importing, and not used for direct contributions. See CONTRIBUTING.md for more details. client-go Go clients for talking to a kubernetes cluster. We recommend using the v0.x.y tags for Kubernetes releases = v1.17.0 and kubernetes-1.x.y tags for Kubernetes releases client-go - Compatibility: client-go Kubernetes clusters - Compatibility matrix - Why do the 1.4 and 1.5 branch contain top-level folder named after the version? - Kubernetes tags - How to get it - How to use it - Dependency management - Contributing code What's included The kubernetes package contains the clientset to access Kubernetes API. The discovery package is used to discover APIs supported by a Kubernetes API server. The dynamic package contains a dynamic client that can perform generic operations on arbitrary Kubernetes API objects. The plugin/pkg/client/auth packages contain optional authentication plugins for obtaining credentials from external sources. The transport package is used to set up auth and start a connection. The tools/cache package is useful for writing controllers. Versioning - For each v1.x.y Kubernetes release, the major version (first digit) would remain 0. - Bugfixes will result in the patch version (third digit) changing. PRs that are cherry-picked into an older Kubernetes release branch will result in an update to the corresponding branch in client-go, with a corresponding new tag changing the patch version. Branches and tags. We will create a new branch and tag for each increment in the minor version number. We will create only a new tag for each increment in the patch version number. See semver for definitions of major, minor, and patch. The HEAD of the master branch in client-go will track the HEAD of the master branch in the main Kubernetes repo. Compatibility: your code client-go The v0.x.y tags indicate that go APIs may change in incompatible ways in different versions. See INSTALL.md for guidelines on requiring a specific version of client-go. Compatibility: client-go Kubernetes clusters Since Kubernetes is backwards compatible with clients, older client-go versions will work with many different Kubernetes cluster versions. We will backport bugfixes--but not new features--into older versions of client-go. Compatibility matrix | | Kubernetes 1.29 | Kubernetes 1.30 | Kubernetes 1.31 | Kubernetes 1.32 | Kubernetes 1.33 | Kubernetes 1.34 | | ----------------------------- | --------------- | --------------- | --------------- | --------------- | --------------- | --------------- | | kubernetes-1.29.0/v0.29.0 | ✓ | +- | +- | +- | +- | +- | | kubernetes-1