{"id":13493921,"url":"https://github.com/kubernetes-sigs/controller-runtime","last_synced_at":"2025-05-13T20:18:35.864Z","repository":{"id":37359590,"uuid":"136494223","full_name":"kubernetes-sigs/controller-runtime","owner":"kubernetes-sigs","description":"Repo for the controller-runtime subproject of kubebuilder (sig-apimachinery)","archived":false,"fork":false,"pushed_at":"2025-05-13T15:13:21.000Z","size":48245,"stargazers_count":2707,"open_issues_count":99,"forks_count":1204,"subscribers_count":63,"default_branch":"main","last_synced_at":"2025-05-13T15:56:34.985Z","etag":null,"topics":["k8s-sig-api-machinery"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kubernetes-sigs.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-06-07T15:08:03.000Z","updated_at":"2025-05-13T15:13:25.000Z","dependencies_parsed_at":"2023-10-16T13:16:27.890Z","dependency_job_id":"ff1defe7-4982-430b-b452-79ea41bdcb36","html_url":"https://github.com/kubernetes-sigs/controller-runtime","commit_stats":{"total_commits":1744,"total_committers":360,"mean_commits":4.844444444444444,"dds":0.9030963302752294,"last_synced_commit":"ced7381c313be89409eed07e74f9cd21202e1e36"},"previous_names":[],"tags_count":146,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcontroller-runtime","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcontroller-runtime/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcontroller-runtime/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcontroller-runtime/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubernetes-sigs","download_url":"https://codeload.github.com/kubernetes-sigs/controller-runtime/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254020659,"owners_count":22000757,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["k8s-sig-api-machinery"],"created_at":"2024-07-31T19:01:20.031Z","updated_at":"2025-05-13T20:18:35.835Z","avatar_url":"https://github.com/kubernetes-sigs.png","language":"Go","funding_links":[],"categories":["Go","Operator Frameworks","Frameworks / Libraries","Repos"],"sub_categories":[],"readme":"[![Go Report Card](https://goreportcard.com/badge/sigs.k8s.io/controller-runtime)](https://goreportcard.com/report/sigs.k8s.io/controller-runtime)\n[![godoc](https://pkg.go.dev/badge/sigs.k8s.io/controller-runtime)](https://pkg.go.dev/sigs.k8s.io/controller-runtime)\n\n# Kubernetes controller-runtime Project\n\nThe Kubernetes controller-runtime Project is a set of go libraries for building\nControllers. It is leveraged by [Kubebuilder](https://book.kubebuilder.io/) and\n[Operator SDK](https://github.com/operator-framework/operator-sdk). Both are\na great place to start for new projects. See\n[Kubebuilder's Quick Start](https://book.kubebuilder.io/quick-start.html) to\nsee how it can be used.\n\nDocumentation:\n\n- [Package overview](https://pkg.go.dev/sigs.k8s.io/controller-runtime/pkg)\n- [Basic controller using builder](https://pkg.go.dev/sigs.k8s.io/controller-runtime/pkg/builder#example-Builder)\n- [Creating a manager](https://pkg.go.dev/sigs.k8s.io/controller-runtime/pkg/manager#example-New)\n- [Creating a controller](https://pkg.go.dev/sigs.k8s.io/controller-runtime/pkg/controller#example-New)\n- [Examples](https://github.com/kubernetes-sigs/controller-runtime/blob/main/examples)\n- [Designs](https://github.com/kubernetes-sigs/controller-runtime/blob/main/designs)\n\n# Versioning, Maintenance, and Compatibility\n\nThe full documentation can be found at [VERSIONING.md](VERSIONING.md), but TL;DR:\n\nUsers:\n\n- We follow [Semantic Versioning (semver)](https://semver.org)\n- Use releases with your dependency management to ensure that you get compatible code\n- The main branch contains all the latest code, some of which may break compatibility (so \"normal\" `go get` is not recommended)\n\nContributors:\n\n- All code PR must be labeled with :bug: (patch fixes), :sparkles: (backwards-compatible features), or :warning: (breaking changes)\n- Breaking changes will find their way into the next major release, other changes will go into an semi-immediate patch or minor release\n- For a quick PR template suggesting the right information, use one of these PR templates:\n  * [Breaking Changes/Features](/.github/PULL_REQUEST_TEMPLATE/breaking_change.md)\n  * [Backwards-Compatible Features](/.github/PULL_REQUEST_TEMPLATE/compat_feature.md)\n  * [Bug fixes](/.github/PULL_REQUEST_TEMPLATE/bug_fix.md)\n  * [Documentation Changes](/.github/PULL_REQUEST_TEMPLATE/docs.md)\n  * [Test/Build/Other Changes](/.github/PULL_REQUEST_TEMPLATE/other.md)\n\n## Compatibility\n\nEvery minor version of controller-runtime has been tested with a specific minor version of client-go. A controller-runtime minor version *may* be compatible with\nother client-go minor versions, but this is by chance and neither supported nor tested. In general, we create one minor version of controller-runtime\nfor each minor version of client-go and other k8s.io/* dependencies.\n\nThe minimum Go version of controller-runtime is the highest minimum Go version of our Go dependencies. Usually, this will\nbe identical to the minimum Go version of the corresponding k8s.io/* dependencies.\n\nCompatible k8s.io/*, client-go and minimum Go versions can be looked up in our [go.mod](go.mod) file.\n\n|          | k8s.io/*, client-go | minimum Go version |\n|----------|:-------------------:|:------------------:|\n| CR v0.20 |        v0.32        |        1.23        |\n| CR v0.19 |        v0.31        |        1.22        |\n| CR v0.18 |        v0.30        |        1.22        |\n| CR v0.17 |        v0.29        |        1.21        |\n| CR v0.16 |        v0.28        |        1.20        |\n| CR v0.15 |        v0.27        |        1.20        |\n\n## FAQ\n\nSee [FAQ.md](FAQ.md)\n\n## Community, discussion, contribution, and support\n\nLearn how to engage with the Kubernetes community on the [community page](http://kubernetes.io/community/).\n\nYou can reach the maintainers of this project at:\n\n- Slack channel: [#controller-runtime](https://kubernetes.slack.com/archives/C02MRBMN00Z)\n- Google Group: [kubebuilder@googlegroups.com](https://groups.google.com/forum/#!forum/kubebuilder)\n\n## Contributing\n\nContributions are greatly appreciated. The maintainers actively manage the issues list, and try to highlight issues suitable for newcomers.\nThe project follows the typical GitHub pull request model. See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.\nBefore starting any work, please either comment on an existing issue, or file a new one.\n\n## Code of conduct\n\nParticipation in the Kubernetes community is governed by the [Kubernetes Code of Conduct](code-of-conduct.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fcontroller-runtime","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubernetes-sigs%2Fcontroller-runtime","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fcontroller-runtime/lists"}