v4.10.0 - Upcoming Release (Draft & Feedback Requested)

[camilamacedo86]

Following the draft for the upcoming release, we kindly ask for community feedback before we proceed.
Please let us know if you have any suggestions, changes, or improvements that should be addressed prior to the release.

🗓️ ETA: We are planning to start the release process from Monday, November 10th.

---

🚀 How to Keep Your Scaffold Up to Date

💡 Enable AutoUpdate to automatically open an Issue and a prepared PR with scaffold changes:
kubebuilder edit --plugins="autoupdate.kubebuilder.io/v1-alpha".
You can also update manually at any time using kubebuilder alpha update.

Note: Projects created before v4.5.0 may need a one-time manual upgrade. Recreating the project with the latest version and re-applying your custom code provides a clean base. Projects from v4.6.0+ include cliVersion in the PROJECT file, so updates that preserve your custom code just work going forward.

⚠️ Deprecation Notice: helm/v1-alpha → helm/v2-alpha

✨ The new helm/v2-alpha plugin replaces the deprecated helm/v1-alpha and brings major improvements in flexibility and maintainability, championing changes driven by community feedback.

Chart values are now better exposed, enabling easier customisation and addressing long-standing issues by consuming the kustomize-generated bundle from make build-installer instead of relying on fixed templates for chart generation.

✨ New features

