{"full_name":"kubernetes-sigs/kubebuilder","owner":"kubernetes-sigs","name":"kubebuilder","shard":"1","url":"https://github.com/kubernetes-sigs/kubebuilder","description":"Kubebuilder - SDK for building Kubernetes APIs using CRDs","homepage":"http://book.kubebuilder.io","topics":["k8s-sig-api-machinery"],"tag_pages":[],"language":"Go","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/36015203?v=4","created_at":"2018-03-14T21:26:14Z","pushed_at":"2026-11-15T11:08:05Z","metrics":{"stars":9368,"forks":1715,"watchers":94,"issues":1865,"prs":4088,"releases":88,"issues_open":38,"issues_closed":1827,"prs_open":19,"prs_closed":763,"prs_merged":3306,"discussions":175},"growth":{"day":{"stars":0,"forks":0,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[9361,9364,9366,9366,9367,9368,9368],"forks":[1714,1713,1714,1714,1714,1715,1715],"watchers":[null,94,94,94,94,94,94],"issues_open":[null,35,36,36,35,35,38],"prs_open":[null,40,38,39,39,39,19]},"boards":{},"same_owner":[{"full_name":"kubernetes-sigs/descheduler","name":"descheduler","shard":"1","boards":{}},{"full_name":"kubernetes-sigs/external-dns","name":"external-dns","shard":"1","boards":{}},{"full_name":"kubernetes-sigs/kind","name":"kind","shard":"1","boards":{}},{"full_name":"kubernetes-sigs/kubespray","name":"kubespray","shard":"1","boards":{}}],"issues":[{"number":907,"title":"delete api command line","comments":29,"created_at":"2019-07-31T02:56:43Z"},{"number":5148,"title":"namespace override while running make deploy","comments":17,"created_at":"2025-10-27T15:58:33Z"},{"number":4809,"title":"Proposal: Integrate kube-api-linter into Kubebuilder via golangci-lint","comments":15,"created_at":"2025-05-19T07:04:38Z"},{"number":849,"title":"Feature Gates ","comments":10,"created_at":"2019-07-09T23:30:52Z"},{"number":5948,"title":"(helm/v2-alpha): Setting manager.envOverrides to a duplicate key fails with ssa","comments":9,"created_at":"2026-08-04T18:09:50Z"},{"number":5778,"title":"Support multiple GVKs in create API","comments":9,"created_at":"2026-06-18T19:45:16Z"},{"number":5390,"title":"helm/v2-alpha: Should the generated chart support installing Custom Resources (CRs)? If so, what is the recommended mechanism?","comments":9,"created_at":"2026-01-25T08:15:28Z"},{"number":5844,"title":"[Feature] Dynamic Helm Webhook Selectors","comments":6,"created_at":"2026-07-06T17:20:04Z"}],"discussions":[{"number":5717,"title":"Book Chapter on webhooks for multi version APIs is highly confusing to me","comments":1,"category":"Support","created_at":"2026-06-02T10:14:53Z"},{"number":5657,"title":"kubebuilder alpha update error","comments":1,"category":"Support","created_at":"2026-04-24T09:26:21Z"},{"number":5630,"title":"The perception that Kubebuilder is an \"anti-pattern\" in Go","comments":1,"category":"Support","created_at":"2026-04-16T06:56:16Z"},{"number":5542,"title":"Disable kustomize plugin","comments":1,"category":"Support","created_at":"2026-03-16T15:20:09Z"},{"number":5524,"title":"Don't fully understand Kubebuilder releases","comments":2,"category":"Support","created_at":"2026-03-01T12:25:41Z"},{"number":5386,"title":"Question: helm - CRDs for first installation","comments":6,"category":"Support","created_at":"2026-01-23T22:53:21Z"},{"number":5365,"title":"[PROPOSAL] Migrate template string constants to embedded files using `embed.FS`","comments":2,"category":"Polls","created_at":"2026-01-07T14:57:30Z"},{"number":5277,"title":"Proposal: Shift to a library-first architecture for v5","comments":4,"category":"Polls","created_at":"2025-12-16T20:02:00Z"}],"latest_release":{"name":"v4.16.0","tag":"v4.16.0","published_at":"2026-09-10T10:25:59Z","body":"## 🚀 Automation to Upgrade your Project\r\n\r\nThe [migration guide](https://book.kubebuilder.io/migrations.html) covers upgrading from any supported version to the latest release.\r\n\r\nFor the smoothest upgrade path, use the [AutoUpdate Plugin](https://book.kubebuilder.io/plugins/available/autoupdate-v1-alpha) or run [`kubebuilder alpha update`](https://book.kubebuilder.io/reference/commands/alpha_update). Both use the same update logic: they regenerate your project from scratch, reapply your changes, and bring in everything listed below. Your [PROJECT](https://book.kubebuilder.io/reference/project-config.html) file needs `cliVersion` for this to work.\r\n\r\nOther upgrade options are mainly intended for older projects that do not yet have `cliVersion` in their PROJECT file. These are the paths in the [migration guide](https://book.kubebuilder.io/migrations.html): follow the AI instructions, or make the changes by hand, to re-scaffold your project with the latest version and put your own changes back on top. Use them as a one-time step to reach a supported version, then continue using these update workflows.\r\n\r\n## ❗Recommended Scaffold Fixes to Apply\r\n\r\nThese are not breaking changes but are significant bug fixes. If you upgrade with [`alpha update`](https://book.kubebuilder.io/reference/commands/alpha_update.html) or the [AutoUpdate Plugin](https://book.kubebuilder.io/plugins/available/autoupdate-v1-alpha), you get them automatically. Apply them by hand only if you update your project manually.\r\n\r\n<details>\r\n<summary><b>Fix the default webhook names to align with the controller-runtime interfaces</b></summary>\r\n\r\nApplies to projects with webhooks. The generated webhook structs were renamed. [#5877](https://github.com/kubernetes-sigs/kubebuilder/pull/5877)\r\n\r\n`<Kind>CustomDefaulter` is now `<Kind>Defaulter`, and `<Kind>CustomValidator` is now `<Kind>Validator`.\r\n\r\nTo apply this by hand, open `internal/webhook/<version>/<kind>_webhook.go` and rename both types. Then update three more places: the method receivers, the `WithDefaulter` and `WithValidator` calls in `Setup<Kind>WebhookWithManager`, and `<kind>_webhook_test.go`.\r\n\r\n> For example, the sample: [`captain_webhook.go`](https://github.com/kubernetes-sigs/kubebuilder/blob/v4.16.0/testdata/project-v4/internal/webhook/v1/captain_webhook.go) and [`captain_webhook_test.go`](https://github.com/kubernetes-sigs/kubebuilder/blob/v4.16.0/testdata/project-v4/internal/webhook/v1/captain_webhook_test.go).\r\n\r\n</details>\r\n\r\n**If you skip it:** nothing breaks. Your code still compiles and runs. But the next webhook you add with `create webhook` uses the new names, so one project ends up with both `<Kind>CustomValidator` and `<Kind>Validator`.\r\n\r\n<details>\r\n<summary><b>Fix the <code>envtest</code> suite teardown</b></summary>\r\n\r\nApplies to every project with an API or a webhook. `AfterSuite` no longer retries `testEnv.Stop()`. [#5838](https://github.com/kubernetes-sigs/kubebuilder/pull/5838)\r\n\r\nThe teardown used to run inside `Eventually`, which kept retrying after a `SIGKILL`. That hid real shutdown failures. Kubebuilder now checks the result once.\r\n\r\nTo apply this by hand, replace the `AfterSuite` body in `suite_test.go` and `webhook_suite_test.go` with:\r\n```go\r\n     err := testEnv.Stop()\r\n     Expect(err).NotTo(HaveOccurred())\r\n```\r\n\r\nSuites that passed before may now fail. The failure was always there. The retry only hid it.\r\n\r\n> For example, the sample: [`suite_test.go`](https://github.com/kubernetes-sigs/kubebuilder/blob/v4.16.0/testdata/project-v4/internal/controller/suite_test.go) and [`webhook_suite_test.go`](https://github.com/kubernetes-sigs/kubebuilder/blob/v4.16.0/testdata/project-v4/internal/webhook/v1/webhook_suite_test.go). To learn more, see [Configuring envtest](https://book.kubebuilder.io/reference/envtest).\r\n\r\n</details>\r\n\r\n**If you skip it:** your tests keep passing, and that is the problem. A failing `testEnv.Stop()` is retried away instead of reported, so a control plane that","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}