Breaking changes
Policy and service account permissions
- Disable Helm namespace creation by default when a
Policyrequires a service account; setallowNamespaceCreationtotrueto permit it (GHSA-m93g-8438-2cgg) by @p-se in #5351 - Require deployment service account permissions for copying downstream Secrets and ConfigMaps (GHSA-q9v4-358v-r8q5) by @p-se in #5787
- Restrict
downstreamResourcesthrough the newPolicyfieldallowedDownstreamResources; when aPolicyrequires a service account and the list is empty, no Secrets or ConfigMaps are copied by @p-se in #6100 - Manage namespace labels and annotations with server-side apply, preserving metadata owned by other managers; deployment service accounts need
patchinstead ofupdatepermission on namespaces #4564 by @p-se in #5460
Cluster registration
- Bind agent-initiated cluster registrations to their registration token; the
allowClusterRegistrationTokenChangeHelm value permits token changes (GHSA-gx8v-2929-9q95) by @thardeck in #5950 - Require kubeconfig Secrets referenced across namespaces to carry the
fleet.cattle.io/kubeconfig-referenceable-fromlabel naming theClusternamespace; theallowUnlabeledKubeConfigSecretNamespacesHelm value accepts unlabeled Secrets in the well-known namespaces (GHSA-qfmw-gw96-ffcr) by @thardeck in #5968
Templating and Helm values
- Restrict Helm
valuesFilespaths to the checkout root (GHSA-wpfm-r97v-3j4h) by @thardeck in #5775 - Remove
getHostByNamefrom template functions (GHSA-x9m6-xcjr-hpjp) by @thardeck in #5606
Deprecation notice
-
GitRepoRestrictionis deprecated in favor ofPolicy; removal is planned for Rancherv2.17.0#5306 by @d3flex in #5347 -
Unauthenticated webhook calls are now deprecated. Fleet's webhook server warns about such calls when receiving them. See the docs for configuring a webhook secret. Issue #5298 resolved by @d3flex in #5419
Future Deprecation notice
- imagescan will be deprecated in v0.18, to be then removed in v0.19.
keepResourceswill be deprecated in v0.18, in favor of a new option. See #5941 for more context.
Notable changes
- Label deployed resources with their Fleet source #5262 by @d3flex in #5834
- Report bundle deployment failures and recovery as Kubernetes events #4455 by @0xavi0 in #5515
Features and Enhancements
Deployment and configuration
- Render templates in
namespaceLabelsandnamespaceAnnotations#4140 by @d3flex in #5956 - Validate
GitRepodefaults againstPolicyandGitRepoRestrictionallow-lists #5422 by @p-se in #5285 - Validate
diff.comparePatchesfields early #4663 by @0xavi0 in #5669 - Apply all bundles before returning errors from
fleet apply#4883 by @thardeck in #5446 - Generate a JSON Schema for
fleet.yaml#1962 by @d3flex in #5507
Webhooks
Observability
- Report agent version and surface version mismatches #4813 by @p-se in #5404
- Surface the Helm values hash in CLI monitor snapshots #4511 by @d3flex in #5467
- Send a Fleet versioned
User-Agenton outbound requests #4085 by @d3flex in #5862
Performance and upgrades
- Cache compiled
ClusterGrouplabel selectors to reduce CPU usage #5444 by @himabindugit in #5445 - Add jitter to cluster status updates #5444 by @himabindugit in #5466
- Skip configuration re-apply and callbacks for unmodified reloads #5809 by @d3flex in #5452
- Prevent cross-version configuration hot-reload during upgrades #3547 by @d3flex in #5397
Bug fixes
Helm and bundle deployment
- Apply Helm release name truncation during garbage collection #5261 by @nilsalex in #5302
- Confirm upstream deletion before uninstalling releases #5406 by @0xavi0 in #5585
- Avoid false-positive diffs for controller-injected webhook
caBundlevalues #5401 by @susesamu in #5369 - Fix deploying charts that define CRDs and use
lookup#5630 by @0xavi0 in #5689 - Support OCI build metadata in Helm chart versions #5410 by @0xavi0 in #5808
- Apply pod-security labels from
namespaceLabels#5550 by @p-se in #5687 - Scope namespace metadata to matched target customizations #4210 by @immanuwell in #5319
- Fix
deleteNamespacefor multi-cluster setups #5800 by @weyfonk in #5799
Status and CLI
- Report the
WaitingForDependencystate for bundles blocked by dependencies #4797 by @0xavi0 in #5549 - Fix
GitRepoandHelmOpstatus races that drop concurrent conditions by @0xavi0 in #5717 - Clear
StalledwhenGitRepopolling recovers #5907 by @0xavi0 in #5909 - Allow
fleet apply --outputwithout a kubeconfig #5426 by @0xavi0 in #5621
Authentication and integrations
- Drop reserved Fleet and Rancher labels during agent-initiated cluster registration (GHSA-h9p5-fp5h-qpqr) by @0xavi0 in #5605
- Apply webhook-triggered
pollingIntervalchanges only for verified requests (GHSA-8vfv-33cg-g75q) by @thardeck in #5781 - Respect
spec.caBundlefor GitHub App authentication #5738 by @rajeshkio in #5740 - Warn when
helmRepoURLRegexstrips credentials from a non-matching chart URL #5793 by @aisensiy in #5794 - Reconcile the agent when
agentPullSecretchanges #5815 by @d3flex in #5816
Notable Dependency Updates
- Update Go to
v1.27.4(CVE-2026-111943, CVE-2026-97054) byrenovatein #6112 - Update
golang.org/x/cryptotov0.59.0(GO-2026-5932) byrenovatein #6132 - Update
go.opentelemetry.io/otel/sdkandgo.opentelemetry.io/otel/tracetov1.47.0(GHSA-q7gw-24fr-5p69) byrenovatein #6141 - Update
oras.land/oras-go/v2tov2.6.4(CVE-2026-50163) byrenovatein #6010 - Update
github.com/go-git/go-git/v5tov5.19.3byrenovatein #5925 - Update
golang.org/x/nettov0.62.0(GHSA-75pg-wvh3-34jr, GHSA-vwcj-r8v9-p53f) byrenovatein #6025 - Update
helm.sh/helm/v4tov4.3.1byrenovatein #5998 - Update
github.com/rancher/wrangler/v3tov3.8.0byrenovatein #6137 - Update Kubernetes dependencies to
v1.37.2byrenovatein #6075
New Contributors
- @nilsalex made their first contribution in #5302
- @aisensiy made their first contribution in #5794
- @himabindugit made their first contribution in #5466
- @rajeshkio made their first contribution in #5740
- @kojah made their first contribution in #5804
- @ifraixedes made their first contribution in #5893
Full Changelog: v0.16.0...v0.17.0