{"id":37132580,"url":"https://github.com/tilt-dev/client-go","last_synced_at":"2026-01-14T15:28:09.564Z","repository":{"id":42652225,"uuid":"236089144","full_name":"tilt-dev/client-go","owner":"tilt-dev","description":"Go client for Kubernetes.","archived":false,"fork":true,"pushed_at":"2023-02-25T00:46:38.000Z","size":20408,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-11-22T13:07:18.989Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"kubernetes/client-go","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tilt-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_CONTACTS","support":null}},"created_at":"2020-01-24T21:48:04.000Z","updated_at":"2020-01-24T21:48:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tilt-dev/client-go","commit_stats":null,"previous_names":["windmilleng/client-go"],"tags_count":100,"template":false,"template_full_name":null,"purl":"pkg:github/tilt-dev/client-go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilt-dev%2Fclient-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilt-dev%2Fclient-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilt-dev%2Fclient-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilt-dev%2Fclient-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tilt-dev","download_url":"https://codeload.github.com/tilt-dev/client-go/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilt-dev%2Fclient-go/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28424374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T13:30:50.153Z","status":"ssl_error","status_checked_at":"2026-01-14T13:29:08.907Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-14T15:28:09.092Z","updated_at":"2026-01-14T15:28:09.558Z","avatar_url":"https://github.com/tilt-dev.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# client-go\n\nGo clients for talking to a [kubernetes](http://kubernetes.io/) cluster.\n\nWe recommend using the `v0.x.y` tags for Kubernetes releases \u003e= `v1.17.0` and\n`kubernetes-1.x.y` tags for Kubernetes releases \u003c `v1.17.0`.\nSee [INSTALL.md](/INSTALL.md) for detailed installation instructions.\n`go get k8s.io/client-go@master` works, but will fetch `master`, which may be less stable than a tagged release.\n\n[![BuildStatus Widget]][BuildStatus Result]\n[![GoReport Widget]][GoReport Status]\n[![GoDocWidget]][GoDocReference]\n\n[BuildStatus Result]: https://travis-ci.org/kubernetes/client-go\n[BuildStatus Widget]: https://travis-ci.org/kubernetes/client-go.svg?branch=master\n\n[GoReport Status]: https://goreportcard.com/report/github.com/kubernetes/client-go\n[GoReport Widget]: https://goreportcard.com/badge/github.com/kubernetes/client-go\n\n[GoDocWidget]: https://godoc.org/k8s.io/client-go?status.svg\n[GoDocReference]:https://godoc.org/k8s.io/client-go \n\n## Table of Contents\n\n- [What's included](#whats-included)\n- [Versioning](#versioning)\n  - [Compatibility: your code \u003c-\u003e client-go](#compatibility-your-code---client-go)\n  - [Compatibility: client-go \u003c-\u003e Kubernetes clusters](#compatibility-client-go---kubernetes-clusters)\n  - [Compatibility matrix](#compatibility-matrix)\n  - [Why do the 1.4 and 1.5 branch contain top-level folder named after the version?](#why-do-the-14-and-15-branch-contain-top-level-folder-named-after-the-version)\n- [Kubernetes tags](#kubernetes-tags)\n- [How to get it](#how-to-get-it)\n- [How to use it](#how-to-use-it)\n- [Dependency management](#dependency-management)\n- [Contributing code](#contributing-code)\n\n### What's included\n\n* The `kubernetes` package contains the clientset to access Kubernetes API.\n* The `discovery` package is used to discover APIs supported by a Kubernetes API server.\n* The `dynamic` package contains a dynamic client that can perform generic operations on arbitrary Kubernetes API objects.\n* The `plugin/pkg/client/auth` packages contain optional authentication plugins for obtaining credentials from external sources.\n* The `transport` package is used to set up auth and start a connection.\n* The `tools/cache` package is useful for writing controllers.\n\n### Versioning\n\n- For each `v1.x.y` Kubernetes release, the major version (first digit)\nwould remain `0`.\n\n- Bugfixes will result in the patch version (third digit) changing. PRs that are\ncherry-picked into an older Kubernetes release branch will result in an update\nto the corresponding branch in `client-go`, with a corresponding new tag\nchanging the patch version.\n\n#### Branches and tags.\n\nWe will create a new branch and tag for each increment in the minor version\nnumber. We will create only a new tag for each increment in the patch\nversion number. See [semver](http://semver.org/) for definitions of major,\nminor, and patch.\n\nThe HEAD of the master branch in client-go will track the HEAD of the master\nbranch in the main Kubernetes repo.\n\n#### Compatibility: your code \u003c-\u003e client-go\n\nThe `v0.x.y` tags indicate that go APIs may change in incompatible ways in\ndifferent versions.\n\nSee [INSTALL.md](INSTALL.md) for guidelines on requiring a specific\nversion of client-go.\n\n#### Compatibility: client-go \u003c-\u003e Kubernetes clusters\n\nSince Kubernetes is backwards compatible with clients, older `client-go`\nversions will work with many different Kubernetes cluster versions.\n\nWe will backport bugfixes--but not new features--into older versions of\n`client-go`.\n\n\n#### Compatibility matrix\n\n|                               | Kubernetes 1.15 | Kubernetes 1.16 | Kubernetes 1.17 |\n|-------------------------------|-----------------|-----------------|-----------------|\n| `kubernetes-1.15.0`           | ✓               | +-              | +-              |\n| `kubernetes-1.16.0`           | +-              | ✓               | +-              |\n| `kubernetes-1.17.0`/`v0.17.0` | +-              | +-              | ✓               |\n| `HEAD`                        | +-              | +-              | +-              |\n\nKey:\n\n* `✓` Exactly the same features / API objects in both client-go and the Kubernetes\n  version.\n* `+` client-go has features or API objects that may not be present in the\n  Kubernetes cluster, either due to that client-go has additional new API, or\n  that the server has removed old API. However, everything they have in\n  common (i.e., most APIs) will work. Please note that alpha APIs may vanish or\n  change significantly in a single release.\n* `-` The Kubernetes cluster has features the client-go library can't use,\n  either due to the server has additional new API, or that client-go has\n  removed old API. However, everything they share in common (i.e., most APIs)\n  will work.\n\nSee the [CHANGELOG](./CHANGELOG.md) for a detailed description of changes\nbetween client-go versions.\n\n| Branch         | Canonical source code location       | Maintenance status            |\n|----------------|--------------------------------------|-------------------------------|\n| `release-1.4`  | Kubernetes main repo, 1.4 branch     | = -                           |\n| `release-1.5`  | Kubernetes main repo, 1.5 branch     | = -                           |\n| `release-2.0`  | Kubernetes main repo, 1.5 branch     | = -                           |\n| `release-3.0`  | Kubernetes main repo, 1.6 branch     | = -                           |\n| `release-4.0`  | Kubernetes main repo, 1.7 branch     | = -                           |\n| `release-5.0`  | Kubernetes main repo, 1.8 branch     | = -                           |\n| `release-6.0`  | Kubernetes main repo, 1.9 branch     | = -                           |\n| `release-7.0`  | Kubernetes main repo, 1.10 branch    | = -                           |\n| `release-8.0`  | Kubernetes main repo, 1.11 branch    | =-                            |\n| `release-9.0`  | Kubernetes main repo, 1.12 branch    | =-                            |\n| `release-10.0` | Kubernetes main repo, 1.13 branch    | =-                            |\n| `release-11.0` | Kubernetes main repo, 1.14 branch    | ✓                             |\n| `release-12.0` | Kubernetes main repo, 1.15 branch    | ✓                             |\n| `release-13.0` | Kubernetes main repo, 1.16 branch    | ✓                             |\n| `release-14.0` | Kubernetes main repo, 1.17 branch    | ✓                             |\n| client-go HEAD | Kubernetes main repo, master branch  | ✓                             |\n\nKey:\n\n* `✓` Changes in main Kubernetes repo are actively published to client-go by a bot\n* `=` Maintenance is manual, only severe security bugs will be patched.\n* `-` Deprecated; please upgrade.\n\n#### Deprecation policy\n\nWe will maintain branches for at least six months after their first stable tag\nis cut. (E.g., the clock for the release-2.0 branch started ticking when we\ntagged v2.0.0, not when we made the first alpha.) This policy applies to\nevery version greater than or equal to 2.0.\n\n#### Why do the 1.4 and 1.5 branch contain top-level folder named after the version?\n\nFor the initial release of client-go, we thought it would be easiest to keep\nseparate directories for each minor version. That soon proved to be a mistake.\nWe are keeping the top-level folders in the 1.4 and 1.5 branches so that\nexisting users won't be broken.\n\n### Kubernetes tags\n\nThis repository is still a mirror of\n[k8s.io/kubernetes/staging/src/client-go](https://github.com/kubernetes/kubernetes/tree/master/staging/src/k8s.io/client-go),\nthe code development is still done in the staging area.\n\nSince Kubernetes `v1.8.0`, when syncing the code from the staging area,\nwe also sync the Kubernetes version tags to client-go, prefixed with\n`kubernetes-`. From Kubernetes `v1.17.0`, we also create matching semver\n`v0.x.y` tags for each `v1.x.y` Kubernetes release.\n\nFor example, if you check out the `kubernetes-1.17.0` or the `v0.17.0` tag in\nclient-go, the code you get is exactly the same as if you check out the `v1.17.0`\ntag in Kubernetes, and change directory to `staging/src/k8s.io/client-go`.\n\nThe purpose is to let users quickly find matching commits among published repos,\nlike [sample-apiserver](https://github.com/kubernetes/sample-apiserver),\n[apiextension-apiserver](https://github.com/kubernetes/apiextensions-apiserver),\netc. The Kubernetes version tag does NOT claim any backwards compatibility\nguarantees for client-go. Please check the [semantic versions](#versioning) if\nyou care about backwards compatibility.\n\n### How to get it\n\nUse go1.11+ and fetch the desired version using the `go get` command. For example:\n\n```\ngo get k8s.io/client-go@v0.17.0\n```\n\nSee [INSTALL.md](/INSTALL.md) for detailed instructions.\n\n### How to use it\n\nIf your application runs in a Pod in the cluster, please refer to the\nin-cluster [example](examples/in-cluster-client-configuration), otherwise please\nrefer to the out-of-cluster [example](examples/out-of-cluster-client-configuration).\n\n### Dependency management\n\nFor details on how to correctly use a dependency management for installing client-go, please see [INSTALL.md](INSTALL.md).\n\n### Contributing code\nPlease send pull requests against the client packages in the Kubernetes main [repository](https://github.com/kubernetes/kubernetes). Changes in the staging area will be published to this repository every day.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftilt-dev%2Fclient-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftilt-dev%2Fclient-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftilt-dev%2Fclient-go/lists"}