• (go/v4): Enable multi-architecture support in GitHub Actions and devcontainer scripts by dynamically detecting GOARCH. #5142
• (go/v4): Allow ENV TEST version to be derived from replaces. #5096
• (go/v4): Add support for custom webhook paths. #5171
• (go/v4): Add *.kubeconfig to .gitignore. #5111
• (go/v4): Allow informing Go modules for external APIs when pinning a downgraded version is required. #5194
• (helm/v2-alpha): Introduce the new helm/v2-alpha plugin.
  (#5058, #5172, #5119, #5147, #5173, #5174)
• (External Plugins API): Add PluginChain field to the external plugin API. #5161
• (External Plugins API): Expose ProjectConfig to external plugins. #5165

✨ Upgrades

• (go/v4): Upgrade golangci-lint from v2.4.0 → v2.5.0. #5128
• (go/v4): Upgrade controller-runtime from v0.22.1 → v0.22.4. (#5129, #5178)
• (go/v4): Upgrade cert-manager used in e2e tests from v1.18.2 → v1.19.1. (#5133, #5136)
• (go/v4): Upgrade Golang version from 1.24 → 1.24.6. #5186

🐛 Bug fixes

• (go/v4): Fix project scaffolding failure when directories contain spaces by quoting Makefile variables. #5139
• (go/v4): Simplify init directory validation to only block Kubebuilder-specific files. #5154
• (External Plugins API): Fix plugin configuration tracking when wrapped in bundles with custom domains. #5166

🎉 Thanks to all contributors!

What's Changed

• ✨ Add helm/v2-alpha addressing all feedbacks and aiming maintainability. Deprecated helm/v1-alpha in favor of helm/v2-alpha by @camilamacedo86 in ✨ Add helm/v2-alpha addressing all feedbacks and aiming maintainability. Deprecated helm/v1-alpha in favor of helm/v2-alpha #5058
• 📖 Tidy up completion.md by @abenn135 in 📖 Tidy up completion.md #5103
• 🌱 Bump k8s.io/apimachinery from 0.34.0 to 0.34.1 by @dependabot[bot] in 🌱 Bump k8s.io/apimachinery from 0.34.0 to 0.34.1 #5108
• 📖 Bump sigs.k8s.io/kubebuilder/v4 from 4.8.0 to 4.9.0 in /docs/book/src/simple-external-plugin-tutorial/testdata/sampleexternalplugin/v1 by @dependabot[bot] in 📖 Bump sigs.k8s.io/kubebuilder/v4 from 4.8.0 to 4.9.0 in /docs/book/src/simple-external-plugin-tutorial/testdata/sampleexternalplugin/v1 #5109
• 🌱 chore: enforce internal package import aliases by @bavarianbidi in 🌱 chore: enforce internal package import aliases #5110
• 📖 : Update CronJob and Multiversion tutorials to use Status Conditions by @nerdeveloper in 📖 : Update CronJob and Multiversion tutorials to use Status Conditions #5087
• 📖 Quickstart: Add note about editing the resource by @guettli in 📖 Quickstart: Add note about editing the resource #5112
• ✨: Add *.kubeconfig to .gitignore. by @guettli in ✨: Add *.kubeconfig to .gitignore. #5111
• 🌱 Bump github.com/onsi/ginkgo/v2 from 2.25.3 to 2.26.0 by @dependabot[bot] in 🌱 Bump github.com/onsi/ginkgo/v2 from 2.25.3 to 2.26.0 #5115
• 🌱 Ensure fixed version for certmanager in testdata samples by @camilamacedo86 in 🌱 Ensure fixed version for certmanager in testdata samples #5127
• 🌱 Bump golang.org/x/mod from 0.28.0 to 0.29.0 by @dependabot[bot] in 🌱 Bump golang.org/x/mod from 0.28.0 to 0.29.0 #5123
• ✨ (go/v4) Upgrade to use golang-lint v2.5.0 by @camilamacedo86 in ✨ (go/v4) Upgrade to use golang-lint v2.5.0 #5128
• 🌱 Bump golang.org/x/text from 0.29.0 to 0.30.0 by @dependabot[bot] in 🌱 Bump golang.org/x/text from 0.29.0 to 0.30.0 #5122
• 🌱 Bump golang.org/x/tools from 0.37.0 to 0.38.0 by @dependabot[bot] in 🌱 Bump golang.org/x/tools from 0.37.0 to 0.38.0 #5125
• ✨ Upgrade controller-runtime from v0.22.1 to v0.22.3 by @camilamacedo86 in ✨ Upgrade controller-runtime from v0.22.1 to v0.22.3 #5129
• 🌱 Bump github/codeql-action from 3 to 4 by @dependabot[bot] in 🌱 Bump github/codeql-action from 3 to 4 #5120
• 🌱 Bump actions/setup-node from 5 to 6 by @dependabot[bot] in 🌱 Bump actions/setup-node from 5 to 6 #5131
• 🌱 Upgrade golang-ci lint in the github actions by @camilamacedo86 in 🌱 Upgrade golang-ci lint in the github actions #5132
• ✨ (go/v4) Upgrade golang version from go 1.24 to 1.25 by @camilamacedo86 in ✨ (go/v4) Upgrade golang version from go 1.24 to 1.25 #5130
• ✨ (go/v4): Upgrade for e2e tests the cert-manager version used from v1.18.2 to v1.19.0 by @camilamacedo86 in ✨ (go/v4): Upgrade for e2e tests the cert-manager version used from v1.18.2 to v1.19.0 #5133
• ✨ (go/v4): Upgrade cert-manager version used on the tests from v1.19.0 to v1.19.1 by @camilamacedo86 in ✨ (go/v4): Upgrade cert-manager version used on the tests from v1.19.0 to v1.19.1 #5136
• 🐛 (go/v4): Fix an issue where project scaffolding failed when directories contained spaces by quoting Makefile variables by @mayuka-c in 🐛 (go/v4): Fix an issue where project scaffolding failed when directories contained spaces by quoting Makefile variables #5139
• ✨ (go/v4): Allow ENV TEST version to be derived from replaces by @Shubhamag12 in ✨ (go/v4): Allow ENV TEST version to be derived from replaces #5096
• ✨ (go/v4) Enable multi-architecture support in GitHub Actions and devcontainer scripts by dynamically detecting GOARCH by @gjrtimmer in ✨ (go/v4) Enable multi-architecture support in GitHub Actions and devcontainer scripts by dynamically detecting GOARCH #5142
• 🌱 Bump actions/upload-artifact from 4 to 5 by @dependabot[bot] in 🌱 Bump actions/upload-artifact from 4 to 5 #5145
• 🌱 Bump github.com/onsi/ginkgo/v2 from 2.26.0 to 2.27.1 by @dependabot[bot] in 🌱 Bump github.com/onsi/ginkgo/v2 from 2.26.0 to 2.27.1 #5140
• 🌱 Bump github.com/onsi/ginkgo/v2 from 2.27.1 to 2.27.2 by @dependabot[bot] in 🌱 Bump github.com/onsi/ginkgo/v2 from 2.27.1 to 2.27.2 #5150
• 🐛 (helm/v2-alpha): Fixed an issue where the ServiceMonitor resource name did not include the default prefix applied by Kustomize. by @liam-mackie in 🐛 (helm/v2-alpha): Fixed an issue where the ServiceMonitor resource name did not include the default prefix applied by Kustomize.  #5119
• 🐛 (helm/v2alpha): allow manager values to be customized properly by @camilamacedo86 in 🐛 (helm/v2alpha): allow manager values to be customized properly #5147
• 📖 Update Readme - Remove Warning Note by @camilamacedo86 in 📖 Update Readme - Remove Warning Note #5153
• 🌱 Add k8s 1.34 version set for tooling - prow tests by @camilamacedo86 in 🌱 Add k8s 1.34 version set for tooling - prow tests #5146
• 🌱 Add Agents.MD with an alias for .github/.instructions.md to support AI tools by @camilamacedo86 in 🌱 Add Agents.MD with an alias for .github/.instructions.md to support AI tools #5152
• 📖 (multiversion-tutorial): Show v2 webhook implementation alongside v1 by @Copilot in 📖 (multiversion-tutorial): Show v2 webhook implementation alongside v1 #5159
• 🌱 Update test environment to Kubernetes 1.34 to match scaffolded projects by @Copilot in 🌱 Update test environment to Kubernetes 1.34 to match scaffolded projects #5157
• ✨ (External Plugins API) Add PluginChain field to external plugin API by @Copilot in ✨ (External Plugins API) Add PluginChain field to external plugin API #5161
• 📖 add e2e test to validate webhook conversion between versions in the tutorials by @wazery in 📖 add e2e test to validate webhook conversion between versions in the tutorials #5069
• 🌱 fix lint issue for expected dupl interface implementation by @camilamacedo86 in 🌱 fix lint issue for expected dupl interface implementation #5167
• 📖 (docs): Update CONTRIBUTING.md guidance to remove gost emoji since it is never used by @camilamacedo86 in 📖 (docs): Update CONTRIBUTING.md guidance to remove gost emoji since it is never used #5168
• 🌱 Increase unit test coverage by @camilamacedo86 in 🌱 Increase unit test coverage #5169
• 🐛 (helm/v2-alpha): ensure that certmanager option is exposed always by @camilamacedo86 in 🐛 (helm/v2-alpha): ensure that certmanager option is exposed always #5173
• 🐛 (helm/v2alpha) Use manager instead of controllerManager to expose manager values by @camilamacedo86 in 🐛 (helm/v2alpha) Use manager instead of controllerManager to expose manager values #5174
• ✨ (feat): Expose ProjectConfig to external plugins by @camilamacedo86 in ✨ (feat): Expose ProjectConfig to external plugins #5165
• ✨ (helm/v2-alpha): Make webhook and metrics ports configurable by @camilamacedo86 in ✨ (helm/v2-alpha): Make webhook and metrics ports configurable #5172
• 🌱 (CLI) Add unit tests for cli alpha generate.go by @mayuka-c in 🌱 (CLI) Add unit tests for cli alpha generate.go #5074
• 🌱 Fix make test-e2e-local to run on mac and linux by @camilamacedo86 in 🌱 Fix make test-e2e-local to run on mac and linux #5170
• 🐛 (fix): Fix plugin configuration tracking when wrapped in bundles with custom domains by @camilamacedo86 in 🐛 (fix): Fix plugin configuration tracking when wrapped in bundles with custom domains #5166
• ✨ Upgrade controller-runtime from 0.22.3 to 0.22.4 by @camilamacedo86 in ✨ Upgrade controller-runtime from 0.22.3 to 0.22.4 #5178
• ✨ Add support for custom webhook paths by @camilamacedo86 in ✨ Add support for custom webhook paths #5171
• 📖 (book): Update note about Windows support by @vitorfloriano in 📖 (book): Update note about Windows support #5179
• 📖 : fix(docs): display copy button on codeblocks by @vitorfloriano in 📖 : fix(docs): display copy button on codeblocks #5184
• 🌱 chore: Move to maintained yaml library by @mrueg in 🌱 chore: Move to maintained yaml library #5182
• 🌱 (ci): Fix testdata generation by @camilamacedo86 in 🌱 (ci): Fix testdata generation #5185
• 📖 (docs/ui): better format for warnings by @vitorfloriano in 📖 (docs/ui): better format for warnings #5188
• 🌱 Bump golangci/golangci-lint-action from 8 to 9 by @dependabot[bot] in 🌱 Bump golangci/golangci-lint-action from 8 to 9 #5189
• 📖 Improve AGENTS.md by @camilamacedo86 in 📖 Improve AGENTS.md #5195
• ✨ (go/v4): Allow informing Go module for external APIs when pinning a downgraded version is required by @camilamacedo86 in ✨ (go/v4): Allow informing Go module for external APIs when pinning a downgraded version is required #5194
• 🐛 Downgrade Go to 1.24.6 and standardize version across codebase by @camilamacedo86 in 🐛 Downgrade Go to 1.24.6 and standardize version across codebase #5186
• 🌱 Bump golang.org/x/mod from 0.29.0 to 0.30.0 by @dependabot[bot] in 🌱 Bump golang.org/x/mod from 0.29.0 to 0.30.0 #5191
• 🌱 (alpha): Remove redundant alpha generate e2e tests by @camilamacedo86 in 🌱 (alpha): Remove redundant alpha generate e2e tests #5196
• 🌱 Bump golang.org/x/text from 0.30.0 to 0.31.0 by @dependabot[bot] in 🌱 Bump golang.org/x/text from 0.30.0 to 0.31.0 #5192
• 🌱 Bump helm.sh/helm/v3 from 3.19.0 to 3.19.1 by @dependabot[bot] in 🌱 Bump helm.sh/helm/v3 from 3.19.0 to 3.19.1 #5193
• 🌱 (grafana): Relocate scaffold tests to grafana directory and increase test coverage by @camilamacedo86 in 🌱 (grafana): Relocate scaffold tests to grafana directory and increase test coverage #5197
• 🌱 Bump k8s.io/apimachinery from 0.34.1 to 0.34.2 by @dependabot[bot] in 🌱 Bump k8s.io/apimachinery from 0.34.1 to 0.34.2 #5198
• 🌱 Fix test-coverage to include only directories where are covered by @camilamacedo86 in 🌱 Fix test-coverage to include only directories where are covered #5199
• 🐛 (go/v4): Simplify init directory validation to only block kubebuilder files by @camilamacedo86 in 🐛 (go/v4): Simplify init directory validation to only block kubebuilder files #5154
• 🌱 Reorganise tests: separate unit and integration tests with build tags by @camilamacedo86 in 🌱 Reorganise tests: separate unit and integration tests with build tags #5200

New Contributors

• @abenn135 made their first contribution in 📖 Tidy up completion.md #5103
• @gjrtimmer made their first contribution in ✨ (go/v4) Enable multi-architecture support in GitHub Actions and devcontainer scripts by dynamically detecting GOARCH #5142
• @liam-mackie made their first contribution in 🐛 (helm/v2-alpha): Fixed an issue where the ServiceMonitor resource name did not include the default prefix applied by Kustomize.  #5119
• @mrueg made their first contribution in 🌱 chore: Move to maintained yaml library #5182

Full Changelog: v4.9.0...v4.10.0

[camilamacedo86]

DONE