Skip to content

Releases: kubernetes-sigs/controller-runtime

v0.15.1

04 Aug 17:52
40203bf
Compare
Choose a tag to compare

What's Changed

Full Changelog: v0.15.0...v0.15.1

v0.15.0

23 May 13:35
116a1b8
Compare
Choose a tag to compare

Controller Runtime v0.15

A note from the maintainers

The following release is probably the largest in the history of the project. Controller Runtime is a foundational piece for almost all controllers and operators and we're aware that breaking changes are never an ask for our users, especially while running production services.

We take breaking changes very seriously and carefully reviewed each one of these changes to improve the codebase, user experience, and future maintainability of the project.

The v0.15 release is a stepping stone towards maturity.

As always, please reach out in Slack in #controller-runtime.

Changes since v0.14.5

⚠️ Breaking Changes

  • Make *http.Client configurable and use/share the same client by default (#2122)
    • When using the default Manager configuration, no immediate changes are needed.
    • client/apiutil.NewDynamicRESTMapper signature has changed and now requires an *http.Client as parameter.
    • cluster.Cluster interface requires GetHTTPClient() method which must return an already configured, non-nil, *http.Client for the Cluster. When using cluster.New to create Clusters, the client is created internally if not specified as an Options field.
    • cluster.Options.MapperProvider field now requires a *rest.Config and *http.Client.
  • Deprecate Component Configuration config/v1alpha1 types (#2149, #2200)
    • The Component Configuration package has been unmaintained for over a year and is no longer actively developed. There are (currently) no plans to revive the package, or provide an alternative.
    • Users should migrate to a custom implementation that sets Manager.Options directly.
    • 👉 Feedback requested: removal of the deprecated types and code is tracked in #895.
  • Remove dependency injection functions (#2134, #2120)
    • The package pkg/inject has been removed, this package contained long deprecated injection functions (like InjectScheme, InjectLogger, InjectConfig, InjectClient, InjectCache, etc.).
    • The runtime injection functionality has been deprecated since Controller Runtime 0.10; all of the above fields can be passed from the Manager to structs or interfaces that need them.
  • Improve builder package capabilities and general UX (#2135)
    • builder.Builder.Watches signature has changed, it now takes a client.Object instead of a source.Source as first argument.
      • For source.Source, use WatchesRawSource.
    • builder.Builder.WatchesMetadata has been added to simplify watching PartialObjectMetadata objects.
  • Refactor cache.Options, deprecate MultiNamespacedCacheBuilder (#2157, #2166)
    • cache.Options.Namespace has been removed in favor of cache.Options.Namespaces, a slice.
    • cache.Options.Resync has been renamed to SyncPeriod.
    • cache.Options.DefaultSelector has been removed and split in two fields:
      • cache.Options.DefaultLabelSelector
      • cache.Options.DefaultFieldSelector
    • cache.Options.DefaultTransform was added to provide a global transform function.
    • cache.Options.UnsafeDisableDeepCopy was added to provide a global toggle to disable DeepCopy of the objects from the cache before returning them to clients.
    • The following [..]ByObject field have been refactored:
      • cache.Options.SelectorsByObject has been removed, use cache.Options.ByObject[Object].Field and cache.Options.ByObject[Object].Label
      • cache.Options.UnsafeDisableDeepCopyByObject has been removed, use cache.Options.ByObject[Object].UnsafeDisableDeepCopy.
      • cache.Options.TransformByObject has been removed, use cache.Options.ByObject[Object].Transform.
    • cache.ObjectAll has been removed. This type was previously used to set selectors or transformation functions for every object, use the newly introduced default global options instead.
  • Add context to EventHandler(s) (#2139)
    • handler.EventHandler and handler.Funcs interfaces require context.Context as the first parameter for every method.
    • handler.MapFunc signature has changed and now requires a context.Context.
  • Add client.{GroupVersionKindFor, IsObjectNamespaced} (#2136)
    • The client.Client interface now requires and exposes these helper functions:
      • GroupVersionKindFor(Object) which returns the schema.GroupVersionKind for the object.
      • IsObjectNamespaced(Object) which returns true if the object's GroupVersionKind is namespaced, or false for global ones.
  • Remove DelegatedClient, move all related options in client.New (#2150)
    • client.NewDelegatingClient constructor and client.NewDelegatingClientInput struct have been removed.
      • The DelegatingClient created a Client backed by a cache, use client.New and set client.Options.Cache to customize the client's caching behavior.
    • cluster.NewClientFunc has been moved to client.NewClientFunc.
    • cluster.ClientOptions has been removed.
    • cluster.DefaultNewClient has been removed.
    • cluster.ClientBuilderWithOptions has been removed.
  • Expose Manager.Cache/Client options, deprecate older options (#2199, #2177)
    • manager.Options.Cache is now the preferred way to customize the cache options for the manager.
      • Users can also keep using manager.Options.NewCache, which has now been marked as a low level primitive.
    • manager.Options.Client is now the preferred way to customize the client options for the manager.
      • Users can also keep using manager.Options.NewClient, which has now been marked as a low level primitive.
    • manager.Options.SyncPeriod has been deprecated in favor of manager.Options.Cache.SyncPeriod.
    • manager.Options.Namespace has been deprecated in favor of manager.Options.Cache.Namespaces.
    • manager.Options.DryRunClient has been deprecated in favor of manager.Options.Client.DryRun.
    • manager.Options.ClientDisableCacheFor has been deprecated in favor of manager.Options.Client.Cache.DisableCacheFor.
    • The following webhook server options have been deprecated, use manager.WebhookServer instead.
      • manager.Options.Port
      • manager.Options.Host
      • manager.Options.CertDir
      • manager.Options.TLSOpts
  • Remove cache.BuilderWithOptions (#2300)
  • Add constructors for webhook/conversion, remove webhook/admission.GetDecoder() (#2144)
    • There are two set of changes related to the webhooks and how they're exposed. For users using the Manager, there should be minimal to no required changes.
    • webhook/admission/Webhook.GetDecoder() method has been removed, it was unused before and relied on runtime dependency injection.
    • webhook/conversion.Webhook struct has been un-exported. Users should use webhook/conversion.NewWebhookHandler instead.
  • pkg/webhook/admission:
    • Use Result.Message instead of Result.Reason (#1539)
    • Validator and CustomValidator interfaces have been modified to allow returning warnings (#2014)
  • Testing: Fake client status handling (#2259)
    • Added a new WithStatusSubresource option and pre-populating it with
      all in-tree resources that have a status subresource
    • Update and Patch methods now don't change the status for any such
      resource anymore
    • The status clients Update and Patch methods now only change the status
      for any such resource
  • Remove high cardinality metrics (#2217, #2298)
    • rest_client_request_latency_seconds
    • rest_client_request_duration_seconds
    • rest_client_request_size_bytes
    • rest_client_response_size_bytes
  • Allow passing a custom webhook server (#2293, #2329)
    • The webhook.Server struct is now an interface
    • webhook.NewServer can be used to pass in and customize the default server
  • Flatten fields in controller.Options (#2307)
  • Update fake client deletionTimestamp behavior (#2316)
    • The fake client will panic if initialized with an object that has a DeletionTimestamp and no finalizer
    • The fake client will silently ignore a DeletionTimestamp on an object in a Create request, matching the behavior of the kube-apiserver
  • Unexport delegating logger, remove async init (#2317)
    • log.DelegatingLogSink has been unexported, this logger should never be used on its own, and it's only meant to be used within controller-runtime initialization process.
    • Previously, when the pkg/log package was imported, there was an init function that spawned a goroutine, which set a null logger after 30 seconds. Now this logic has been removed, and instead incorporated into the delegating logger private implementation.
  • Change webhook request received / response written logs to log level 4 (#2334)
  • Use and offer a single dynamic lazy RESTMapper (#2116, #2296)
    • The following options have been removed: WithCustomMapper, WithExperimentalLazyMapper, WithLazyDiscovery, WithLimiter.
    • The DynamicRESTMapperOption type has been removed.

✨ New Features

  • Add cross-version compatibility with client-go 1.27 (#2223)
  • Introduce pprof server to manager (#1943)
    • To enable, use Manager.Options.PprofBindAddress.
  • Added interceptor client to intercept calls to a client (#2248 #2306)
  • Add reconcile.TerminalError(...) (#2325)
    • By wrapping an error with the above package-level function, the controller won't retry the request again in an exponential backoff loop.
    • The error is logged, and the controller_runtime_terminal_reconcile_errors_total metric is incremented.

🐛 Bug Fixes

  • Use correct context to cancel "list and watch" & wait for all informers to complete (#2121)
  • Client: use passed in Cache.DisableFor option (#2303)
  • Fix race condition in channel source (#2286)
  • ForceOwnership should work with subresourc...
Read more

v0.14.6

28 Mar 14:25
cd65cb2
Compare
Choose a tag to compare

What's Changed

  • 🐛 Preserve unstructured object GVKs when using *ByObject cache options by @joelanford in #2249

Full Changelog: v0.14.5...v0.14.6

v0.14.5

01 Mar 21:10
ffb74e5
Compare
Choose a tag to compare

What's Changed

  • 🐛 Allow to set GracefulShutdownTimeout to -1, disabling timeouts in #2198
  • 🌱 GVKForObject should handle multiple GVKs in Scheme gracefully in #2202
  • ✨ Add rest client request duration and size metrics in #2218
  • 🐛 Allow lazy restmapper to work with CRDs created at runtime in #2219

Full Changelog: v0.14.4...v0.14.5

v0.14.4

06 Feb 01:45
b9940ed
Compare
Choose a tag to compare

What's Changed

Full Changelog: v0.14.3...v0.14.4

v0.14.3

04 Feb 21:18
5055a52
Compare
Choose a tag to compare

What's Changed

Full Changelog: v0.14.2...v0.14.3

v0.14.2

27 Jan 19:15
7a4c6ec
Compare
Choose a tag to compare

What's Changed

Full Changelog: v0.14.1...v0.14.2

v0.14.1

19 Dec 23:13
84c5c9f
Compare
Choose a tag to compare

Changes since v0.14.0

🐛 Bug Fixes

Full Changelog: v0.14.0...v0.14.1

v0.14.0

15 Dec 05:30
ddcb99d
Compare
Choose a tag to compare

Changes since v0.13.1

⚠️ Breaking Changes

  • Add Get functionality to SubResourceClient (#2094)
  • Allow configuring RecoverPanic for controllers globally (#2093)
  • Add client.SubResourceWriter (#2072)
  • Support registration and removal of event handler (#2046)
  • Update Kubernetes dependencies to v0.26 (#2043, #2087)
  • Zap log: Default to RFC3339 time encoding (#2029)
  • cache.BuilderWithOptions inherit options from caller (#1980)
  • Migrate to ginkgo v2 (#1977), this removes the pkg/envtest/printer package

✨ New Features

  • Builder: Do not require For (#2091)
  • support disable deepcopy on list funcion (#2076)
  • Add cluster.NewClientFunc with options (#2054)
  • Tidy up startup logging of kindWithCache source (#2057)
  • Add function to get reconcileID from context (#2056)
  • feat: add NOT predicate (#2031)
  • Allow to provide a custom lock interface to manager (#2027)
  • Add tls options to manager.Options (#2023)
  • Update Go version to 1.19 (#1986)

🐛 Bug Fixes

  • Prevent manager from getting started a second time (#2090)
  • Missing error log for in-cluster config (#2051)
  • Skip custom mutation handler when delete a CR (#2049)
  • fix: improve semantics of combining cache selectorsByObject (#2039)
  • Conversion webhook should not panic when conversion request is nil (#1970)

🌱 Others

  • Prepare for release 0.14 (#2100)
  • Generate files and update modules (#2096)
  • Bump github.com/onsi/ginkgo/v2 from 2.5.1 to 2.6.0 (#2097)
  • Bump golang.org/x/time (#2089)
  • Update OWNERS: remove inactive members, promote fillzpp sbueringer (#2088, #2092)
  • Default ENVTEST version to a working one (1.24.2) (#2081)
  • Update golangci-lint to v1.50.1 (#2080)
  • Bump go.uber.org/zap from 1.23.0 to 1.24.0 (#2077)
  • Bump golang.org/x/sys from 0.2.0 to 0.3.0 (#2078)
  • Ignore Kubernetes Dependencies in Dependabot (#2071)
  • Bump github.com/prometheus/client_golang from 1.13.0 to 1.14.0 (#2070)
  • Bump github.com/onsi/ginkgo/v2 from 2.5.0 to 2.5.1 (#2066)
  • seedling to dependabot (#2065)
  • Bump github.com/onsi/gomega from 1.23.0 to 1.24.1 (#2062)
  • Bump go.uber.org/zap from 1.21.0 to 1.23.0 (#2060)
  • Bump actions/checkout from 2 to 3 (#2059)
  • Bump golangci/golangci-lint-action from 2 to 3 (#2058)
  • Add Dependabot for dependency management (#2050)
  • Deprecate Webhook Server TLSMinVersion (#2041)
  • Bump kubebuilder-release-tools to v0.2.0 (#2012)
  • grammar: removed doubles of the word "the" (#2006)
  • Refactor typed_client and unstructured_client to be consistent (#1795)

📖 Additionally, there have been 4 contributions to our documentation and book. (#2034, #2030, #2017, #1992)

Thanks to all our contributors! 😊

New Contributors

Full Changelog: v0.13.1...v0.14.0

v0.13.1

03 Nov 15:51
44c5d50
Compare
Choose a tag to compare

What's Changed

  • ✨ Add tls options to manager.Options in #2028

Full Changelog: v0.13.0...v0.13.1