:warning: Deprecation Warnings

Please note that admission.Defaulter/Validator have been deprecated in favor of admission.CustomDefaulter/CustomValidator since v0.17 and will be removed with v0.20.

:warning: Breaking Changes

• Bump to k8s.io/* v1.31 (#2798 #2858 #2867 #2872 #2883 #2900 #2906 #2924)
• Add generic TypedReconciler (#2799)
• client: Remove options.WarningHandler (#2887 #2903)
• controller: Validate controller names are unique & add SkipNameValidation option (#2902 #2918)

:sparkles: New Features

• client: Add WithFieldValidation client (#2860 #2913)
• controller & webhook: Recover panics per default & add panic metrics (#2905)
• controllerutil: configure BlockOwnerDeletion when setting OwnerReference (#2847)
• fake client: Add scale subresource logic (#2855)
• predicate: Add missing generic version of ResourceVersionChangedPredicate (#2812)
• setup-envtest: Download binaries from controller-tools releases instead of GCS (#2811)
• setup-envtest: Publish setup-envtest binaries via release attachments (#2911)
• workqueue: Add controller label to workqueue metrics (#2895)

:bug: Bug Fixes

• apiutil.IsGVKNamespaced: Fix namespaced GVK check to use version (#2875)
• cache: Fix label defaulting of byObject when namespaces are configured (#2805)
• certwatcher: Recreate watcher if the file is unlinked and replaced (#2893)
• manager: Fix log in AddMetricsServerExtraHandler (#2874)
• manager: Quiet context.Canceled errors during shutdown (#2745)
• manager: Reintroduce AddMetricsServerExtraHandler (#2813)
• manager.Start: Prevent LeaderElector setup error from being swallowed (#2876)
• source.Kind: String() should return correct type (#2806)

:seedling: Others

• actions: Add action to approve actions if /ok-to-test is set (#2908)
• controller: Add dynamic watcher tests (#2881)
• dependabot: disable go module bumps, bump all actions in a single PR (#2856)
• verify-modules: Verify go modules are in sync with upstream k/k (#2774)

:book: Additionally, there have been 5 contributions to our documentation. (#2830, #2849, #2863, #2894, #2899, #2910)

Dependencies

Added

• cel.dev/expr: v0.15.0
• github.com/antlr4-go/antlr/v4: v4.13.0
• github.com/cpuguy83/go-md2man/v2: v2.0.4
• github.com/go-task/slim-sprig/v3: v3.0.0
• github.com/russross/blackfriday/v2: v2.1.0
• gopkg.in/evanphx/json-patch.v4: v4.12.0

Changed

• cloud.google.com/go/compute/metadata: v0.2.3 → v0.3.0
• github.com/alecthomas/kingpin/v2: v2.3.2 → v2.4.0
• github.com/cenkalti/backoff/v4: v4.2.1 → v4.3.0
• github.com/cespare/xxhash/v2: v2.2.0 → v2.3.0
• github.com/chzyer/readline: 2972be2 → v1.5.1
• github.com/cncf/xds/go: e9ce688 → 555b57e
• github.com/davecgh/go-spew: v1.1.1 → d8f796a
• github.com/envoyproxy/go-control-plane: v0.11.1 → v0.12.0
• github.com/envoyproxy/protoc-gen-validate: v1.0.2 → v1.0.4
• github.com/evanphx/json-patch: v4.12.0+incompatible → v0.5.2
• github.com/felixge/httpsnoop: v1.0.3 → v1.0.4
• github.com/fxamacker/cbor/v2: v2.6.0 → v2.7.0
• github.com/go-logr/logr: v1.4.1 → v1.4.2
• github.com/go-openapi/swag: v0.22.3 → v0.22.4
• github.com/golang/glog: v1.1.0 → v1.2.1
• github.com/google/cel-go: v0.17.8 → v0.20.1
• github.com/google/pprof: 4bb14d4 → 4bfdf5a
• github.com/google/uuid: v1.3.0 → v1.6.0
• github.com/grpc-ecosystem/grpc-gateway/v2: v2.16.0 → v2.20.0
• github.com/ianlancetaylor/demangle: 28f6c0f → bd984b5
• github.com/matttproud/golang_protobuf_extensions: v1.0.4 → v1.0.1
• github.com/moby/spdystream: v0.2.0 → v0.4.0
• github.com/moby/term: 1aeaba8 → v0.5.0
• github.com/onsi/ginkgo/v2: v2.17.1 → v2.19.0
• github.com/onsi/gomega: v1.32.0 → v1.33.1
• github.com/pmezard/go-difflib: v1.0.0 → 5d4384e
• github.com/prometheus/client_golang: v1.16.0 → v1.19.1
• github.com/prometheus/client_model: v0.4.0 → v0.6.1
• github.com/prometheus/common: v0.44.0 → v0.55.0
• github.com/prometheus/procfs: v0.12.0 → v0.15.1
• github.com/rogpeppe/go-internal: v1.10.0 → v1.12.0
• github.com/sirupsen/logrus: v1.9.0 → v1.9.3
• github.com/spf13/cobra: v1.7.0 → v1.8.1
• github.com/stretchr/testify: v1.8.4 → v1.9.0
• go.etcd.io/bbolt: v1.3.8 → v1.3.9
• go.etcd.io/etcd/api/v3: v3.5.10 → v3.5.14
• go.etcd.io/etcd/client/pkg/v3: v3.5.10 → v3.5.14
• go.etcd.io/etcd/client/v2: v2.305.10 → v2.305.13
• go.etcd.io/etcd/client/v3: v3.5.10 → v3.5.14
• go.etcd.io/etcd/pkg/v3: v3.5.10 → v3.5.13
• go.etcd.io/etcd/raft/v3: v3.5.10 → v3.5.13
• go.etcd.io/etcd/server/v3: v3.5.10 → v3.5.13
• go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc: v0.42.0 → v0.53.0
• go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp: v0.44.0 → v0.53.0
• go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc: v1.19.0 → v1.27.0
• go.opentelemetry.io/otel/exporters/otlp/otlptrace: v1.19.0 → v1.28.0
• go.opentelemetry.io/otel/metric: v1.19.0 → v1.28.0
• go.opentelemetry.io/otel/sdk: v1.19.0 → v1.28.0
• go.opentelemetry.io/otel/trace: v1.19.0 → v1.28.0
• go.opentelemetry.io/otel: v1.19.0 → v1.28.0
• go.opentelemetry.io/proto/otlp: v1.0.0 → v1.3.1
• golang.org/x/crypto: v0.21.0 → v0.24.0
• golang.org/x/exp: a9213ee → f3d0a9c
• golang.org/x/mod: v0.15.0 → v0.17.0
• golang.org/x/net: v0.23.0 → v0.26.0
• golang.org/x/oauth2: v0.12.0 → v0.21.0
• golang.org/x/sync: v0.6.0 → v0.7.0
• golang.org/x/sys: v0.18.0 → v0.21.0
• golang.org/x/telemetry: b75ee88 → f48c80b
• golang.org/x/term: v0.18.0 → v0.21.0
• golang.org/x/text: v0.14.0 → v0.16.0
• golang.org/x/tools: v0.18.0 → e35e4cc
• google.golang.org/genproto/googleapis/api: 23370e0 → 5315273
• google.golang.org/genproto/googleapis/rpc: b8732ec → f6361c8
• google.golang.org/genproto: f966b18 → b8732ec
• google.golang.org/grpc: v1.58.3 → v1.65.0
• google.golang.org/protobuf: v1.33.0 → v1.34.2
• k8s.io/api: v0.30.0 → v0.31.0
• k8s.io/apiextensions-apiserver: v0.30.0 → v0.31.0
• k8s.io/apimachinery: v0.30.0 → v0.31.0
• k8s.io/apiserver: v0.30.0 → v0.31.0
• k8s.io/client-go: v0.30.0 → v0.31.0
• k8s.io/code-generator: v0.30.0 → v0.31.0
• k8s.io/component-base: v0.30.0 → v0.31.0
• k8s.io/klog/v2: v2.120.1 → v2.130.1
• k8s.io/kms: v0.30.0 → v0.31.0
• k8s.io/utils: 3b25d92 → 18e509b
• sigs.k8s.io/apiserver-network-proxy/konnectivity-client: v0.29.0 → v0.30.3
• sigs.k8s.io/yaml: v1.3.0 → v1.4.0

Removed

• cloud.google.com/go/compute: v1.21.0
• github.com/antlr/antlr4/runtime/Go/antlr/v4: 8188dc5
• github.com/chzyer/logex: v1.1.10
• github.com/chzyer/test: a1ea475
• github.com/cncf/udpa/go: c52dc94
• github.com/go-task/slim-sprig: 52ccab3

Thanks to all our contributors! 😊