kubernetes /client-go

Go client for Kubernetes.

★ 9,913⑂ 3,025👁 166⑃ 0● 0▤ 0
GoApache-2.0Created 2016-08-25
+0
日增长
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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON