Sourced from sigs.k8s.io/controller-runtime's releases.
v0.15.0
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
:warning: Breaking Changes
- Make
*http.Clientconfigurable and use/share the same client by default (#2122)
- When using the default Manager configuration, no immediate changes are needed.
client/apiutil.NewDynamicRESTMappersignature has changed and now requires an*http.Clientas parameter.cluster.Clusterinterface requiresGetHTTPClient()method which must return an already configured, non-nil,*http.Clientfor the Cluster. When usingcluster.Newto create Clusters, the client is created internally if not specified as anOptionsfield.cluster.Options.MapperProviderfield now requires a*rest.Configand*http.Client.- Deprecate Component Configuration
config/v1alpha1types (#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.Optionsdirectly.- 👉 Feedback requested: removal of the deprecated types and code is tracked in #895.
- Remove dependency injection functions (#2134, #2120)
- The package
pkg/injecthas been removed, this package contained long deprecated injection functions (likeInjectScheme,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
Managerto structs or interfaces that need them.- Improve
builderpackage capabilities and general UX (#2135)
builder.Builder.Watchessignature has changed, it now takes aclient.Objectinstead of asource.Sourceas first argument.
- For
source.Source, useWatchesRawSource.builder.Builder.WatchesMetadatahas been added to simplify watchingPartialObjectMetadataobjects.- Refactor cache.Options, deprecate MultiNamespacedCacheBuilder (#2157, #2166)
cache.Options.Namespacehas been removed in favor ofcache.Options.Namespaces, a slice.cache.Options.Resynchas been renamed toSyncPeriod.cache.Options.DefaultSelectorhas been removed and split in two fields:
cache.Options.DefaultLabelSelectorcache.Options.DefaultFieldSelectorcache.Options.DefaultTransformwas added to provide a global transform function.cache.Options.UnsafeDisableDeepCopywas added to provide a global toggle to disable DeepCopy of the objects from the cache before returning them to clients.- The following
[..]ByObjectfield have been refactored:
cache.Options.SelectorsByObjecthas been removed, usecache.Options.ByObject[Object].Fieldandcache.Options.ByObject[Object].Labelcache.Options.UnsafeDisableDeepCopyByObjecthas been removed, usecache.Options.ByObject[Object].UnsafeDisableDeepCopy.cache.Options.TransformByObjecthas been removed, usecache.Options.ByObject[Object].Transform.cache.ObjectAllhas 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.EventHandlerandhandler.Funcsinterfaces requirecontext.Contextas the first parameter for every method.handler.MapFuncsignature has changed and now requires acontext.Context.- Add client.{GroupVersionKindFor, IsObjectNamespaced} (#2136)
- The
client.Clientinterface now requires and exposes these helper functions:
... (truncated)
116a1b8
Merge pull request #2340
from kubernetes-sigs/dependabot/go_modules/github.co...96bf7c3
:seedling: Bump github.com/onsi/gomega from 1.27.6 to 1.27.7f9a3164
Merge pull request #2338
from howardjohn/mod/bump-jsonpatch73ae72f
:seedling: bump jsonpatch to v2.3.0e7b9407
Merge pull request #2334
from sbueringer/pr-webhook-log-levelsbabed98
Reduce webhook log verbosity260b822
Merge pull request #2333
from lucacome/tests-0.27.2c8b911b
Re-enable tests for v0.27.21fe22d0
Merge pull request #2330
from lucacome/bump-k8s.io-deps0cc8dd8
Bump k8s.io dependencies