kubernetes/client-go

The kubernetes/client-go project is a Go library for communicating with a Kubernetes cluster. It includes clients for accessing the Kubernetes API, discovery of supported APIs, dynamic client for performing generic operations on arbitrary Kubernetes API objects, authentication plugins, and tools for caching.

The library follows semantic versioning, with major version remaining 0 for each Kubernetes release. Bugfixes result in patch version changes, while minor and major version changes result in new branches and tags. Older client-go versions are compatible with many different Kubernetes cluster versions, and bugfixes are backported into older versions.

To get the latest version, use go get k8s.io/client-go@latest with Go 1.16 or higher. For specific versions, use go get with the desired version number. Detailed installation instructions and troubleshooting can be found in the [INSTALL.md](/INST applications/client-go/INSTALL.md) file.

The library includes the kubernetes, discovery, dynamic, plugin/pkg/client/auth, and transport packages, as well as the tools/cache package for writing controllers.

For in-cluster usage, refer to the in-cluster example. For out-of-cluster usage, refer to the out-of-cluster example.

For dependency management, please see the INSTALL.md file for details. To contribute code, send pull requests against the client packages in the Kubernetes main repository. Changes in the staging area are published to this repository daily.