Skip to content

Releases: kubernetes-sigs/kubebuilder

v4.3.1

09 Nov 12:30
@camilamacedo86 camilamacedo86
v4.3.1
a9ee390
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v4.3.1 Latest
Latest

✨ New Features

Note: Only minor version updates were applied in this release.

  • (go/v4): Upgraded controller-runtime from v0.19.0 to v0.19.1. (#4234)
  • (go/v4): Updated kustomize from v5.4.3 to v5.5.0 (#4235)
  • (go/v4): Upgraded golangci-lint from v1.59 to v1.61 with minor adjustments for lint rules. (#4236)

🐛 Bug Fixes

  • (kustomize/v2, go/v4): Corrected the generation of manifests under config/crd/patches to ensure the /convert service patch is only created for webhooks configured with --conversion. (#4280)
  • (go/v4): Fixed path configuration for webhook markers generated for core types with non-"core" group values, ensuring accurate path handling in core-type webhooks. (#4301)
  • (go/v4): Resolved misleading comments regarding metrics configuration for certs in cmd/main.go, providing clarity on secure metrics setup. (#4245)
  • (go/v4): Enabled the --make=false option for webhook creation, ensuring consistency with other command options and improved flexibility. (#4275)
  • (kustomize/v2, go/v4): Moved the cert-manager uncomment block to the top of kustomization.yaml to enhance visibility (#4283)
  • (Impact only for library users): ⚠️ Restructured internal layout to move main.go boilerplate into the cmd/ directory. This change is relevant for users consuming the framework as a library and Kubebuilder maintainers only, providing a cleaner separation of code. (#4246)

What's Changed

  • 🌱 Fix incorrect image reference for DeployImage plugin in test data by @camilamacedo86 in #4230
  • 🌱 e2e tests: increase coverage by validating webhooks with installer-based installation by @camilamacedo86 in #4231
  • 🌱 Fix simplify external plugin tests by @camilamacedo86 in #4233
  • ✨ Upgrade controller-runtime from v0.19.0 to v0.19.1 by @camilamacedo86 in #4234
  • ✨ Upgrade kustomize version from v5.4.3 to v5.5.0 by @camilamacedo86 in #4235
  • ✨ Upgrade golangci-lint from v1.59 to v1.61 and resolve new lint issues by @camilamacedo86 in #4236
  • 🌱 Upgrade GoReleaser version from v2.1.0 to v2.3.2 used in the GitHub action by @camilamacedo86 in #4237
  • 📖 Upgrade controller-gen version used to generate documentation by @camilamacedo86 in #4238
  • 🐛 fix internal layout: move main.go boilerplate to cmd/ directory by @camilamacedo86 in #4246
  • 📖 Resolve navigation bar CSS issue and sidebar toggle functionality. by @thiha-min-thant in #4242
  • 🌱 Update Dependabot configuration by @camilamacedo86 in #4249
  • 🌱 : Update dependabot.yml to just raise PRs against project-v4 sample by @camilamacedo86 in #4273
  • 🌱 Bump github.com/onsi/gomega from 1.34.2 to 1.35.0 by @dependabot in #4256
  • 🌱 Bump github.com/onsi/ginkgo/v2 from 2.20.2 to 2.21.0 by @dependabot in #4257
  • 📖 move Versions Compatibility and Supportability info to a dedicated page by @camilamacedo86 in #4250
  • 📖 Correct misleading information in production note for metrics config by @camilamacedo86 in #4244
  • 🐛 (go/v4): Fix misleading metrics configuration comments in cmd/main.go for metrics certs by @camilamacedo86 in #4245
  • 🐛 clarify usage of alpha generate command as internal-only by @camilamacedo86 in #4247
  • 🌱 Add SBOM generation for Cyber Resilience Act compliance by @camilamacedo86 in #4248
  • 🌱 Add GitHub workflow to scan project with CodeQL by @camilamacedo86 in #4252
  • 🐛 fix: (go/v4): ensure --make=false option is available for webhook creation for consistency by @camilamacedo86 in #4275
  • 🌱 Update codeql.yml to run the workflow once per week only by @camilamacedo86 in #4277
  • 🌱 fix: optimize and improve testdata scaffolding for webhook conversion by @camilamacedo86 in #4276
  • 📖 fix(docs): update Quick Start guide with information on using the master branch by @camilamacedo86 in #4228
  • 🌱 Bump github.com/onsi/gomega from 1.35.0 to 1.35.1 by @dependabot in #4279
  • 🌱 Bump actions/setup-go from 4 to 5 by @dependabot in #4278
  • 🌱 Add bundle installer for sample projects in docs by @camilamacedo86 in #4281
  • 🐛 (kustomize/v2,go/v4): Move cert-manager uncomment block to top of kustomization.yaml for better visibility in new projects by @camilamacedo86 in #4283
  • 🐛 (kustomize/v2, go/v4): Fix incorrect generation of manifests under config/crd/patches. Previously, the /convert service patch was being generated for all webhooks instead of only for those with --conversion enabled. by @camilamacedo86 in #4280
  • 🐛 (go/v4) Fix issue with scaffolding multiple webhooks for the same resource by @camilamacedo86 in #4286
  • 📖 (doc) - Fix broken URL by @monteiro-renato in #4298
  • 🌱 Bump golang.org/x/text from 0.19.0 to 0.20.0 by @dependabot in #4303
  • 📖 (doc) - Fix Add missing Reference-style Link by @monteiro-renato in #4304
  • 🐛 (go/v4): Fix path configuration for webhook markers generated for core types with non-"core" group values by @damsien in #4301
  • 🌱 Bump golang.org/x/tools from 0.26.0 to 0.27.0 by @dependabot in #4307
  • 📖 (doc): getting started: fix information about make command for generating manifests by @vtrenton in #4306
  • 🐛 revert the changes done in the PR #4286 by @camilamacedo86 in #4308

New Contributors

Full Changelog: v4.3.0...v4.3.1

Contributors

camilamacedo86, thiha-min-thant, and 4 other contributors
Assets 15

v4.3.0

22 Oct 04:54
@camilamacedo86 camilamacedo86
v4.3.0
eae8b21
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v4.3.0

⚠️ Important Notice:

(Only projects using webhooks are impacted by)

Controller runtime has deprecated the webhook.Validator and webhook.Defaulter interfaces, and they will no longer be provided in future versions. Therefore, projects must adopt the new CustomValidator and CustomDefaulter interfaces to remain compatible with controller-runtime v0.20.0 and upper versions. For more details, refer to controller-runtime/issues/2641.

Furthermore, webhooks should no longer reside under the api directory. Instead, they should be relocated to internal/webhook. For now, you can scaffold webhooks in the legacy path (under api) by using the command kubebuilder create webhook [OPTIONS] --legacy=true, which scaffolds using the CustomValidator and CustomDefaulter interfaces. However, please note that this flag is deprecated and will be removed in upcoming releases.

Steps to Migrate:

  1. Move Webhook Files to the Internal Directory:

    Depending on your project structure, move the webhook files:

    • Single Group Layout: Move from api/<version> to internal/webhook/<version>.

      Before:

      api/
├── <version>/
│   ├── <kind>_webhook.go
│   ├── <kind>_webhook_test.go
│   └── webhook_suite_test.go

      After:

      internal/
├── webhook/
│   └── <version>/
│       ├── <kind>_webhook.go
│       ├── <kind>_webhook_test.go
│       └── webhook_suite_test.go

    • Multigroup Layout: Move from api/<group>/<version> to internal/webhook/<group>/<version>.

      Before:

      api/
├── <group>/
│   └── <version>/
│       ├── <kind>_webhook.go
│       ├── <kind>_webhook_test.go
│       └── webhook_suite_test.go

      After:

      internal/
├── webhook/
│   └── <group>/
│       └── <version>/
│           ├── <kind>_webhook.go
│           ├── <kind>_webhook_test.go
│           └── webhook_suite_test.go

  2. Update Imports:

    After moving the files, ensure that all references to webhooks are updated in your main.go and other files. For example, update the import:

    • Before:

      import "your_project/api/v1"

    • After:

      import "your_project/internal/webhook/v1"

  3. Replace Deprecated Interfaces with Custom Ones:

    Replace webhook.Validator and webhook.Defaulter with the new CustomValidator and CustomDefaulter interfaces:

    • Before:

      var _ webhook.Validator = &MyResource{}

func (r *MyResource) ValidateCreate() error { ... }
func (r *MyResource) ValidateUpdate() error { ... }
func (r *MyResource) ValidateDelete() error { ... }

var _ webhook.Defaulter = &MyResource{}

func (r *MyResource) Default() { ... }

    • After:

      var _ webhook.CustomValidator = &MyResource{}

func (v *MyResource) ValidateCreate(ctx context.Context, obj runtime.Object) (admission.Warnings, error) {
    myResource, ok := obj.(*MyResource)
    if !ok { return nil, fmt.Errorf("expected MyResource, got %T", obj) }
    return nil, validateMyResource(myResource)
}

func (v *MyResource) ValidateUpdate(ctx context.Context, oldObj, newObj runtime.Object) (admission.Warnings, error) {
    myResource, ok := newObj.(*MyResource)
    if !ok { return nil, fmt.Errorf("expected MyResource, got %T", newObj) }
    return nil, validateMyResource(myResource)
}

func (v *MyResource) ValidateDelete(ctx context.Context, obj runtime.Object) (admission.Warnings, error) {
    myResource, ok := obj.(*MyResource)
    if !ok { return nil, fmt.Errorf("expected MyResource, got %T", obj) }
    return nil, nil
}

var _ webhook.CustomDefaulter = &MyResource{}

func (d *MyResource) Default(ctx context.Context, obj runtime.Object) error {
    myResource, ok := obj.(*MyResource)
    if !ok { return fmt.Errorf("expected MyResource, got %T", obj) }
    // Defaulting logic
    return nil
}

Example: See the tutorial: CronJob Webhook Example.

Note: You might want to use the Upgrade Assistance to re-scaffold your project and then apply your code changes on top, ensuring that all necessary updates are addressed. Also,

⚠️ Breaking Changes

  • (Only projects using webhooks are impacted by) (go/v4): Replaced the deprecated webhook.Validator and webhook.Defaulter interfaces with CustomValidator and CustomDefaulter. Projects using the old interfaces must migrate to ensure compatibility with future versions. (#4060)
  • (Only projects using webhooks are impacted by) (go/v4): Webhooks are now decoupled from the API directory. Webhook files should be moved from api/<version> or api/<group>/<version> to internal/webhook/<version> or internal/webhook/<group>/<version>. This restructuring improves project organization. (#4150)
  • (Impact only for library users): Removed the APIPackagePathLegacy method, which has been obsolete since release 4.0.0. This change cleans up unused code. (#4182)
  • (Impact only for library users): cleanup/refactor: Alpha Generate command. Move code source implementation to internal since this alpha feature is not designed to be imported by other tools (#4180)
  • (Impact only for library users): Removed the redundant HasFragment method, favoring HasFileContentWith to reduce duplication and simplify the codebase. (#4191)

✨ New Features

  • (go/v4): Added DevContainer support, making development in environments like GitHub Workspaces easier by removing the need for local setup. (#4078)
  • (go/v4): The e2e test scaffolding has been improved with a comprehensive set of tests under e2e/tests, covering the manager and webhooks. These tests are designed to fail when not run against clusters using Kind, and they avoid re-installing Prometheus and Cert-Manager if already present. See the final scaffolded tests in the samples under testdata here. Key improvements include:
    • Added checks to detect existing Prometheus and Cert-Manager installations to prevent re-installation. (#4117)
    • Enhanced e2e tests to ensure proper execution with Kind and clarified usage. (#4106)
    • Ensured make manifests and make generate are run as part of the e2e tests. (#4122)
    • Aligned make test-e2e with make test for consistent behavior. (#4125)
    • Improved tests to validate metrics endpoints and ensure proper metric exposure, including guidance for using metrics in reconciliation validation. (#4131)
    • Added support for scaffolded e2e webhook tests with the +kubebuilder:scaffold:e2e-webhooks-checks marker. (#4121)
    • Simplified Gomega assertions for better readability and improved error handling and logging in e2e/test.go. (#4141, #4158, #4166, #4175)
  • (go/v4): Improved the webhook tests by adding examples. Also, enhanced the CronJob tutorial to clarify usage and validate changes. (#4130)
  • (deploy-image/v1alpha): Improved the tests scaffolded for controllers to ensure better coverage. (#4197)
  • (go/v4): Added support for scaffolding controllers and webhooks for External Types, making it easier to work with external resources in projects. (#4171, #4203, #4217)
  • (go/v4): Add Support for Scaffolding Webhooks for Core Types (#4210)
  • (go/v4): Upgraded the cert-manager version used in tests from v1.14.4 to v1.16.0 for better compatibility and features. (#4209)
  • (deploy-image/v1-alpha1): Added comments to clarify how resource watching and reconciliation logic works in the scaffolded code. (#4102)
  • (go/v4): Upgrade controller-tools version from v0.16.1 to v0.16.4 (#4215)
  • (go/v4): Upgrade Prometheus Operator version used on the tests from v0.72.0 to 0.77.1 (#4212)

🐛 Bug Fixes

  • (deploy-image/v1-alpha1): Corrected a typo, replacing typeNamespaceName with typeNamespacedName to ensure accurate variable naming. (#4100)
  • (deploy-image/v1-alpha1): Fixed sample code to apply correct labels to resources, improving consistency in the scaffolded examples. (#4101)
  • (go/v4): Resolved linter issues in the scaffold, adding nolint where necessary to prevent failures for specific cases that should not fail during checks. (#4111)
  • (deploy-image/v1-alpha1): Addressed additional linter issues to enhance code quality. (#4112)
  • (go/v4): Fixed linter issues to pass stricter checks like godot, gofumpt, and nlreturn, ensuring better code formatting and style. (#4133)
  • (go/v4): Removed duplicate webhook names in multi-version APIs, resolving conflicts when using the same webhook names across different API versions. (#4145)
  • (go/v4): Improved webhook test templates by adding examples, providing clearer guidance for testing webhooks. (#4151)
  • (go/v4): Ensured unique controller names to fix naming conflicts in multigroup layouts, improving support for projects with multiple groups. (#4162)
  • (go/v4): Fixed the HasResource package method to stop once a match is found, improving performance and accuracy in resource handling. (#4190)
  • (go/v4, kustomize/v2): Simplified scaffold by removing webhookcainjection_patch and clarified the use of cert-manager as a repl...
Read more

Contributors

mogsie, rkosegi, and 8 other contributors
Assets 9
Loading

v4.2.0

17 Aug 09:41
@camilamacedo86 camilamacedo86
v4.2.0
c7cde51
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v4.2.0

changes since v4.1.1

⚠️ Important Notice:

The artefacts for ENVTEST from k8s 1.31 are exclusively available at: Controller Tools Releases. Kubebuilder no longer builds and promote the ENVTEST artefacts at the old location https://storage.googleapis.com/kubebuilder-tools which is deprecated and can no longer be ensured by Kubebuilder maintainers. You should ensure that your projects are using the new location. For further information, see: #4082

This update is fully transparent for Kubebuilder users assuming that they properly update their scaffolds to use setup-envtest from controller-runtime branch release-0.19.

# To know the available versions check: 
# - https://github.com/kubernetes-sigs/controller-tools/blob/main/envtest-releases.yaml
ENVTEST_K8S_VERSION = 1.31.0
# Controller-Runtime branch `release-0.19` has the implementation of the setup-envtest's code responsible
# for downloading the tarball from the correct location.
ENVTEST_VERSION ?= release-0.19

...
.PHONY: envtest
envtest: $(ENVTEST) ## Download setup-envtest locally if necessary.
$(ENVTEST): $(LOCALBIN)
	$(call go-install-tool,$(ENVTEST),sigs.k8s.io/controller-runtime/tools/setup-envtest,$(ENVTEST_VERSION))

✨ New Features

  • (go/v4, kustomize/v2): Add support to protect project with network policies (#3853)
  • (go/v4): Add support to k8s 1.31 (#4080)
  • (go/v4): Upgrading controller-runtime from v0.18.4 to v0.19.0 (#4080)
  • (go/v4): Upgrading controller-tools from v0.15.0 to v0.16.1 (#4080)
  • (go/v4, kustomize/v2): Upgrade kustomize from v5.4.2 to v5.4.3 (#4084)

🐛 Bug Fixes

  • (go/v4): Add missing cancel context to controller's suite-test (#4067)
  • ⚠️ (Only relevant for users of Kubebuilder as a library): ImplementWebhooks should only be used by the e2e tests and should be under its package. Therefore, this method is no longer served under pkg/plugin/util (#4065)

What's Changed (Full Changelog)

New Contributors

Full Changelog: v4.1.1...v4.2.0

Contributors

camilamacedo86, dependabot, and 2 other contributors
Assets 9
Loading

v4.1.1

23 Jul 07:10
@camilamacedo86 camilamacedo86
v4.1.1
e65415f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v4.1.1

changes since v4.1.0

✨ New Features

  • (go/v4): Upgrade golangci-lint from v1.57.2 to v1.59.1 (#4030)
  • (go/v4): makefile: create unversioned symlinks for configurable binaries tools (#4013)
  • (kustomize/v2, go/v4): upgrade kustomize version from v5.4.1 to v5.4.2 (#4029)
  • (Only relevant for users of Kubebuilder as a library): Add new CLI option and allow access to underlying CLI command (#4011)

🐛 Bug Fixes

  • (go/v4): Fix security concerns by only enabling FilterProvider to protect the metrics endpoint with authn/authz when secureMetrics is true (#4022)
  • (go/v4): Align Go Version in go.mod Template to 1.22.0 (#4012)
  • (go/v4): Small cleanup in the main.go to keep all variables used defined on top of the file (#4036)
  • (go/v4): Fix golang documentation of the method LoadImageToKindClusterWithName scaffold in the e2e tests (#4034)
  • (go/v4): Fix validation used to ensure Kind versions pattern (#3986)
  • (kustomize/v2, go/v4): Add missing labels for config/default/manager_webhook_patch.yaml (#4028)

Note Based on the changes, it seems appropriate to release these updates as version 4.1.1 rather than 4.2.0. The new features are minor improvements which only affect new projects and do not introduce breaking changes or significant new functionality for existing users.

What's Changed (Full Changelog)

  • 🌱 Bump golang.org/x/tools from 0.22.0 to 0.23.0 by @dependabot in #4007
  • ✨ (Only relevant for users of Kubebuilder as a library) - Add new cli option and allow access to underlying cli command by @beatrausch in #4011
  • 🐛 Align Go Version in go.mod Template to 1.22.0 by @camilamacedo86 in #4012
  • 📖 Upgrade controller-gen used to generated the docs and remove redirects for artefact images by @camilamacedo86 in #4010
  • ✨ Makefile: Create Version-Agnostic Symlinks for Specified Versioned Binaries by @schrej in #4013
  • 📖 docs: correct typo in migration guide by @Gearheads in #4015
  • 📖 clarify in note that metrics are protected by default via controller-runtime feature by @camilamacedo86 in #4026
  • 📖 Update roadmap_2024.md - with the latest changes and by order the tasks adding what was done at the bottom of the page by @camilamacedo86 in #4027
  • 🐛 (kustomize/v2,go/v4): add missing labels for config/default/manager_webhook_patch.yaml by @camilamacedo86 in #4028
  • ✨ (kustomize/v2,go/v4): upgrade kustomize version from v5.4.1 to v5.4.2 by @camilamacedo86 in #4029
  • ✨ Upgrade golangci-lint from v1.57.2 to v1.59.1 by @camilamacedo86 in #4030
  • 🌱 Update release.yml - Update goreleaser from 1.11.2 to v2.1.0 by @camilamacedo86 in #4031
  • 🌱 Update Makefile - Remove makefile target to test legacy project no longer supported by @camilamacedo86 in #4032
  • 📖 Update test examples not to set Status on create by @hsadoyan in #4016
  • 🐛 Fix validation used to ensure Kind versions pattern by @Kavinjsir in #3986
  • 🐛 Fix golang documentation of the method LoadImageToKindClusterWithName scaffold in the e2e tests by @fengshunli in #4034
  • 🐛 Fix security concerns by only enabling FilterProvider to protect the metrics endpoint with authn/authz when secureMetrics is true by @alex-kattathra-johnson in #4022
  • 🐛 cleanup/enhancement: keep all variables used defined on top ofmain.go by @fengshunli in #4036
  • 🌱 fix error faced during release process by ensuring dist directory is cleaned before running GoReleaser by @camilamacedo86 in #4040
  • 🌱 Upgrade goreleaser by @camilamacedo86 in #4041

New Contributors

Full Changelog: v4.1.0...v4.1.1

Contributors

schrej, Gearheads, and 7 other contributors
Assets 9
Loading

v4.1.0

05 Jul 09:07
@camilamacedo86 camilamacedo86
v4.1.0
de1cc60
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v4.1.0

changes since v4.0.0

✨ New Features

This protection is similar to what was previously done via kube-rbac-proxy, which usage was discontinued in the project. Please, ensure that you no longer use the image gcr.io/kubebuilder/kube-rbac-proxy. ⚠️ Images provided under gcr.io/kubebuilder/All images previously built and promoted will stop being available sometime in early 2025**.

  • Upgrade controller-runtime from v0.18.2 to v0.18.4 (#3957) (#3972)
  • Add revive golangci linter with comment-spacings rule (#3960)
  • (Only relevant for users of Kubebuilder as a library) Allow usage of custom marker names (#3993)

🐛 Bug Fixes

  • Corrected the generate command to respect the --namespaced=false flag for APIs. (#3970)

🎉 Thanks to all our contributors!

What's Changed (Full Changelog)

New Contributors

Full Changelog: v4.0.0...v4.1.0

Contributors

davidxia, joelanford, and 9 other contributors
Assets 9
Loading

v4.0.0

24 May 08:36
@camilamacedo86 camilamacedo86
v4.0.0
6c08ed1
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v4.0.0

v4.0.0

changes since v3.15.1

Overview and Key Guidelines

It is a MAJOR release because all deprecated features were removed from the project. However, for those with projects scaffolded using the go/v4 plugin layout, there should mainly not be impacted by. To know the layout version of your project, check the Project Config, see the PROJECT file (example).

(General guidance) You might be impact by:

(For who are using go/v2 or go/v3) Upgrading Layouts:

If your project is currently using go/v2 or go/v3, you must upgrade to go/v4 to be compatible with this release and future updates. To know how to upgrade, check the migration documentation.

💡 Tips

You can add the changes manually, but unless your project is too big or deviated too much from the proposed layout the recommended process to upgrade a project usually involves re-scaffolding and then comparing the new base with your project code changes and re-adding all on top. IDEs usually can help you out in this process since you can re-scaffold all in a branch and easily compare it with your main branch published in the repository of your project to add the code back again.

  • Kubebuilder provides and Upgrade Assistance for those who have been using the CLI to do all scaffolds and does not deviated from the layout proposed.
  • You can follow the same process to ensure that your scaffold has all changes and bug fixes introduced from MINOR releases.
  • You can also always check the project scaffolds under the testdata directory as a base and compare them across tag releases to check the changes made: Example: Compare testdata/project-v4 between tags v3.14.1 and v3.15.1.
  • Avoiding unnecessary deviations from the proposed layout can help you keep your project maintained and aligned with the latest changes with a lower effort. Please, see the info.

⚠️ Breaking Changes

  • Removal of ComponentConfig since it is no longer supported by controller-runtime release version 0.15.0 and was removed from v0.18.0 (#3764). (More info)
  • Removal of the go/v2 which was kept only to ensure backwards compatibility from Kubebuilder release 2x to 3x and is deprecated since Apr 28, 2021. The go/v2 plugin cannot scaffold projects in which CRDs and/or Webhooks have a v1 API version. Be aware that v1beta1 API for CRDs and Webhooks was deprecated on Kubernetes 1.16 and were removed in the Kubernetes 1.22+ release. Go versions higher than 1.13+ are not supported within. (#3763) (#3915) (More info).
  • Removal of the go/v3 which is deprecated since Mar 11, 2023. Be aware that go/v3 plugin cannot scaffold projects using kustomize versions v4x+ and cannot fully support Kubernetes 1.25+ and go versions higher than 1.19+. (#3763) (#3915) (More info)
  • Removal of the kustomize/v1 which is deprecated since Mar 11, 2023. (#3763) (#3915) (More info)
  • Removal of the Declarative Plugin. (#3922) (More info)
  • (For who consume Kubebuilder as lib): Removal of deprecated APIs. The methods NewBundle, GetShortName, IsLegacyLayout are no longer available for those that consumes Kubebuilder as lib. (#3929)

✨ New Features

  • Add support for go 1.22 (#3910)
  • Add support for Kubernetes version 1.30. Upgrade controller-runtime from v0.17.3 to v0.18.2 (#3912)
  • Upgrade kustomize from v5.3.0 to v5.4.1 by (#3911)
  • Upgrade controller-tools from v0.14.0 to v0.15.0 (#3913)
  • Upgrade EnvTest from 1.29.0 to 1.30.0 (#3914)
  • Add new GolangCI linter to check the tests scaffolded with ginkgo (#3894)
  • (For who consume Kubebuilder as lib): Add sigs.k8s.io/kubebuilder/v4 module (#3924)

🐛 Bug Fixes

  • Fix typo issue in the flag description (#3954)
  • Fix in the makefile target docker-buildx to use the project name instead of fix value (#3928)
  • Fix in the makefile to remove invalid comment (#3816)
  • Fix to ensure consistent spacing in marker annotations. Ensure that you replace all markers to add the space by s/\//+/\// +/. (#3904)

Thanks to all our contributors!

What's Changed (Full Changelog)

Read more

Contributors

camilamacedo86, PG2000, and 2 other contributors
Assets 9
Loading

v3.15.1

23 May 19:02
@camilamacedo86 camilamacedo86
v3.15.1
01f76cf
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v3.15.1

v3.15.1

changes since v3.15.0

🐛 Bug Fixes

  • (go/v4,kustomize/v2): - fix to preserve existing flags when applying metrics patch (#3947)
  • (go/v4,kustomize/v2): - fix the place where metrics service is scaffolded by moving from config/rbac to config/default (#3948)

🎉 Thanks to all our contributors!

What's Changed (Full Changelog)

  • 🐛 (cherry-pick #3937) - fix: preserve existing flags when applying metrics patch by @camilamacedo86 in #3947
  • 🐛 (cherry-pick #3945) fix place where metrics service is scaffolded by moving from config/rbac to config/default by @camilamacedo86 in #3948

Full Changelog: v3.15.0...v3.15.1

Contributors

camilamacedo86
Assets 9
Loading

v3.15.0

15 May 10:16
@camilamacedo86 camilamacedo86
v3.15.0
c01af8f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v3.15.0

v3.15.0

changes since v3.14.2

⚠️ Breaking Changes

🎉 Thanks to all our contributors!

What's Changed (Full Changelog)

  • 📖 Fix link for controller-runtime FAQ by @camilamacedo86 in #3888
  • 🌱 Bump github.com/onsi/ginkgo/v2 from 2.17.1 to 2.17.2 by @dependabot in #3891
  • 🌱 Bump golangci/golangci-lint-action from 4 to 5 by @dependabot in #3892
  • 🌱 Bump sigs.k8s.io/kubebuilder/v3 from 3.14.1 to 3.14.2 in /docs/book/src/simple-external-plugin-tutorial/testdata/sampleexternalplugin/v1 by @dependabot in #3893
  • 🌱 Bump github.com/onsi/gomega from 1.33.0 to 1.33.1 by @dependabot in #3900
  • 🌱 Bump golang.org/x/tools from 0.20.0 to 0.21.0 by @dependabot in #3901
  • 🌱 move tony to approver by @Kavinjsir in #3843
  • 🌱 Bump github.com/onsi/ginkgo/v2 from 2.17.2 to 2.17.3 by @dependabot in #3905
  • 🌱 Bump golangci/golangci-lint-action from 5 to 6 by @dependabot in #3906
  • ⚠️ Discontinue Kube RBAC Proxy in Default Kubebuilder Scaffolding by @camilamacedo86 in #3899

Full Changelog: v3.14.2...v3.15.0

Contributors

camilamacedo86, Kavinjsir, and dependabot
Assets 9
Loading

v3.14.2

27 Apr 08:26
@camilamacedo86 camilamacedo86
v3.14.2
d7b4feb
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v3.14.2

v3.14.2

changes since v3.14.1

✨ New Features

  • (go/v4): Upgrade controller-runtime dependency from v0.17.2 to v0.17.3 (#3882)
  • (go/v4): Upgrade golangci from 1.54 to 1.57 by (#3846)
  • (go/v4): (To address deprecation): Replace deadline in favor of timeout in golangci-lint configuration (#3865)
  • (kustomize/v2): Add CRD viewer and editor roles in rbac/kustomization.yaml (#3800)
  • (go/v4): Upgrade cert-manager version used from v1.5.3 to v1.14.4 in the e2e tests scaffolded (#3839)
  • (go/v4): Upgrade Prometheus version used in the tests from v0.68.0 to v0.72.0 in the e2e tests scaffolded (#3840)
  • (go/v4): Upgrade gcr.io/kubebuilder/kube-rbac-proxy image from v0.15.0 to v0.16.0 (#3833).

⚠️ IMPORTANT: Please note that kube-rbac-proxy is now deprecated and will be discontinued in a future release.

If you want to still using this project, it is recommended that you switch to the images directly provided by the project. For more details, please refer to the project’s image repository.

The Kubebuilder can no longer support the promotion and building of these images. All images previously built and promoted will stop being available sometime in early 2025. This change may impact your production workloads if they rely on these images. (gcr.io/kubebuilder/kube-rbac-proxy:<all>)

For more information, please review the proposal to Discontinue Kube RBAC Proxy in Default Kubebuilder Scaffolding.

🐛 Bug Fixes

  • (go/v4): Add comment to clarify that webhooks path in the marker values should not be changed (#3877)
  • (go/v4): Fix Invalid leader election ID generated when domain is empty (#3876)
  • (kustomize/v2, go/v4): Fix labels according to conventions. Follow-up of PR 3797 (#3857)
  • (go/v4,kustomize/v2): Fix roles names for projects with multi-group layout (#3845)
  • (go/v4,kustomize/v2): Fix the CRD kustomization path logic to ensure webhook patches are generated exclusively for resources that are configured with webhooks (#3838)
  • (go/v4,kustomize/v2): Fix resource path generation for resources without a specified group (#3837)
  • (kustomize/v2, go/v4): Fix labels according to conventions. Address change in missing files. It is a follow-up of the PR #3797 (#3857)

🎉 Thanks to all our contributors!

What's Changed (Full Changelog)

New Contributors

Full Changelog: v3.14.1...v3.14.2

Contributors

afritzler, camilamacedo86, and 4 other contributors
Assets 9
Loading

v3.14.1

30 Mar 09:26
@camilamacedo86 camilamacedo86
v3.14.1
cc338d7
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
v3.14.1

v3.14.1

changes since v3.14.0

✨ New Features

  • (go/v4): Upgrade controller-runtime from v0.17.0 to v0.17.2 (#3827)

🐛 Bug Fixes

  • (go/v4): Remove trailing whitespace from Readme which is scaffold for the project (#3813)
  • (go/v4): Fix compatibility issues encountered while setting up EnvTest binaries by using the controller-runtime branch releases (#3824).
  • (kustomize/v2, go/v4, deploy-image/v1-alpha): Fix labels according to conventions and conveys. app.kubernetes.io/name now have the ProjectName and the labels app.kubernetes.io/instance, app.kubernetes.io/component, app.kubernetes.io/created-by, app.kubernetes.io/part-of were removed (#3797)
  • (go/v4): Fix makefile target build-installer to discarding the previous content (#3766)
  • (go/v4): Fix scaffolding e2e template by adding missing errors checks (#3786)
  • (go/v4): Fix makefile target build-installer to discarding the previous content (#3766)
  • (go/v4): Fix rules to allow create new APIs by reverting the PR( #3742 ) (#3787)

🎉 Thanks to all our contributors!

What's Changed (Full Changelog)

  • 📖 docs updates for external types and submodule-layouts by @jakobmoellerdev in #3055
  • 🐛 (go/v4) Fix makefile target build-installer to discarding the previous content by @lukas016 in #3766
  • 📖 Clean up getting started docs by @stmcginnis in #3758
  • 📖 Update Contrbuting.MD by @camilamacedo86 in #3769
  • 📖 Fix #the reference link by @wastelife in #3771
  • 📖 Simplify if condition in cronjob tutorial by @lpugoy in #3765
  • 📖 Typo multi-version tutorial deployment.md by @tatehanawalt in #3770
  • 📖 Fix typo in cronjob-tutorial by @awalvie in #3773
  • 🌱 Bump sigs.k8s.io/kubebuilder/v3 from 3.13.0 to 3.14.0 in /docs/book/src/simple-external-plugin-tutorial/testdata/sampleexternalplugin/v1 by @dependabot in #3774
  • 🌱 Bump golangci/golangci-lint-action from 3 to 4 by @dependabot in #3778
  • 📖 Add context to handler func by @vladfr in #3777
  • 🌱 Bump golang.org/x/tools from 0.17.0 to 0.18.0 by @dependabot in #3779
  • 🐛 Revert ":bug: Align CRD version validation with apiextensions" by @camilamacedo86 in #3787
  • 🐛 scaffolding e2e template err check by @domcyrus in #3786
  • 📖 Specify what is run and deployed by @letthefireflieslive in #3788
  • 📖 Add the Admission webhooks link in docs/book/src/reference/admisson-webhook.md by @renormalize in #3799
  • 🐛(kustomize/v2, go/v4, deploy-image/v1-alpha): Fix labels according to conventions and conveys. app.kubernetes.io/name now have the ProjectName and the labels app.kubernetes.io/instance, app.kubernetes.io/component, app.kubernetes.io/created-by, app.kubernetes.io/part-of were removed by @sarthaksarthak9 in #3797
  • 🌱 Bump github.com/onsi/gomega from 1.31.1 to 1.32.0 by @dependabot in #3820
  • 🐛 Fix compatibility issues encountered while setting up envtest by using the controller-runtime branch releases (unblock CI) by @camilamacedo86 in #3824
  • 📖 : (README) Fix slack channel access address by @uos-ljtian in #3818
  • 🐛 fix make build-installer command to remove CRD duplication by @mateusoliveira43 in #3814
  • 🐛 fix: Remove empty line at beginning of generated files by @mateusoliveira43 in #3815
  • 📖 Fix typo issue in the docs by @mcbenjemaa in #3803
  • 📖 Add missing basic-project-doc link by @semihbkgr in #3806
  • 🌱 Add prefix to bot PR title to respect community rule by @Kavinjsir in #3810
  • 🌱 Bump golang.org/x/tools from 0.18.0 to 0.19.0 by @dependabot in #3817
  • 🌱 Bump github.com/onsi/ginkgo/v2 from 2.15.0 to 2.17.1 by @dependabot in #3822
  • 🌱 Remove trailing whitespace in readme gen by @bzub in #3813
  • 🌱 Remove trailing spaces in the docs and add check as automate fix to the make generate by @camilamacedo86 in #3826
  • ✨ Upgrade controller-runtime from v0.17.0 to v0.17.2 by @camilamacedo86 in #3827

New Contributors

Full Changelog: v3.14.0...v3.14.1

Contributors

vladfr, domcyrus, and 18 other contributors
Assets 9
Loading