Flux v2.8.8 is a patch release that includes CVE fixes via go-git v5.19.1 (source-controller, image-automation-controller), reliability fixes in helm-controller and source-controller, the move of Helm back to upstream v4.2.0, support for GCP sovereign cloud artifact registries, and dependency updates. Users are encouraged to upgrade for the best experience.
Flux v2.8.7 is a patch release that includes a bug fix in kustomize-controller, a CVE fix in source-controller and image-automation-controller via go-git v5.19.0, and dependency updates. Users are encouraged to upgrade for the best experience.
Fix management of objects annotated with kustomize.toolkit.fluxcd.io/ssa: IfNotPresent where non-namespaced resources were being deleted and recreated on each reconciliation (kustomize-controller)
Improvements:
Update go-git to v5.19.0 which fixes CVE-2026-45022 (source-controller, image-automation-controller)
Flux v2.8.6 is a patch release that includes bug fixes and improvements across helm-controller, image-automation-controller, kustomize-controller, notification-controller, and source-controller. Users are encouraged to upgrade for the best experience.
Flux v2.8.5 is a patch release that includes bug fixes and improvements across kustomize-controller, source-controller, and notification-controller. Users are encouraged to upgrade for the best experience.
Fix enqueuing new reconciliation requests for events on source Flux objects when they are already reconciling the revision present in the watch event (kustomize-controller, helm-controller)
Fix the Go templates bug of YAML separator --- getting concatenated to apiVersion: by updating to Helm 4.1.3 (helm-controller)
Fix canceled HelmReleases getting stuck when they don't have a retry strategy configured by introducing a new feature gate DefaultToRetryOnFailure that improves the experience when the CancelHealthCheckOnNewRevision is enabled (helm-controller)
Fix the auth scope for Azure Container Registry to use the ACR-specific scope (source-controller, image-reflector-controller)
Fix potential Denial of Service (DoS) during TLS handshakes (CVE-2026-27138) by building all controllers with Go 1.26.1
Flux v2.8.0 is a feature release. Users are encouraged to upgrade for the best experience.
For a compressive overview of new features and API changes included in this release, please refer to the Announcing Flux 2.8 GA blog post.
Overview of the new features:
Helm v4 support, including server-side apply and kstatus-based health checking (HelmRelease)
Readiness evaluation of Helm-managed objects with CEL expressions (HelmRelease)
Improved observability of Helm releases with inventory tracking in .status.inventory (HelmRelease)
Reduced the mean time to recovery of Flux-managed applications via CancelHealthCheckOnNewRevision feature gate (Kustomization, HelmRelease)
Support for commenting on Pull Requests directly from Flux notifications (Provider)
Custom SSA apply stages for ordering resource application in kustomize-controller (Kustomization)
Automatic GitHub App installation ID lookup from the repository owner (GitRepository, ImageUpdateAutomation, Provider)
Support for Cosign v3 for verifying OCI artifacts and container images (OCIRepository)
ArtifactGenerator support for extracting and modifying Helm charts (ArtifactGenerator)
Bypass cache when fetching source objects via DirectSourceFetch feature gate (Kustomization, HelmRelease, ArtifactGenerator)
❤️ Big thanks to all the Flux contributors that helped us with this release!
Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
Kubernetes version
Minimum required
v1.33
>= 1.32.0
v1.34
>= 1.34.1
v1.35
>= 1.35.0
[!NOTE]
Note that the Flux project offers support only for the latest three minor versions of Kubernetes.
Backwards compatibility with older versions of Kubernetes and OpenShift is offered by vendors such as ControlPlane that provide enterprise support for Flux.
OpenShift compatibility
Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub using Flux Operator. The operator allows the configuration of Flux multi-tenancy lockdown, network policies, persistent storage, sharding, vertical scaling and the synchronization of the cluster state from Git repositories, OCI artifacts, and S3-compatible storage.
Upgrade procedure
⚠️ The Flux APIs v1beta2 and v2beta2 (deprecated in 2024) have reached end-of-life and have been removed from the CRDs.
Fix HelmRelease history truncation when using the RetryOnFailure strategy.
⚠️ Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3.
Flux users are advised to use Cosign v2.6 for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.
Add DisableConfigWatchers feature gate to all controllers for disabling the Secrets/ConfigMaps watchers
Fix Workload Identity for Azure China Cloud in all controllers
Update Helm Go SDK to v3.19.2 fixing schema validation issues in helm-controller
Skip secret decryption for remote kustomize patches in kustomize-controller
Improve post-build error reporting in kustomize-controller
Add ArtifactGenerator to aggregated RBAC roles
⚠️ Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3.
Flux users are advised to use Cosign v2.6 for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.
Fix status reporting of HelmReleases with RetryOnFailure strategy
Automated retries for ImagePolicies when no image tags are found in the database
Fix alerting for Telegram's message_thread_id
Allow running kustomize-controller and helm-controller on the same loopback interface as source-watcher
⚠️ Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3. Users are advised to use Cosign v2.6 for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.
All Flux components are now built with Go 1.25.2 which includes fixes for vulnerabilities in the Go stdlib that could lead to denial of service. The list of security fixes can be found in the Go 1.25.2 release notes.
❤️ Big thanks to all the Flux contributors that helped us with this release!
Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
Kubernetes version
Minimum required
v1.32
>= 1.32.0
v1.33
>= 1.33.0
v1.34
>= 1.34.1
[!NOTE]
Note that the Flux project offers support only for the latest three minor versions of Kubernetes.
Backwards compatibility with older versions of Kubernetes and OpenShift is offered by vendors such as ControlPlane that provide enterprise support for Flux.
OpenShift compatibility
Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub using Flux Operator. The operator allows the configuration of Flux multi-tenancy lockdown, network policies, persistent storage, sharding, vertical scaling and the synchronization of the cluster state from Git repositories, OCI artifacts, and S3-compatible storage.
Upgrade procedure
⚠️ The Flux APIs v1beta1 and v2beta1 (deprecated in 2023) have reached end-of-life and have been removed from the CRDs.
Unless you are using Flux Operator to deploy the Flux controllers, you must run the flux migrate command on clusters before upgrading.
Flux v2.6.3 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
Fix for rsa-sha2-512 and rsa-sha2-256 algorithms not being prioritized for ssh-rsa host keys in source-controller, image-automation-controller and Flux CLI bootstrap.
❤️ Big thanks to all the Flux contributors that helped us with this release!
Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
Kubernetes version
Minimum required
v1.31
>= 1.31.0
v1.32
>= 1.32.0
v1.33
>= 1.33.0
[!NOTE]
Note that the Flux project offers support only for the latest three minor versions of Kubernetes.
Backwards compatibility with older versions of Kubernetes and OpenShift is offered by vendors such as ControlPlane that provide enterprise support for Flux.
OpenShift compatibility
Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub using Flux Operator.
The operator allows the configuration of Flux multi-tenancy lockdown, network policies, persistent storage, sharding, vertical scaling and the synchronization of the cluster state from Git repositories, OCI artifacts, and S3-compatible storage.
Upgrade procedure
Upgrade Flux from v2.5.0 to v2.6.0 by following the upgrade guide.
To upgrade the APIs, make sure the new CRDs and controllers are deployed, and then change the manifests in Git:
Set apiVersion: source.toolkit.fluxcd.io/v1 in the YAML files that contain OCIRepository definitions.
Add an annotation api.fluxcd.io/upgrade: "v2.6.0" to the OCIRepository resources. (this is not required if Flux Operator is used for upgrade)
Commit, push, and reconcile the API version changes.
Bumping the APIs version in manifests can be done gradually.
It is advised to not delay this procedure as the deprecated versions will be removed after 6 months.
This PR contains the following updates:
| Package | Update | Change |
|---|---|---|
| [fluxcd/flux2](https://github.com/fluxcd/flux2) | minor | `v2.5.0` → `v2.8.8` |
---
### Release Notes
<details>
<summary>fluxcd/flux2 (fluxcd/flux2)</summary>
### [`v2.8.8`](https://github.com/fluxcd/flux2/releases/tag/v2.8.8)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.8.7...v2.8.8)
#### Highlights
Flux v2.8.8 is a patch release that includes CVE fixes via go-git v5.19.1 (source-controller, image-automation-controller), reliability fixes in helm-controller and source-controller, the move of Helm back to upstream v4.2.0, support for GCP sovereign cloud artifact registries, and dependency updates. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Add a configurable HTTP timeout for artifact fetching, preventing fetches that could block indefinitely and stall reconciliations (helm-controller)
- Fix unbounded memory growth caused by a Kubernetes client transport retry wrapper accumulating on every reconcile (helm-controller)
- Stop force-applying non-CRD objects placed under a chart's `crds/` directory (helm-controller)
- Fix the Helm test action failing to find releases with names longer than 53 characters (helm-controller)
- Improve path handling in the source reconcilers (source-controller)
- Support Helm semver build-metadata encoding in OCIRepository tags (source-controller)
Improvements:
- Update go-git to v5.19.1 which fixes [CVE-2026-45571](https://github.com/advisories/GHSA-crhj-59gh-8x96) and [CVE-2026-45570](https://github.com/advisories/GHSA-m7cr-m3pv-hgrp) (source-controller, image-automation-controller)
- Move Helm back to upstream v4.2.0 (source-controller, helm-controller)
- Add support for GCP sovereign cloud artifact registries (source-controller, image-reflector-controller)
- Upgrade Kubernetes to 1.36.1 (source-controller, helm-controller)
- Update fluxcd/pkg dependencies
#### Components changelog
- helm-controller [v1.5.5](https://github.com/fluxcd/helm-controller/blob/v1.5.5/CHANGELOG.md)
- image-automation-controller [v1.1.4](https://github.com/fluxcd/image-automation-controller/blob/v1.1.4/CHANGELOG.md)
- image-reflector-controller [v1.1.2](https://github.com/fluxcd/image-reflector-controller/blob/v1.1.2/CHANGELOG.md)
- source-controller [v1.8.5](https://github.com/fluxcd/source-controller/blob/v1.8.5/CHANGELOG.md)
#### CLI changelog
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5904](https://github.com/fluxcd/flux2/pull/5904)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.8.7...v2.8.8>
### [`v2.8.7`](https://github.com/fluxcd/flux2/releases/tag/v2.8.7)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.8.6...v2.8.7)
#### Highlights
Flux v2.8.7 is a patch release that includes a bug fix in kustomize-controller, a CVE fix in source-controller and image-automation-controller via go-git v5.19.0, and dependency updates. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Fix management of objects annotated with `kustomize.toolkit.fluxcd.io/ssa: IfNotPresent` where non-namespaced resources were being deleted and recreated on each reconciliation (kustomize-controller)
Improvements:
- Update go-git to v5.19.0 which fixes [CVE-2026-45022](https://github.com/advisories/GHSA-389r-gv7p-r3rp) (source-controller, image-automation-controller)
- Update fluxcd/pkg dependencies (source-controller, kustomize-controller, image-automation-controller)
#### Components changelog
- helm-controller [v1.5.4](https://github.com/fluxcd/helm-controller/blob/v1.5.4/CHANGELOG.md)
- image-automation-controller [v1.1.3](https://github.com/fluxcd/image-automation-controller/blob/v1.1.3/CHANGELOG.md)
- kustomize-controller [v1.8.5](https://github.com/fluxcd/kustomize-controller/blob/v1.8.5/CHANGELOG.md)
- notification-controller [v1.8.4](https://github.com/fluxcd/notification-controller/blob/v1.8.4/CHANGELOG.md)
- source-controller [v1.8.4](https://github.com/fluxcd/source-controller/blob/v1.8.4/CHANGELOG.md)
#### CLI changelog
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5891](https://github.com/fluxcd/flux2/pull/5891)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.8.6...v2.8.7>
### [`v2.8.6`](https://github.com/fluxcd/flux2/releases/tag/v2.8.6)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.8.5...v2.8.6)
#### Highlights
Flux v2.8.6 is a patch release that includes bug fixes and improvements across helm-controller, image-automation-controller, kustomize-controller, notification-controller, and source-controller. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Fix a post-renderer conflict between overlapping hooks and templates (helm-controller)
- Ignore force replace when server-side apply is enabled (helm-controller)
- Fix a regression where generic providers would not forward commit status events (notification-controller)
- Require the `audience` field on the GCR Receiver secret for tighter verification — will become mandatory in Flux v2.9 (notification-controller)
Improvements:
- Introduce the `MigrateAPIVersion` feature gate for migrating the API version of resources in managed field entries (kustomize-controller)
- Update go-git to v5.18.0 bringing performance improvements for Git operations (source-controller, image-automation-controller)
#### Components changelog
- helm-controller [v1.5.4](https://github.com/fluxcd/helm-controller/blob/v1.5.4/CHANGELOG.md)
- image-automation-controller [v1.1.2](https://github.com/fluxcd/image-automation-controller/blob/v1.1.2/CHANGELOG.md)
- kustomize-controller [v1.8.4](https://github.com/fluxcd/kustomize-controller/blob/v1.8.4/CHANGELOG.md)
- notification-controller [v1.8.4](https://github.com/fluxcd/notification-controller/blob/v1.8.4/CHANGELOG.md)
- source-controller [v1.8.3](https://github.com/fluxcd/source-controller/blob/v1.8.3/CHANGELOG.md)
#### CLI changelog
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5857](https://github.com/fluxcd/flux2/pull/5857)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.8.5...v2.8.6>
### [`v2.8.5`](https://github.com/fluxcd/flux2/releases/tag/v2.8.5)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.8.4...v2.8.5)
#### Highlights
Flux v2.8.5 is a patch release that includes bug fixes and improvements across kustomize-controller, source-controller, and notification-controller. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Fix a race condition where a cancelled reconciliation could leave stale data in the cache, causing Kustomizations to get stuck (kustomize-controller)
- Fix Azure Blob prefix option not being passed to the storage client (source-controller)
Improvements:
- Improve error message for encrypted SSH keys without password (source-controller)
- Add optional `email` and `audience` fields to the GCR Receiver for tighter verification (notification-controller)
- Add provider manifest example for Azure Event Hub managed identity authentication (notification-controller)
#### Components changelog
- kustomize-controller [v1.8.3](https://github.com/fluxcd/kustomize-controller/blob/v1.8.3/CHANGELOG.md)
- source-controller [v1.8.2](https://github.com/fluxcd/source-controller/blob/v1.8.2/CHANGELOG.md)
- notification-controller [v1.8.3](https://github.com/fluxcd/notification-controller/blob/v1.8.3/CHANGELOG.md)
#### CLI changelog
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5822](https://github.com/fluxcd/flux2/pull/5822)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.8.4...v2.8.5>
### [`v2.8.4`](https://github.com/fluxcd/flux2/releases/tag/v2.8.4)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.8.3...v2.8.4)
#### Highlights
Flux v2.8.4 is a patch release that includes fixes for the Flux CLI. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Fix `flux build ks` and `flux diff ks` on Windows
- Fix `--source` flag validation in `create kustomization` command
#### CLI changelog
- Update fluxcd/pkg dependencies by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5796](https://github.com/fluxcd/flux2/pull/5796)
- \[release/v2.8.x] fix: validate --source flag in create kustomization command by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5799](https://github.com/fluxcd/flux2/pull/5799)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.8.3...v2.8.4>
### [`v2.8.3`](https://github.com/fluxcd/flux2/releases/tag/v2.8.3)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.8.2...v2.8.3)
#### Highlights
Flux v2.8.3 is a patch release that fixes a regression in helm-controller. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Fix templating errors for charts that include `---` in the content, e.g. YAML separators, embedded scripts, CAs inside ConfigMaps (helm-controller)
#### Components changelog
- helm-controller [v1.5.3](https://github.com/fluxcd/helm-controller/blob/v1.5.3/CHANGELOG.md)
#### CLI changelog
- \[release/v2.8.x] Add target branch name to update branch by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5774](https://github.com/fluxcd/flux2/pull/5774)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5779](https://github.com/fluxcd/flux2/pull/5779)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.8.2...v2.8.3>
### [`v2.8.2`](https://github.com/fluxcd/flux2/releases/tag/v2.8.2)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.8.1...v2.8.2)
#### Highlights
Flux v2.8.2 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Fix enqueuing new reconciliation requests for events on source Flux objects when they are already reconciling the revision present in the watch event (kustomize-controller, helm-controller)
- Fix the Go templates bug of YAML separator `---` getting concatenated to `apiVersion:` by updating to Helm 4.1.3 (helm-controller)
- Fix canceled HelmReleases getting stuck when they don't have a retry strategy configured by introducing a new feature gate `DefaultToRetryOnFailure` that improves the experience when the `CancelHealthCheckOnNewRevision` is enabled (helm-controller)
- Fix the auth scope for Azure Container Registry to use the ACR-specific scope (source-controller, image-reflector-controller)
- Fix potential Denial of Service (DoS) during TLS handshakes (CVE-2026-27138) by building all controllers with Go 1.26.1
#### Components changelog
- source-controller [v1.8.1](https://github.com/fluxcd/source-controller/blob/v1.8.1/CHANGELOG.md)
- kustomize-controller [v1.8.2](https://github.com/fluxcd/kustomize-controller/blob/v1.8.2/CHANGELOG.md)
- notification-controller [v1.8.2](https://github.com/fluxcd/notification-controller/blob/v1.8.2/CHANGELOG.md)
- helm-controller [v1.5.2](https://github.com/fluxcd/helm-controller/blob/v1.5.2/CHANGELOG.md)
- image-reflector-controller [v1.1.1](https://github.com/fluxcd/image-reflector-controller/blob/v1.1.1/CHANGELOG.md)
- image-automation-controller [v1.1.1](https://github.com/fluxcd/image-automation-controller/blob/v1.1.1/CHANGELOG.md)
- source-watcher [v2.1.1](https://github.com/fluxcd/source-watcher/blob/v2.1.1/CHANGELOG.md)
#### CLI changelog
- \[release/v2.8.x] build(deps): bump the ci group across 1 directory with 11 updates by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5765](https://github.com/fluxcd/flux2/pull/5765)
- Update fluxcd/pkg dependencies by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5767](https://github.com/fluxcd/flux2/pull/5767)
- Update toolkit components by [@​matheuscscp](https://github.com/matheuscscp) in [#​5770](https://github.com/fluxcd/flux2/pull/5770)
- Update fluxcd/pkg dependencies by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5771](https://github.com/fluxcd/flux2/pull/5771)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.8.1...v2.8.2>
### [`v2.8.1`](https://github.com/fluxcd/flux2/releases/tag/v2.8.1)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.8.0...v2.8.1)
#### Highlights
Flux v2.8.1 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Fix Git commit status events being dropped for Kustomizations (notification-controller)
- Fix health check for StatefulSets when the Pods are Pending/Unschedulable during rollout (helm-controller, kustomize-controller)
#### Components changelog
- kustomize-controller [v1.8.1](https://github.com/fluxcd/kustomize-controller/blob/v1.8.1/CHANGELOG.md)
- notification-controller [v1.8.1](https://github.com/fluxcd/notification-controller/blob/v1.8.1/CHANGELOG.md)
- helm-controller [v1.5.1](https://github.com/fluxcd/helm-controller/blob/v1.5.1/CHANGELOG.md)
#### CLI changelog
- \[release/v2.8.x] Remove no longer needed workaround for Flux 2.8 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5735](https://github.com/fluxcd/flux2/pull/5735)
- Update fluxcd/pkg dependencies by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5739](https://github.com/fluxcd/flux2/pull/5739)
- \[release/v2.8.x] Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5741](https://github.com/fluxcd/flux2/pull/5741)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.8.0...v2.8.1>
### [`v2.8.0`](https://github.com/fluxcd/flux2/releases/tag/v2.8.0)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.7.5...v2.8.0)
#### Highlights
Flux v2.8.0 is a feature release. Users are encouraged to upgrade for the best experience.
For a compressive overview of new features and API changes included in this release, please refer to the [Announcing Flux 2.8 GA blog post](https://fluxcd.io/blog/2026/02/flux-v2.8.0/).
Overview of the new features:
- Helm v4 support, including server-side apply and kstatus-based health checking (`HelmRelease`)
- Readiness evaluation of Helm-managed objects with CEL expressions (`HelmRelease`)
- Improved observability of Helm releases with inventory tracking in `.status.inventory` (`HelmRelease`)
- Reduced the mean time to recovery of Flux-managed applications via `CancelHealthCheckOnNewRevision` feature gate (`Kustomization`, `HelmRelease`)
- Support for commenting on Pull Requests directly from Flux notifications (`Provider`)
- Custom SSA apply stages for ordering resource application in kustomize-controller (`Kustomization`)
- Automatic GitHub App installation ID lookup from the repository owner (`GitRepository`, `ImageUpdateAutomation`, `Provider`)
- Support for Cosign v3 for verifying OCI artifacts and container images (`OCIRepository`)
- ArtifactGenerator support for extracting and modifying Helm charts (`ArtifactGenerator`)
- Bypass cache when fetching source objects via `DirectSourceFetch` feature gate (`Kustomization`, `HelmRelease`, `ArtifactGenerator`)
❤️ Big thanks to all the Flux contributors that helped us with this release!
##### Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
| Kubernetes version | Minimum required |
| ------------------ | ---------------- |
| `v1.33` | `>= 1.32.0` |
| `v1.34` | `>= 1.34.1` |
| `v1.35` | `>= 1.35.0` |
> \[!NOTE]
> Note that the Flux project offers support only for the latest three minor versions of Kubernetes.
> Backwards compatibility with older versions of Kubernetes and OpenShift is offered by vendors such as
> [ControlPlane](https://control-plane.io/enterprise-for-flux-cd/) that provide enterprise support for Flux.
##### OpenShift compatibility
Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub using [Flux Operator](https://operatorhub.io/operator/flux-operator). The operator allows the configuration of Flux multi-tenancy lockdown, network policies, persistent storage, sharding, vertical scaling and the synchronization of the cluster state from Git repositories, OCI artifacts, and S3-compatible storage.
#### Upgrade procedure
:warning: The Flux APIs `v1beta2` and `v2beta2` (deprecated in 2024) have reached end-of-life and have been removed from the CRDs.
Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from older versions of Flux to v2.8.
#### Components changelog
- source-controller [v1.8.0](https://github.com/fluxcd/source-controller/blob/v1.8.0/CHANGELOG.md)
- kustomize-controller [v1.8.0](https://github.com/fluxcd/kustomize-controller/blob/v1.8.0/CHANGELOG.md)
- notification-controller [v1.8.0](https://github.com/fluxcd/notification-controller/blob/v1.8.0/CHANGELOG.md)
- helm-controller [v1.5.0](https://github.com/fluxcd/helm-controller/blob/v1.5.0/CHANGELOG.md)
- image-reflector-controller [v1.1.0](https://github.com/fluxcd/image-reflector-controller/blob/v1.1.0/CHANGELOG.md)
- image-automation-controller [v1.1.0](https://github.com/fluxcd/image-automation-controller/blob/v1.1.0/CHANGELOG.md)
- source-watcher [v2.1.0](https://github.com/fluxcd/source-watcher/blob/v2.1.0/CHANGELOG.md)
#### CLI changelog
- ci: Set `GITHUB_TOKEN` in the `release-flux-manifests` workflow by [@​stefanprodan](https://github.com/stefanprodan) in [#​5547](https://github.com/fluxcd/flux2/pull/5547)
- Add backport label for Flux 2.7 by [@​matheuscscp](https://github.com/matheuscscp) in [#​5550](https://github.com/fluxcd/flux2/pull/5550)
- build(deps): bump the ci group across 1 directory with 3 updates by [@​dependabot](https://github.com/dependabot)\[bot] in [#​5548](https://github.com/fluxcd/flux2/pull/5548)
- Fix `flux push artifact` not working with `--provider` by [@​matheuscscp](https://github.com/matheuscscp) in [#​5551](https://github.com/fluxcd/flux2/pull/5551)
- Extend `flux migrate` to work with local files by [@​matheuscscp](https://github.com/matheuscscp) in [#​5554](https://github.com/fluxcd/flux2/pull/5554)
- Improve `flux migrate` for live cluster migrations by [@​stefanprodan](https://github.com/stefanprodan) in [#​5558](https://github.com/fluxcd/flux2/pull/5558)
- Fix `flux migrate -f` command to work with comments by [@​matheuscscp](https://github.com/matheuscscp) in [#​5560](https://github.com/fluxcd/flux2/pull/5560)
- Add source-watcher to docs by [@​stefanprodan](https://github.com/stefanprodan) in [#​5562](https://github.com/fluxcd/flux2/pull/5562)
- Fix `flux migrate -f` not considering kind comments by [@​matheuscscp](https://github.com/matheuscscp) in [#​5563](https://github.com/fluxcd/flux2/pull/5563)
- refactor: convert `Kustomization` resource into unstructured map only once during variable substitution by [@​ramasai1](https://github.com/ramasai1) in [#​5566](https://github.com/fluxcd/flux2/pull/5566)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5568](https://github.com/fluxcd/flux2/pull/5568)
- Disable AUR publishing by [@​stefanprodan](https://github.com/stefanprodan) in [#​5570](https://github.com/fluxcd/flux2/pull/5570)
- Fix manifest generation for `--storage-adv-addr` and `--events-addr` flags by [@​stefanprodan](https://github.com/stefanprodan) in [#​5574](https://github.com/fluxcd/flux2/pull/5574)
- Update dependencies to Kubernetes v1.34.1 and Go 1.25.2 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5576](https://github.com/fluxcd/flux2/pull/5576)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5578](https://github.com/fluxcd/flux2/pull/5578)
- Restore GitHub PAT for backports by [@​matheuscscp](https://github.com/matheuscscp) in [#​5581](https://github.com/fluxcd/flux2/pull/5581)
- \[RFC-0012] Add command `flux get source external` by [@​dgunzy](https://github.com/dgunzy) in [#​5555](https://github.com/fluxcd/flux2/pull/5555)
- fix: handle error when writing password prompt to stdout by [@​akshatsinha0](https://github.com/akshatsinha0) in [#​5589](https://github.com/fluxcd/flux2/pull/5589)
- Pin cosign to v2.6.1 by [@​matheuscscp](https://github.com/matheuscscp) in [#​5594](https://github.com/fluxcd/flux2/pull/5594)
- \[RFC-0012] Add command `flux export source external` by [@​dgunzy](https://github.com/dgunzy) in [#​5583](https://github.com/fluxcd/flux2/pull/5583)
- Fix bootstrap e2e test for image policy by [@​matheuscscp](https://github.com/matheuscscp) in [#​5604](https://github.com/fluxcd/flux2/pull/5604)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5603](https://github.com/fluxcd/flux2/pull/5603)
- fix: return accepted values for flags when calling Values.Type() by [@​jaxels10](https://github.com/jaxels10) in [#​5602](https://github.com/fluxcd/flux2/pull/5602)
- ci: Include source-watcher in the e2e test suite by [@​stefanprodan](https://github.com/stefanprodan) in [#​5614](https://github.com/fluxcd/flux2/pull/5614)
- Add source.extensions.fluxcd.io group to aggregated RBAC roles by [@​matheuscscp](https://github.com/matheuscscp) in [#​5627](https://github.com/fluxcd/flux2/pull/5627)
- Fix panic on reconcile with source of ExternalArtifact kind by [@​matheuscscp](https://github.com/matheuscscp) in [#​5630](https://github.com/fluxcd/flux2/pull/5630)
- Upgrade k8s to 1.34.2, c-r to 0.22.4 and helm to 3.19.2 by [@​matheuscscp](https://github.com/matheuscscp) in [#​5633](https://github.com/fluxcd/flux2/pull/5633)
- diff: report if object is skipped by [@​hown3d](https://github.com/hown3d) in [#​5625](https://github.com/fluxcd/flux2/pull/5625)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5639](https://github.com/fluxcd/flux2/pull/5639)
- Allow option to skip tenant namespace creation by [@​anshuishere](https://github.com/anshuishere) in [#​5597](https://github.com/fluxcd/flux2/pull/5597)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5648](https://github.com/fluxcd/flux2/pull/5648)
- fix: [#​5654](https://github.com/fluxcd/flux2/issues/5654) by checking if both --chart and --chart-ref are set by [@​jaxels10](https://github.com/jaxels10) in [#​5656](https://github.com/fluxcd/flux2/pull/5656)
- Added retry logic with delays to the Flux CLI download by [@​ivan-munteanu](https://github.com/ivan-munteanu) in [#​5659](https://github.com/fluxcd/flux2/pull/5659)
- Run conformance tests for Kubernetes 1.35.0 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5663](https://github.com/fluxcd/flux2/pull/5663)
- fix: normalize path for Windows compatibility by [@​sibasispadhi](https://github.com/sibasispadhi) in [#​5674](https://github.com/fluxcd/flux2/pull/5674)
- Introduce support for looking up GH app installation ID by [@​matheuscscp](https://github.com/matheuscscp) in [#​5682](https://github.com/fluxcd/flux2/pull/5682)
- Update dependencies to Kubernetes v1.35.0 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5688](https://github.com/fluxcd/flux2/pull/5688)
- Fix resume command logging success after reconciliation failure by [@​Aman-Cool](https://github.com/Aman-Cool) in [#​5690](https://github.com/fluxcd/flux2/pull/5690)
- Add 2.8 to supported versions for `flux migrate -f` by [@​matheuscscp](https://github.com/matheuscscp) in [#​5713](https://github.com/fluxcd/flux2/pull/5713)
- Introduce workflow for bumping fluxcd/pkg deps by [@​matheuscscp](https://github.com/matheuscscp) in [#​5717](https://github.com/fluxcd/flux2/pull/5717)
- Update fluxcd/pkg dependencies by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5719](https://github.com/fluxcd/flux2/pull/5719)
- Fix event listing ignoring pagination token by [@​matheuscscp](https://github.com/matheuscscp) in [#​5721](https://github.com/fluxcd/flux2/pull/5721)
- Build with Go 1.26 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5723](https://github.com/fluxcd/flux2/pull/5723)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5722](https://github.com/fluxcd/flux2/pull/5722)
- Update helm-controller to v1.5.0 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5725](https://github.com/fluxcd/flux2/pull/5725)
- build(deps): bump the ci group across 1 directory with 12 updates by [@​dependabot](https://github.com/dependabot)\[bot] in [#​5720](https://github.com/fluxcd/flux2/pull/5720)
- Fix bootstrap failure on Windows cross-drive paths by [@​veeceey](https://github.com/veeceey) in [#​5726](https://github.com/fluxcd/flux2/pull/5726)
- Dump debug info on e2e tests by [@​matheuscscp](https://github.com/matheuscscp) in [#​5729](https://github.com/fluxcd/flux2/pull/5729)
- Set Kubernetes 1.33 as min supported version by [@​matheuscscp](https://github.com/matheuscscp) in [#​5730](https://github.com/fluxcd/flux2/pull/5730)
- Update conformance tests to min Kubernetes 1.33 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5731](https://github.com/fluxcd/flux2/pull/5731)
#### New Contributors
- [@​ramasai1](https://github.com/ramasai1) made their first contribution in [#​5566](https://github.com/fluxcd/flux2/pull/5566)
- [@​akshatsinha0](https://github.com/akshatsinha0) made their first contribution in [#​5589](https://github.com/fluxcd/flux2/pull/5589)
- [@​jaxels10](https://github.com/jaxels10) made their first contribution in [#​5602](https://github.com/fluxcd/flux2/pull/5602)
- [@​hown3d](https://github.com/hown3d) made their first contribution in [#​5625](https://github.com/fluxcd/flux2/pull/5625)
- [@​anshuishere](https://github.com/anshuishere) made their first contribution in [#​5597](https://github.com/fluxcd/flux2/pull/5597)
- [@​ivan-munteanu](https://github.com/ivan-munteanu) made their first contribution in [#​5659](https://github.com/fluxcd/flux2/pull/5659)
- [@​sibasispadhi](https://github.com/sibasispadhi) made their first contribution in [#​5674](https://github.com/fluxcd/flux2/pull/5674)
- [@​Aman-Cool](https://github.com/Aman-Cool) made their first contribution in [#​5690](https://github.com/fluxcd/flux2/pull/5690)
- [@​veeceey](https://github.com/veeceey) made their first contribution in [#​5726](https://github.com/fluxcd/flux2/pull/5726)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.7.0...v2.8.0>
### [`v2.7.5`](https://github.com/fluxcd/flux2/releases/tag/v2.7.5)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.7.4...v2.7.5)
#### Highlights
Flux v2.7.5 is a patch release that comes with fixes to helm-controller. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Fix HelmRelease history truncation when using the `RetryOnFailure` strategy.
:warning: Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3.
Flux users are advised to use [Cosign v2.6](https://fluxcd.io/flux/flux-gh-action/#push-and-sign-kubernetes-manifests-to-container-registries) for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.
#### Components changelog
- helm-controller [v1.4.5](https://github.com/fluxcd/helm-controller/blob/v1.4.5/CHANGELOG.md)
#### CLI changelog
- \[release/v2.7.x] Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5649](https://github.com/fluxcd/flux2/pull/5649)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.7.4...v2.7.5>
### [`v2.7.4`](https://github.com/fluxcd/flux2/releases/tag/v2.7.4)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.7.3...v2.7.4)
#### Highlights
Flux v2.7.4 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Add `DisableConfigWatchers` feature gate to all controllers for disabling the Secrets/ConfigMaps watchers
- Fix Workload Identity for Azure China Cloud in all controllers
- Update Helm Go SDK to v3.19.2 fixing schema validation issues in helm-controller
- Skip secret decryption for remote kustomize patches in kustomize-controller
- Improve post-build error reporting in kustomize-controller
- Add `ArtifactGenerator` to aggregated RBAC roles
:warning: Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3.
Flux users are advised to use [Cosign v2.6](https://fluxcd.io/flux/flux-gh-action/#push-and-sign-kubernetes-manifests-to-container-registries) for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.
#### Components changelog
- source-controller [v1.7.4](https://github.com/fluxcd/source-controller/blob/v1.7.4/CHANGELOG.md)
- kustomize-controller [v1.7.3](https://github.com/fluxcd/kustomize-controller/blob/v1.7.3/CHANGELOG.md)
- notification-controller [v1.7.5](https://github.com/fluxcd/notification-controller/blob/v1.7.5/CHANGELOG.md)
- helm-controller [v1.4.4](https://github.com/fluxcd/helm-controller/blob/v1.4.4/CHANGELOG.md)
- image-reflector-controller [v1.0.4](https://github.com/fluxcd/image-reflector-controller/blob/v1.0.4/CHANGELOG.md)
- image-automation-controller [v1.0.4](https://github.com/fluxcd/image-automation-controller/blob/v1.0.4/CHANGELOG.md)
- source-watcher [v2.0.3](https://github.com/fluxcd/source-watcher/blob/v2.0.3/CHANGELOG.md)
#### CLI changelog
- \[release/v2.7.x] ci: Include source-watcher in the e2e test suite by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5615](https://github.com/fluxcd/flux2/pull/5615)
- \[release/v2.7.x] Add source.extensions.fluxcd.io group to aggregated RBAC roles by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5628](https://github.com/fluxcd/flux2/pull/5628)
- \[release/v2.7.x] Fix panic on reconcile with source of ExternalArtifact kind by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5631](https://github.com/fluxcd/flux2/pull/5631)
- \[release/v2.7.x] Upgrade k8s to 1.34.2, c-r to 0.22.4 and helm to 3.19.2 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5634](https://github.com/fluxcd/flux2/pull/5634)
- \[release/v2.7.x] diff: report if object is skipped by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5635](https://github.com/fluxcd/flux2/pull/5635)
- \[release/v2.7.x] Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5640](https://github.com/fluxcd/flux2/pull/5640)
- \[release/v2.7.x] Allow option to skip tenant namespace creation by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5642](https://github.com/fluxcd/flux2/pull/5642)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.7.3...v2.7.4>
### [`v2.7.3`](https://github.com/fluxcd/flux2/releases/tag/v2.7.3)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.7.2...v2.7.3)
#### Highlights
Flux v2.7.3 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
- Restore SOCKS5 proxy support in all controllers
- Fix status reporting of HelmReleases with `RetryOnFailure` strategy
- Automated retries for ImagePolicies when no image tags are found in the database
- Fix alerting for Telegram's `message_thread_id`
- Allow running kustomize-controller and helm-controller on the same loopback interface as source-watcher
:warning: Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3. Users are advised to use [Cosign v2.6](https://fluxcd.io/flux/flux-gh-action/#push-and-sign-kubernetes-manifests-to-container-registries) for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.
#### Components changelog
- source-controller [v1.7.3](https://github.com/fluxcd/source-controller/blob/v1.7.3/CHANGELOG.md)
- kustomize-controller [v1.7.2](https://github.com/fluxcd/kustomize-controller/blob/v1.7.2/CHANGELOG.md)
- notification-controller [v1.7.4](https://github.com/fluxcd/notification-controller/blob/v1.7.4/CHANGELOG.md)
- helm-controller [v1.4.3](https://github.com/fluxcd/helm-controller/blob/v1.4.3/CHANGELOG.md)
- image-reflector-controller [v1.0.3](https://github.com/fluxcd/image-reflector-controller/blob/v1.0.3/CHANGELOG.md)
- image-automation-controller [v1.0.3](https://github.com/fluxcd/image-automation-controller/blob/v1.0.3/CHANGELOG.md)
#### CLI changelog
- \[release/v2.7.x] Pin cosign to v2.6.1 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5595](https://github.com/fluxcd/flux2/pull/5595)
- \[release/v2.7.x] Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5605](https://github.com/fluxcd/flux2/pull/5605)
- \[release/v2.7.x] fix: return accepted values for flags when calling Values.Type() by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5606](https://github.com/fluxcd/flux2/pull/5606)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.7.2...v2.7.3>
### [`v2.7.2`](https://github.com/fluxcd/flux2/releases/tag/v2.7.2)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.7.1...v2.7.2)
#### Highlights
Flux v2.7.2 is a patch release that comes with security fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
All Flux components are now built with Go 1.25.2 which includes fixes for vulnerabilities in the Go stdlib that could lead to denial of service. The list of security fixes can be found in the [Go 1.25.2 release notes](https://groups.google.com/g/golang-announce/c/4Emdl2iQ_bI/m/qZN5nc-mBgAJ).
#### Components changelog
- source-controller [v1.7.2](https://github.com/fluxcd/source-controller/blob/v1.7.2/CHANGELOG.md)
- kustomize-controller [v1.7.1](https://github.com/fluxcd/kustomize-controller/blob/v1.7.1/CHANGELOG.md)
- notification-controller [v1.7.3](https://github.com/fluxcd/notification-controller/blob/v1.7.3/CHANGELOG.md)
- helm-controller [v1.4.2](https://github.com/fluxcd/helm-controller/blob/v1.4.2/CHANGELOG.md)
- image-reflector-controller [v1.0.2](https://github.com/fluxcd/image-reflector-controller/blob/v1.0.2/CHANGELOG.md)
- image-automation-controller [v1.0.2](https://github.com/fluxcd/image-automation-controller/blob/v1.0.2/CHANGELOG.md)
- source-watcher [v2.0.2](https://github.com/fluxcd/source-watcher/blob/v2.0.2/CHANGELOG.md)
#### CLI changelog
- \[release/v2.7.x] Fix manifest generation for `--storage-adv-addr` and `--events-addr` flags by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5575](https://github.com/fluxcd/flux2/pull/5575)
- \[release/v2.7.x] Update dependencies to Kubernetes v1.34.1 and Go 1.25.2 by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5577](https://github.com/fluxcd/flux2/pull/5577)
- \[release/v2.7.x] Update toolkit components by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5579](https://github.com/fluxcd/flux2/pull/5579)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.7.1...v2.7.2>
### [`v2.7.1`](https://github.com/fluxcd/flux2/releases/tag/v2.7.1)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.7.0...v2.7.1)
#### Highlights
Flux v2.7.1 is a patch release that comes with various improvements and fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.
Improvements:
- Extend [flux migrate](https://fluxcd.io/flux/cmd/flux_migrate/) with support for migrating manifests in Git repositories to the latest API versions.
- Add [recommendations](https://fluxcd.io/flux/components/helm/helmreleases/#recommended-settings) for configuring HelmReleases on production environments.
Fixes:
- Fix `flux migrate` command to handle managed fields properly.
- Fix self-signed TLS cert handling for public Helm repositories in source-controller.
- Fix the default API versions used by receivers in notification-controller.
- Fix redundant `Ready` condition patching in helm-controller.
- Fix workload identity configuration examples for kubeconfig in helm-controller and kustomize-controller.
#### Components changelog
- source-controller [v1.7.1](https://github.com/fluxcd/source-controller/blob/v1.7.1/CHANGELOG.md)
- notification-controller [v1.7.2](https://github.com/fluxcd/notification-controller/blob/v1.7.2/CHANGELOG.md)
- helm-controller [v1.4.1](https://github.com/fluxcd/helm-controller/blob/v1.4.1/CHANGELOG.md)
#### CLI changelog
- \[release/v2.7.x] Backport CI fixes and updates by [@​matheuscscp](https://github.com/matheuscscp) in [#​5552](https://github.com/fluxcd/flux2/pull/5552)
- \[release/v2.7.x] Fix `flux push artifact` not working with `--provider` by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5553](https://github.com/fluxcd/flux2/pull/5553)
- \[release/v2.7.x] Extend `flux migrate` to work with local files by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5557](https://github.com/fluxcd/flux2/pull/5557)
- \[release/v2.7.x] Improve `flux migrate` for live cluster migrations by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5559](https://github.com/fluxcd/flux2/pull/5559)
- \[release/v2.7.x] Fix `flux migrate -f` command to work with comments by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5561](https://github.com/fluxcd/flux2/pull/5561)
- \[release/v2.7.x] Fix `flux migrate -f` not considering kind comments by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5564](https://github.com/fluxcd/flux2/pull/5564)
- \[release/v2.7.x] Update toolkit components by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5569](https://github.com/fluxcd/flux2/pull/5569)
- \[release/v2.7.x] Disable AUR publishing by [@​github-actions](https://github.com/github-actions)\[bot] in [#​5571](https://github.com/fluxcd/flux2/pull/5571)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.7.0...v2.7.1>
### [`v2.7.0`](https://github.com/fluxcd/flux2/releases/tag/v2.7.0)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.6.4...v2.7.0)
#### Highlights
Flux v2.7.0 is a feature release. Users are encouraged to upgrade for the best experience.
For a compressive overview of new features and API changes included in this release, please refer to the [Announcing Flux 2.7 GA blog post](https://fluxcd.io/blog/2025/09/flux-v2.7.0/).
Overview of the new features:
- General availability release of the Image Automation APIs (`ImagePolicy`, `ImageRepository`, `ImageUpdateAutomation`)
- Watch for changes in ConfigMaps and Secrets references (`Kustomization`, `HelmRelease`)
- Support for remote cluster authentication using Workload Identity (`Kustomization`, `HelmRelease`)
- Extend the readiness evaluation of dependencies with CEL expressions (`Kustomization`, `HelmRelease`)
- Support for global SOPS Age decryption keys on single-tenant clusters (`Kustomization`)
- Support for optional Kustomize components (`Kustomization`)
- Introduce `RetryOnFailure` lifecycle management strategy (`HelmRelease`)
- Support mTLS for sending alerts to external systems (`Provider`)
- Object-level workload identity authentication (`Bucket`, `Provider`)
- Support mTLS for GitHub App transport (`GitRepository`, `ImageUpdateAutomation`, `Provider`)
- OpenTelemetry tracing for `Kustomization` and `HelmRelease` reconciliation (`Provider`)
- Support for 3rd-party source controllers (`ExternalArtifact`)
- Support for source composition and decomposition patterns (`ArtifactGenerator`)
- `CancelHealthCheckOnNewRevision` feature gate (kustomize-controller)
- `GitSparseCheckout` feature gate (image-automation-controller)
❤️ Big thanks to all the Flux contributors that helped us with this release!
##### Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
| Kubernetes version | Minimum required |
| ------------------ | ---------------- |
| `v1.32` | `>= 1.32.0` |
| `v1.33` | `>= 1.33.0` |
| `v1.34` | `>= 1.34.1` |
> \[!NOTE]
> Note that the Flux project offers support only for the latest three minor versions of Kubernetes.
> Backwards compatibility with older versions of Kubernetes and OpenShift is offered by vendors such as
> [ControlPlane](https://control-plane.io/enterprise-for-flux-cd/) that provide enterprise support for Flux.
##### OpenShift compatibility
Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub using [Flux Operator](https://operatorhub.io/operator/flux-operator). The operator allows the configuration of Flux multi-tenancy lockdown, network policies, persistent storage, sharding, vertical scaling and the synchronization of the cluster state from Git repositories, OCI artifacts, and S3-compatible storage.
#### Upgrade procedure
:warning: The Flux APIs `v1beta1` and `v2beta1` (deprecated in 2023) have reached end-of-life and have been removed from the CRDs.
Unless you are using [Flux Operator](https://github.com/controlplaneio-fluxcd/flux-operator) to deploy the Flux controllers, you must run the `flux migrate` command on clusters before upgrading.
For more details, please refer to the [Flux v2.7 upgrade guide](https://fluxcd.io/blog/2025/09/flux-v2.7.0/#upgrade-procedure).
#### Components changelog
- source-controller [v1.7.0](https://github.com/fluxcd/source-controller/blob/v1.7.0/CHANGELOG.md)
- kustomize-controller [v1.7.0](https://github.com/fluxcd/kustomize-controller/blob/v1.7.0/CHANGELOG.md)
- notification-controller [v1.7.0](https://github.com/fluxcd/notification-controller/blob/v1.7.0/CHANGELOG.md) [v1.7.1](https://github.com/fluxcd/notification-controller/blob/v1.7.1/CHANGELOG.md)
- helm-controller [v1.4.0](https://github.com/fluxcd/helm-controller/blob/v1.4.0/CHANGELOG.md)
- image-reflector-controller [v1.0.0](https://github.com/fluxcd/image-reflector-controller/blob/v1.0.0/CHANGELOG.md) [v1.0.1](https://github.com/fluxcd/image-reflector-controller/blob/v1.0.1/CHANGELOG.md)
- image-automation-controller [v1.0.0](https://github.com/fluxcd/image-automation-controller/blob/v1.0.0/CHANGELOG.md) [v1.0.1](https://github.com/fluxcd/image-automation-controller/blob/v1.0.1/CHANGELOG.md)
- source-watcher [v2.0.0](https://github.com/fluxcd/source-watcher/blob/v2.0.0/CHANGELOG.md) [v2.0.1](https://github.com/fluxcd/source-watcher/blob/v1.0.1/CHANGELOG.md)
##### New Documentation
- [ImageRepository v1 specification](https://fluxcd.io/flux/components/image/imagerepositories)
- [ImagePolicy v1 specification](https://fluxcd.io/flux/components/image/imagepolicies)
- [ImageUpdateAutomation v1 specification](https://fluxcd.io/flux/components/image/imageupdateautomations)
- [ExternalArtifact v1 specification](https://fluxcd.io/flux/components/source/externalartifacts)
- [ArtifactGenerator v1beta1 specification](https://fluxcd.io/flux/components/source/artifactgenerators)
#### CLI changelog
- Add backport label for `v2.6.x` by [@​stefanprodan](https://github.com/stefanprodan) in [#​5379](https://github.com/fluxcd/flux2/pull/5379)
- Update image-reflector-controller to v0.35.1 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5381](https://github.com/fluxcd/flux2/pull/5381)
- Add digest pinning to image automation testing by [@​stefanprodan](https://github.com/stefanprodan) in [#​5383](https://github.com/fluxcd/flux2/pull/5383)
- correct small typo by [@​JIbald](https://github.com/JIbald) in [#​5388](https://github.com/fluxcd/flux2/pull/5388)
- Remove credentials sync manifests by [@​matheuscscp](https://github.com/matheuscscp) in [#​5347](https://github.com/fluxcd/flux2/pull/5347)
- Add sparse checkout to cli by [@​ba-work](https://github.com/ba-work) in [#​5389](https://github.com/fluxcd/flux2/pull/5389)
- fix: Allow Azure CLI calls in `flux push artifact --provider azure` on DevOps runners by [@​matheuscscp](https://github.com/matheuscscp) in [#​5390](https://github.com/fluxcd/flux2/pull/5390)
- Fix `knownhosts key mismatch` regression bug by [@​matheuscscp](https://github.com/matheuscscp) in [#​5404](https://github.com/fluxcd/flux2/pull/5404)
- refactor: Use `normalize.UnstructuredList` instead of `ssa.SetNativeKindsDefaults` by [@​cappyzawa](https://github.com/cappyzawa) in [#​5407](https://github.com/fluxcd/flux2/pull/5407)
- Make service-account name configurable in `flux create tenant` by [@​reiSh6phoo9o](https://github.com/reiSh6phoo9o) in [#​5402](https://github.com/fluxcd/flux2/pull/5402)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5409](https://github.com/fluxcd/flux2/pull/5409)
- refactor: cleanup GetArtifactRegistryCredentials error handling by [@​cappyzawa](https://github.com/cappyzawa) in [#​5418](https://github.com/fluxcd/flux2/pull/5418)
- Promote image CLI commands to stable by [@​dgunzy](https://github.com/dgunzy) in [#​5421](https://github.com/fluxcd/flux2/pull/5421)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5426](https://github.com/fluxcd/flux2/pull/5426)
- Bump pkg/ssa to v0.49.0 for CABundle validation fix by [@​dgunzy](https://github.com/dgunzy) in [#​5431](https://github.com/fluxcd/flux2/pull/5431)
- \[RFC-0010] Add workload identity support for remote clusters by [@​matheuscscp](https://github.com/matheuscscp) in [#​5434](https://github.com/fluxcd/flux2/pull/5434)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5443](https://github.com/fluxcd/flux2/pull/5443)
- Fix `flux push artifact` for insecure registries by [@​stefanprodan](https://github.com/stefanprodan) in [#​5449](https://github.com/fluxcd/flux2/pull/5449)
- \[RFC-0010] Add workload identity support for remote generic clusters by [@​matheuscscp](https://github.com/matheuscscp) in [#​5452](https://github.com/fluxcd/flux2/pull/5452)
- Fix `flux diff kustomization` ignore patterns by [@​dgunzy](https://github.com/dgunzy) in [#​5451](https://github.com/fluxcd/flux2/pull/5451)
- Update dependencies to Kubernetes 1.33.2 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5453](https://github.com/fluxcd/flux2/pull/5453)
- build(deps): bump the ci group across 1 directory with 7 updates by [@​dependabot](https://github.com/dependabot)\[bot] in [#​5435](https://github.com/fluxcd/flux2/pull/5435)
- Upgrade fluxcd/pkg dependencies by [@​matheuscscp](https://github.com/matheuscscp) in [#​5455](https://github.com/fluxcd/flux2/pull/5455)
- ci: Use GITHUB\_TOKEN for API calls in update workflow by [@​stefanprodan](https://github.com/stefanprodan) in [#​5460](https://github.com/fluxcd/flux2/pull/5460)
- manifests: Add `app.kubernetes.io/part-of: flux` label to controller pods by [@​pinkavaj](https://github.com/pinkavaj) in [#​5440](https://github.com/fluxcd/flux2/pull/5440)
- Migrate sourcesecret package to runtime/secrets APIs by [@​cappyzawa](https://github.com/cappyzawa) in [#​5462](https://github.com/fluxcd/flux2/pull/5462)
- Implement `flux migrate` command by [@​stefanprodan](https://github.com/stefanprodan) in [#​5473](https://github.com/fluxcd/flux2/pull/5473)
- \[RFC-0007] Implementation history update by [@​stefanprodan](https://github.com/stefanprodan) in [#​5480](https://github.com/fluxcd/flux2/pull/5480)
- Run conformance tests for Kubernetes 1.34.0 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5497](https://github.com/fluxcd/flux2/pull/5497)
- Update to Kubernetes v1.34.0 and Go 1.25.0 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5499](https://github.com/fluxcd/flux2/pull/5499)
- build(deps): bump the ci group across 1 directory with 10 updates by [@​dependabot](https://github.com/dependabot)\[bot] in [#​5500](https://github.com/fluxcd/flux2/pull/5500)
- Allow the Go runtime to dynamically set `GOMAXPROCS` by [@​stefanprodan](https://github.com/stefanprodan) in [#​5501](https://github.com/fluxcd/flux2/pull/5501)
- fix(events): respect `--all-namespaces` flag by [@​mohiuddin-khan-shiam](https://github.com/mohiuddin-khan-shiam) in [#​5414](https://github.com/fluxcd/flux2/pull/5414)
- \[RFC-0011] OpenTelemetry Tracing by [@​adri1197](https://github.com/adri1197) in [#​5321](https://github.com/fluxcd/flux2/pull/5321)
- \[RFC-0012] External Artifact API by [@​stefanprodan](https://github.com/stefanprodan) in [#​5292](https://github.com/fluxcd/flux2/pull/5292)
- Add `--show-history` flag to `debug helmrelease` by [@​hawkaii](https://github.com/hawkaii) in [#​5505](https://github.com/fluxcd/flux2/pull/5505)
- Skip release candidates on updates by [@​matheuscscp](https://github.com/matheuscscp) in [#​5507](https://github.com/fluxcd/flux2/pull/5507)
- ci: Align azure e2e tests secret names with fluxcd/pkg by [@​matheuscscp](https://github.com/matheuscscp) in [#​5508](https://github.com/fluxcd/flux2/pull/5508)
- Update image-reflector-controller to v1.0.0 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5517](https://github.com/fluxcd/flux2/pull/5517)
- Update source-controller to v1.7.0 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5518](https://github.com/fluxcd/flux2/pull/5518)
- Add the source-watcher controller to the Flux distribution by [@​stefanprodan](https://github.com/stefanprodan) in [#​5519](https://github.com/fluxcd/flux2/pull/5519)
- Add read-only commands for `ArtifactGenerator` kind by [@​stefanprodan](https://github.com/stefanprodan) in [#​5520](https://github.com/fluxcd/flux2/pull/5520)
- ci: Add source-watcher to the update workflow by [@​stefanprodan](https://github.com/stefanprodan) in [#​5521](https://github.com/fluxcd/flux2/pull/5521)
- Update image-automation-controller to v1.0.0 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5522](https://github.com/fluxcd/flux2/pull/5522)
- Update image-reflector-controller to v1.0.1 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5525](https://github.com/fluxcd/flux2/pull/5525)
- Implement `flux [reconcile|suspend|resume] image policy` commands by [@​lukas8219](https://github.com/lukas8219) in [#​5492](https://github.com/fluxcd/flux2/pull/5492)
- Handle `force: enabled` annotation in `flux diff ks` command by [@​stefanprodan](https://github.com/stefanprodan) in [#​5528](https://github.com/fluxcd/flux2/pull/5528)
- ci: Refactor CI with `fluxcd/gha-workflows` by [@​stefanprodan](https://github.com/stefanprodan) in [#​5529](https://github.com/fluxcd/flux2/pull/5529)
- Remove `ArtifactGenerators` during uninstall by [@​stefanprodan](https://github.com/stefanprodan) in [#​5531](https://github.com/fluxcd/flux2/pull/5531)
- Add support for `ExternalArtifact` to `flux trace` by [@​stefanprodan](https://github.com/stefanprodan) in [#​5532](https://github.com/fluxcd/flux2/pull/5532)
- Set Kubernetes 1.32 as min supported version by [@​stefanprodan](https://github.com/stefanprodan) in [#​5533](https://github.com/fluxcd/flux2/pull/5533)
- build(deps): bump the ci group with 6 updates by [@​dependabot](https://github.com/dependabot)\[bot] in [#​5535](https://github.com/fluxcd/flux2/pull/5535)
- Add support for custom storage namespace in HelmRelease creation by [@​prasad89](https://github.com/prasad89) in [#​5534](https://github.com/fluxcd/flux2/pull/5534)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5537](https://github.com/fluxcd/flux2/pull/5537)
- ci: remove cron schedule from update by [@​matheuscscp](https://github.com/matheuscscp) in [#​5539](https://github.com/fluxcd/flux2/pull/5539)
- Update source-watcher to v2.0.1 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5540](https://github.com/fluxcd/flux2/pull/5540)
- Add `--show-history` flag to `debug kustomization` by [@​matheuscscp](https://github.com/matheuscscp) in [#​5541](https://github.com/fluxcd/flux2/pull/5541)
- Update image-automation-controller to v1.0.1 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5542](https://github.com/fluxcd/flux2/pull/5542)
- `fluxcd/flux2/action`: Determine latest version without using GitHub API by [@​RussellAult](https://github.com/RussellAult) in [#​5509](https://github.com/fluxcd/flux2/pull/5509)
#### New Contributors
- [@​JIbald](https://github.com/JIbald) made their first contribution in [#​5388](https://github.com/fluxcd/flux2/pull/5388)
- [@​ba-work](https://github.com/ba-work) made their first contribution in [#​5389](https://github.com/fluxcd/flux2/pull/5389)
- [@​cappyzawa](https://github.com/cappyzawa) made their first contribution in [#​5407](https://github.com/fluxcd/flux2/pull/5407)
- [@​reiSh6phoo9o](https://github.com/reiSh6phoo9o) made their first contribution in [#​5402](https://github.com/fluxcd/flux2/pull/5402)
- [@​pinkavaj](https://github.com/pinkavaj) made their first contribution in [#​5440](https://github.com/fluxcd/flux2/pull/5440)
- [@​mohiuddin-khan-shiam](https://github.com/mohiuddin-khan-shiam) made their first contribution in [#​5414](https://github.com/fluxcd/flux2/pull/5414)
- [@​adri1197](https://github.com/adri1197) made their first contribution in [#​5321](https://github.com/fluxcd/flux2/pull/5321)
- [@​hawkaii](https://github.com/hawkaii) made their first contribution in [#​5505](https://github.com/fluxcd/flux2/pull/5505)
- [@​lukas8219](https://github.com/lukas8219) made their first contribution in [#​5492](https://github.com/fluxcd/flux2/pull/5492)
- [@​prasad89](https://github.com/prasad89) made their first contribution in [#​5534](https://github.com/fluxcd/flux2/pull/5534)
- [@​RussellAult](https://github.com/RussellAult) made their first contribution in [#​5509](https://github.com/fluxcd/flux2/pull/5509)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.6.0...v2.7.0>
### [`v2.6.4`](https://github.com/fluxcd/flux2/releases/tag/v2.6.4)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.6.3...v2.6.4)
#### Highlights
Flux v2.6.4 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
- Fix for SOPS decryption with US Government KMS keys failing with the error:
```
STS: AssumeRoleWithWebIdentity, https response error\n StatusCode: 0, RequestID: ,
request send failed, Post\n \"https://sts.arn.amazonaws.com/\": dial tcp:
lookupts.arn.amazonaws.com on 10.100.0.10:53: no such host
```
#### Components changelog
- kustomize-controller [v1.6.1](https://github.com/fluxcd/kustomize-controller/blob/v1.6.1/CHANGELOG.md)
#### CLI changed
- \[release/v2.6.x] Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5444](https://github.com/fluxcd/flux2/pull/5444)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.6.3...v2.6.4>
### [`v2.6.3`](https://github.com/fluxcd/flux2/releases/tag/v2.6.3)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.6.2...v2.6.3)
#### Highlights
Flux v2.6.3 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
- Fix for `rsa-sha2-512` and `rsa-sha2-256` algorithms not being prioritized for `ssh-rsa` host keys in source-controller, image-automation-controller and Flux CLI bootstrap.
#### Components changelog
- source-controller [v1.6.2](https://github.com/fluxcd/source-controller/blob/v1.6.2/CHANGELOG.md)
- image-automation-controller [v0.41.2](https://github.com/fluxcd/image-automation-controller/blob/v0.41.2/CHANGELOG.md)
#### CLI changed
- \[release/v2.6.x] Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5427](https://github.com/fluxcd/flux2/pull/5427)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.6.2...v2.6.3>
### [`v2.6.2`](https://github.com/fluxcd/flux2/releases/tag/v2.6.2)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.6.1...v2.6.2)
#### Highlights
Flux v2.6.2 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
- Fix authentication for `flux push artifact --provider=azure` on Azure DevOps runners.
- Fix OIDC authentication for [Amazon ECR Public](https://fluxcd.io/flux/integrations/aws/#for-amazon-public-elastic-container-registry) in source-controller and image-reflector-controller.
- Fix `knownhosts key mismatch` regression bug in the Flux CLI, source-controller and image-automation-controller.
#### Components changelog
- source-controller [v1.6.1](https://github.com/fluxcd/source-controller/blob/v1.6.1/CHANGELOG.md)
- image-reflector-controller [v0.35.2](https://github.com/fluxcd/image-reflector-controller/blob/v0.35.2/CHANGELOG.md)
- image-automation-controller [v0.41.1](https://github.com/fluxcd/image-automation-controller/blob/v0.41.1/CHANGELOG.md)
#### CLI changelog
- \[release/v2.6.x] fix: Allow Azure CLI calls in `flux push artifact --provider azure` on DevOps runners by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5396](https://github.com/fluxcd/flux2/pull/5396)
- \[release/v2.6.x] Fix `knownhosts key mismatch` regression bug by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5405](https://github.com/fluxcd/flux2/pull/5405)
- \[release/v2.6.x] Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5410](https://github.com/fluxcd/flux2/pull/5410)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.6.1...v2.6.2>
### [`v2.6.1`](https://github.com/fluxcd/flux2/releases/tag/v2.6.1)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.6.0...v2.6.1)
#### Highlights
Flux v2.6.1 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
- Fix a bug introduced in image-reflector-controller v0.35.0 that was causing spurious error events for policies during image repository reconciliation.
- Fix excessive logging in image-reflector-controller after a restart when the image tags cache is empty.
#### Components changelog
- image-reflector-controller [v0.35.1](https://github.com/fluxcd/image-reflector-controller/blob/v0.35.1/CHANGELOG.md)
#### CLI changelog
- \[release/v2.6.x] Update image-reflector-controller to v0.35.1 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5382](https://github.com/fluxcd/flux2/pull/5382)
- \[release/v2.6.x] Add digest pinning to image automation testing by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5384](https://github.com/fluxcd/flux2/pull/5384)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.6.0...v2.6.1>
### [`v2.6.0`](https://github.com/fluxcd/flux2/releases/tag/v2.6.0)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.5.1...v2.6.0)
#### Highlights
Flux v2.6.0 is a feature release. Users are encouraged to upgrade for the best experience.
For a compressive overview of new features and API changes included in this release, please refer to the [Announcing Flux 2.6 GA blog post](https://fluxcd.io/blog/2025/05/flux-v2.6.0/).
Overview of the new features:
- General availability release for the Flux OCI Artifacts APIs and `flux artifact` commands
- Support for OCI digests pinning (ImagePolicy, ImageUpdateAutomation)
- Object-level workload identity authentication (OCIRepository, ImageRepository, Kustomization, Alert Provider)
- Cache registry credentials for cloud providers (OCIRepository, ImageRepository)
- Git HTTP/S Mutual TLS authentication (GitRepository, ImageUpdateAutomation)
- Support for sparse checkout (GitRepository)
- Support for GitHub App authentication (Alert Provider)
- Support for managed Identity authentication to Azure Event Hub (Alert Provider)
- Customize the ID of the Git commit status with CEL expressions (Alert Provider)
- `WaitForTermination` deletion policy (Kustomization)
- `DisableChartDigestTracking` feature gate (HelmRelease)
❤️ Big thanks to all the Flux contributors that helped us with this release!
##### Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
| Kubernetes version | Minimum required |
| ------------------ | ---------------- |
| `v1.31` | `>= 1.31.0` |
| `v1.32` | `>= 1.32.0` |
| `v1.33` | `>= 1.33.0` |
> \[!NOTE]
> Note that the Flux project offers support only for the latest three minor versions of Kubernetes.
> Backwards compatibility with older versions of Kubernetes and OpenShift is offered by vendors such as
> [ControlPlane](https://control-plane.io/enterprise-for-flux-cd/) that provide enterprise support for Flux.
##### OpenShift compatibility
Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub using [Flux Operator](https://operatorhub.io/operator/flux-operator).
The operator allows the configuration of Flux multi-tenancy lockdown, network policies, persistent storage, sharding, vertical scaling and the synchronization of the cluster state from Git repositories, OCI artifacts, and S3-compatible storage.
#### Upgrade procedure
Upgrade Flux from `v2.5.0` to `v2.6.0` by following the [upgrade guide](https://fluxcd.io/flux/installation/upgrade/).
To upgrade the APIs, make sure the new CRDs and controllers are deployed, and then change the manifests in Git:
1. Set `apiVersion: source.toolkit.fluxcd.io/v1` in the YAML files that contain `OCIRepository` definitions.
2. Add an annotation `api.fluxcd.io/upgrade: "v2.6.0"` to the `OCIRepository` resources. (this is not required if Flux Operator is used for upgrade)
3. Commit, push, and reconcile the API version changes.
Bumping the APIs version in manifests can be done gradually.
It is advised to not delay this procedure as the deprecated versions will be removed after 6 months.
#### Components changelog
- source-controller [v1.6.0](https://github.com/fluxcd/source-controller/blob/v1.6.0/CHANGELOG.md)
- kustomize-controller [v1.6.0](https://github.com/fluxcd/kustomize-controller/blob/v1.6.0/CHANGELOG.md)
- notification-controller [v1.6.0](https://github.com/fluxcd/notification-controller/blob/v1.6.0/CHANGELOG.md)
- helm-controller [v1.3.0](https://github.com/fluxcd/helm-controller/blob/v1.3.0/CHANGELOG.md)
- image-reflector-controller [v0.35.0](https://github.com/fluxcd/image-reflector-controller/blob/v0.35.0/CHANGELOG.md)
- image-automation-controller [v0.41.0](https://github.com/fluxcd/image-automation-controller/blob/v0.41.0/CHANGELOG.md)
##### New Documentation
- [OCIRepository v1 specification](https://fluxcd.io/flux/components/source/ocirepositories/)
- [AWS integrations](https://fluxcd.io/flux/integrations/aws/)
- [Azure integrations](https://fluxcd.io/flux/integrations/azure/)
- [GCP integrations](https://fluxcd.io/flux/integrations/gcp/)
#### What's Changed
- fix: correct name on github app secret by [@​NotAwar](https://github.com/NotAwar) in [#​5202](https://github.com/fluxcd/flux2/pull/5202)
- Update RFC 0008 and RFC 0009 milestones by [@​matheuscscp](https://github.com/matheuscscp) in [#​5141](https://github.com/fluxcd/flux2/pull/5141)
- Update kustomize-controller to v1.5.1 by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5214](https://github.com/fluxcd/flux2/pull/5214)
- Update backport labels for 2.5 by [@​matheuscscp](https://github.com/matheuscscp) in [#​5215](https://github.com/fluxcd/flux2/pull/5215)
- Fix command debug hr not taking targetPath into account by [@​matheuscscp](https://github.com/matheuscscp) in [#​5227](https://github.com/fluxcd/flux2/pull/5227)
- Remove redundant space. by [@​laiminhtrung1997](https://github.com/laiminhtrung1997) in [#​5038](https://github.com/fluxcd/flux2/pull/5038)
- ci: switch to goreleaser changelog generation by [@​y-eight](https://github.com/y-eight) in [#​5284](https://github.com/fluxcd/flux2/pull/5284)
- change: use the default ephemeral GITHUB\_TOKEN instead of the static one by [@​piontec](https://github.com/piontec) in [#​5282](https://github.com/fluxcd/flux2/pull/5282)
- add: OSSF scorecard configuration file - ignore false-positive by [@​piontec](https://github.com/piontec) in [#​5287](https://github.com/fluxcd/flux2/pull/5287)
- build(deps): bump helm.sh/helm/v3 from 3.17.0 to 3.17.3 by [@​dependabot](https://github.com/dependabot) in [#​5295](https://github.com/fluxcd/flux2/pull/5295)
- Allow to pull/push artifacts to insecure registries without TLS by [@​mottetm](https://github.com/mottetm) in [#​5299](https://github.com/fluxcd/flux2/pull/5299)
- \[RFC-0010] Multi-Tenant Workload Identity by [@​matheuscscp](https://github.com/matheuscscp) in [#​5209](https://github.com/fluxcd/flux2/pull/5209)
- flux diff: Reset target struct before decoding by [@​maboehm](https://github.com/maboehm) in [#​5302](https://github.com/fluxcd/flux2/pull/5302)
- fix: allow recursive dry-run over local sources by [@​niveau0](https://github.com/niveau0) in [#​5219](https://github.com/fluxcd/flux2/pull/5219)
- Run conformance tests for Kubernetes 1.33.0 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5318](https://github.com/fluxcd/flux2/pull/5318)
- Update to Kubernetes 1.33.0 and Go 1.24.0 by [@​stefanprodan](https://github.com/stefanprodan) in [#​5323](https://github.com/fluxcd/flux2/pull/5323)
- \[RFC-0010] Remove EKS Pod Identity from the proposal by [@​matheuscscp](https://github.com/matheuscscp) in [#​5309](https://github.com/fluxcd/flux2/pull/5309)
- \[RFC-0010] Add RBAC for creating service account tokens by [@​matheuscscp](https://github.com/matheuscscp) in [#​5332](https://github.com/fluxcd/flux2/pull/5332)
- Upgrade fluxcd/pkg auth, oci, git and git/gogit by [@​matheuscscp](https://github.com/matheuscscp) in [#​5333](https://github.com/fluxcd/flux2/pull/5333)
- Fix exit code handling in get command by [@​dgunzy](https://github.com/dgunzy) in [#​5338](https://github.com/fluxcd/flux2/pull/5338)
- build(deps): bump the ci group across 1 directory with 18 updates by [@​dependabot](https://github.com/dependabot) in [#​5325](https://github.com/fluxcd/flux2/pull/5325)
- Fix `flux trace` for HRs from `OCIRepository`s by [@​makkes](https://github.com/makkes) in [#​5349](https://github.com/fluxcd/flux2/pull/5349)
- Fix e2e workflow by [@​makkes](https://github.com/makkes) in [#​5351](https://github.com/fluxcd/flux2/pull/5351)
- \[RFC-0010] Update RFC to include opt-in feature gate by [@​matheuscscp](https://github.com/matheuscscp) in [#​5354](https://github.com/fluxcd/flux2/pull/5354)
- \[RFC-0010] Update RFC feature gate behavior by [@​matheuscscp](https://github.com/matheuscscp) in [#​5355](https://github.com/fluxcd/flux2/pull/5355)
- Upgrade fluxcd/pkg packages by [@​matheuscscp](https://github.com/matheuscscp) in [#​5356](https://github.com/fluxcd/flux2/pull/5356)
- Upgrade fluxcd/pkg packages by [@​matheuscscp](https://github.com/matheuscscp) in [#​5357](https://github.com/fluxcd/flux2/pull/5357)
- Set Kubernetes 1.31 as min supported version by [@​stefanprodan](https://github.com/stefanprodan) in [#​5364](https://github.com/fluxcd/flux2/pull/5364)
- Update dependencies by [@​matheuscscp](https://github.com/matheuscscp) in [#​5366](https://github.com/fluxcd/flux2/pull/5366)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5368](https://github.com/fluxcd/flux2/pull/5368)
- Promote artifact commands to stable by [@​matheuscscp](https://github.com/matheuscscp) in [#​5369](https://github.com/fluxcd/flux2/pull/5369)
- Add --interval and --reflect-digest flags to flux create image policy by [@​matheuscscp](https://github.com/matheuscscp) in [#​5345](https://github.com/fluxcd/flux2/pull/5345)
- Update CLI to OCIRepository v1 (GA) by [@​stefanprodan](https://github.com/stefanprodan) in [#​5371](https://github.com/fluxcd/flux2/pull/5371)
- Update dependabot config by [@​stefanprodan](https://github.com/stefanprodan) in [#​5373](https://github.com/fluxcd/flux2/pull/5373)
- Update toolkit components by [@​fluxcdbot](https://github.com/fluxcdbot) in [#​5370](https://github.com/fluxcd/flux2/pull/5370)
#### New Contributors
- [@​NotAwar](https://github.com/NotAwar) made their first contribution in [#​5202](https://github.com/fluxcd/flux2/pull/5202)
- [@​laiminhtrung1997](https://github.com/laiminhtrung1997) made their first contribution in [#​5038](https://github.com/fluxcd/flux2/pull/5038)
- [@​y-eight](https://github.com/y-eight) made their first contribution in [#​5284](https://github.com/fluxcd/flux2/pull/5284)
- [@​piontec](https://github.com/piontec) made their first contribution in [#​5282](https://github.com/fluxcd/flux2/pull/5282)
- [@​mottetm](https://github.com/mottetm) made their first contribution in [#​5299](https://github.com/fluxcd/flux2/pull/5299)
- [@​maboehm](https://github.com/maboehm) made their first contribution in [#​5302](https://github.com/fluxcd/flux2/pull/5302)
- [@​niveau0](https://github.com/niveau0) made their first contribution in [#​5219](https://github.com/fluxcd/flux2/pull/5219)
- [@​dgunzy](https://github.com/dgunzy) made their first contribution in [#​5338](https://github.com/fluxcd/flux2/pull/5338)
**Full Changelog**: <https://github.com/fluxcd/flux2/compare/v2.5.0...v2.6.0>
### [`v2.5.1`](https://github.com/fluxcd/flux2/releases/tag/v2.5.1)
[Compare Source](https://github.com/fluxcd/flux2/compare/v2.5.0...v2.5.1)
#### Highlights
Flux v2.5.1 is a patch release which comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
- Fix a bug introduced in kustomize-controller v1.5.0 that was causing spurious logging for deprecated API versions and health check failures.
- Sanitize the kustomize-controller logs when encountering errors during SOPS decryption.
#### Components changelog
- kustomize-controller [v1.5.1](https://github.com/fluxcd/kustomize-controller/blob/v1.5.1/CHANGELOG.md)
#### CLI Changelog
- PR [#​5215](https://github.com/fluxcd/flux2/issues/5215) - [@​matheuscscp](https://github.com/matheuscscp) - Update backport labels for 2.5
- PR [#​5214](https://github.com/fluxcd/flux2/issues/5214) - [@​fluxcdbot](https://github.com/fluxcdbot) - Update kustomize-controller to v1.5.1
</details>
---
### Configuration
📅 **Schedule**: (UTC)
- Branch creation
- At any time (no schedule defined)
- Automerge
- At any time (no schedule defined)
🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.
♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 **Ignore**: Close this PR and you won't be reminded about this update again.
---
- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box
---
This PR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My4xOTEuMiIsInVwZGF0ZWRJblZlciI6IjQzLjE5MS4yIiwidGFyZ2V0QnJhbmNoIjoiZnJlc2gtc3RhcnQiLCJsYWJlbHMiOltdfQ==-->
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
This PR contains the following updates:
v2.5.0→v2.8.8Release Notes
fluxcd/flux2 (fluxcd/flux2)
v2.8.8Compare Source
Highlights
Flux v2.8.8 is a patch release that includes CVE fixes via go-git v5.19.1 (source-controller, image-automation-controller), reliability fixes in helm-controller and source-controller, the move of Helm back to upstream v4.2.0, support for GCP sovereign cloud artifact registries, and dependency updates. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
crds/directory (helm-controller)Improvements:
Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.8.7...v2.8.8
v2.8.7Compare Source
Highlights
Flux v2.8.7 is a patch release that includes a bug fix in kustomize-controller, a CVE fix in source-controller and image-automation-controller via go-git v5.19.0, and dependency updates. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
kustomize.toolkit.fluxcd.io/ssa: IfNotPresentwhere non-namespaced resources were being deleted and recreated on each reconciliation (kustomize-controller)Improvements:
Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.8.6...v2.8.7
v2.8.6Compare Source
Highlights
Flux v2.8.6 is a patch release that includes bug fixes and improvements across helm-controller, image-automation-controller, kustomize-controller, notification-controller, and source-controller. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
audiencefield on the GCR Receiver secret for tighter verification — will become mandatory in Flux v2.9 (notification-controller)Improvements:
MigrateAPIVersionfeature gate for migrating the API version of resources in managed field entries (kustomize-controller)Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.8.5...v2.8.6
v2.8.5Compare Source
Highlights
Flux v2.8.5 is a patch release that includes bug fixes and improvements across kustomize-controller, source-controller, and notification-controller. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
Improvements:
emailandaudiencefields to the GCR Receiver for tighter verification (notification-controller)Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.8.4...v2.8.5
v2.8.4Compare Source
Highlights
Flux v2.8.4 is a patch release that includes fixes for the Flux CLI. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
flux build ksandflux diff kson Windows--sourceflag validation increate kustomizationcommandCLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.8.3...v2.8.4
v2.8.3Compare Source
Highlights
Flux v2.8.3 is a patch release that fixes a regression in helm-controller. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
---in the content, e.g. YAML separators, embedded scripts, CAs inside ConfigMaps (helm-controller)Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.8.2...v2.8.3
v2.8.2Compare Source
Highlights
Flux v2.8.2 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
---getting concatenated toapiVersion:by updating to Helm 4.1.3 (helm-controller)DefaultToRetryOnFailurethat improves the experience when theCancelHealthCheckOnNewRevisionis enabled (helm-controller)Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.8.1...v2.8.2
v2.8.1Compare Source
Highlights
Flux v2.8.1 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.8.0...v2.8.1
v2.8.0Compare Source
Highlights
Flux v2.8.0 is a feature release. Users are encouraged to upgrade for the best experience.
For a compressive overview of new features and API changes included in this release, please refer to the Announcing Flux 2.8 GA blog post.
Overview of the new features:
HelmRelease)HelmRelease).status.inventory(HelmRelease)CancelHealthCheckOnNewRevisionfeature gate (Kustomization,HelmRelease)Provider)Kustomization)GitRepository,ImageUpdateAutomation,Provider)OCIRepository)ArtifactGenerator)DirectSourceFetchfeature gate (Kustomization,HelmRelease,ArtifactGenerator)❤️ Big thanks to all the Flux contributors that helped us with this release!
Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
v1.33>= 1.32.0v1.34>= 1.34.1v1.35>= 1.35.0OpenShift compatibility
Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub using Flux Operator. The operator allows the configuration of Flux multi-tenancy lockdown, network policies, persistent storage, sharding, vertical scaling and the synchronization of the cluster state from Git repositories, OCI artifacts, and S3-compatible storage.
Upgrade procedure
⚠️ The Flux APIs
v1beta2andv2beta2(deprecated in 2024) have reached end-of-life and have been removed from the CRDs.Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from older versions of Flux to v2.8.
Components changelog
CLI changelog
GITHUB_TOKENin therelease-flux-manifestsworkflow by @stefanprodan in #5547flux push artifactnot working with--providerby @matheuscscp in #5551flux migrateto work with local files by @matheuscscp in #5554flux migratefor live cluster migrations by @stefanprodan in #5558flux migrate -fcommand to work with comments by @matheuscscp in #5560flux migrate -fnot considering kind comments by @matheuscscp in #5563Kustomizationresource into unstructured map only once during variable substitution by @ramasai1 in #5566--storage-adv-addrand--events-addrflags by @stefanprodan in #5574flux get source externalby @dgunzy in #5555flux export source externalby @dgunzy in #5583flux migrate -fby @matheuscscp in #5713New Contributors
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.7.0...v2.8.0
v2.7.5Compare Source
Highlights
Flux v2.7.5 is a patch release that comes with fixes to helm-controller. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
RetryOnFailurestrategy.⚠️ Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3.
Flux users are advised to use Cosign v2.6 for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.
Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.7.4...v2.7.5
v2.7.4Compare Source
Highlights
Flux v2.7.4 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
DisableConfigWatchersfeature gate to all controllers for disabling the Secrets/ConfigMaps watchersArtifactGeneratorto aggregated RBAC roles⚠️ Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3.
Flux users are advised to use Cosign v2.6 for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.
Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.7.3...v2.7.4
v2.7.3Compare Source
Highlights
Flux v2.7.3 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Fixes:
RetryOnFailurestrategymessage_thread_id⚠️ Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3. Users are advised to use Cosign v2.6 for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.
Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.7.2...v2.7.3
v2.7.2Compare Source
Highlights
Flux v2.7.2 is a patch release that comes with security fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
All Flux components are now built with Go 1.25.2 which includes fixes for vulnerabilities in the Go stdlib that could lead to denial of service. The list of security fixes can be found in the Go 1.25.2 release notes.
Components changelog
CLI changelog
--storage-adv-addrand--events-addrflags by @github-actions[bot] in #5575Full Changelog: https://github.com/fluxcd/flux2/compare/v2.7.1...v2.7.2
v2.7.1Compare Source
Highlights
Flux v2.7.1 is a patch release that comes with various improvements and fixes. Users are encouraged to upgrade for the best experience.
ℹ️ Please follow the Upgrade Procedure for Flux v2.7+ for a smooth upgrade from Flux v2.6 to the latest version.
Improvements:
Fixes:
flux migratecommand to handle managed fields properly.Readycondition patching in helm-controller.Components changelog
CLI changelog
flux push artifactnot working with--providerby @github-actions[bot] in #5553flux migrateto work with local files by @github-actions[bot] in #5557flux migratefor live cluster migrations by @github-actions[bot] in #5559flux migrate -fcommand to work with comments by @github-actions[bot] in #5561flux migrate -fnot considering kind comments by @github-actions[bot] in #5564Full Changelog: https://github.com/fluxcd/flux2/compare/v2.7.0...v2.7.1
v2.7.0Compare Source
Highlights
Flux v2.7.0 is a feature release. Users are encouraged to upgrade for the best experience.
For a compressive overview of new features and API changes included in this release, please refer to the Announcing Flux 2.7 GA blog post.
Overview of the new features:
ImagePolicy,ImageRepository,ImageUpdateAutomation)Kustomization,HelmRelease)Kustomization,HelmRelease)Kustomization,HelmRelease)Kustomization)Kustomization)RetryOnFailurelifecycle management strategy (HelmRelease)Provider)Bucket,Provider)GitRepository,ImageUpdateAutomation,Provider)KustomizationandHelmReleasereconciliation (Provider)ExternalArtifact)ArtifactGenerator)CancelHealthCheckOnNewRevisionfeature gate (kustomize-controller)GitSparseCheckoutfeature gate (image-automation-controller)❤️ Big thanks to all the Flux contributors that helped us with this release!
Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
v1.32>= 1.32.0v1.33>= 1.33.0v1.34>= 1.34.1OpenShift compatibility
Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub using Flux Operator. The operator allows the configuration of Flux multi-tenancy lockdown, network policies, persistent storage, sharding, vertical scaling and the synchronization of the cluster state from Git repositories, OCI artifacts, and S3-compatible storage.
Upgrade procedure
⚠️ The Flux APIs
v1beta1andv2beta1(deprecated in 2023) have reached end-of-life and have been removed from the CRDs.Unless you are using Flux Operator to deploy the Flux controllers, you must run the
flux migratecommand on clusters before upgrading.For more details, please refer to the Flux v2.7 upgrade guide.
Components changelog
New Documentation
CLI changelog
v2.6.xby @stefanprodan in #5379flux push artifact --provider azureon DevOps runners by @matheuscscp in #5390knownhosts key mismatchregression bug by @matheuscscp in #5404normalize.UnstructuredListinstead ofssa.SetNativeKindsDefaultsby @cappyzawa in #5407flux create tenantby @reiSh6phoo9o in #5402flux push artifactfor insecure registries by @stefanprodan in #5449flux diff kustomizationignore patterns by @dgunzy in #5451app.kubernetes.io/part-of: fluxlabel to controller pods by @pinkavaj in #5440flux migratecommand by @stefanprodan in #5473GOMAXPROCSby @stefanprodan in #5501--all-namespacesflag by @mohiuddin-khan-shiam in #5414--show-historyflag todebug helmreleaseby @hawkaii in #5505ArtifactGeneratorkind by @stefanprodan in #5520flux [reconcile|suspend|resume] image policycommands by @lukas8219 in #5492force: enabledannotation influx diff kscommand by @stefanprodan in #5528fluxcd/gha-workflowsby @stefanprodan in #5529ArtifactGeneratorsduring uninstall by @stefanprodan in #5531ExternalArtifacttoflux traceby @stefanprodan in #5532--show-historyflag todebug kustomizationby @matheuscscp in #5541fluxcd/flux2/action: Determine latest version without using GitHub API by @RussellAult in #5509New Contributors
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.6.0...v2.7.0
v2.6.4Compare Source
Highlights
Flux v2.6.4 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
Components changelog
CLI changed
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.6.3...v2.6.4
v2.6.3Compare Source
Highlights
Flux v2.6.3 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
rsa-sha2-512andrsa-sha2-256algorithms not being prioritized forssh-rsahost keys in source-controller, image-automation-controller and Flux CLI bootstrap.Components changelog
CLI changed
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.6.2...v2.6.3
v2.6.2Compare Source
Highlights
Flux v2.6.2 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
flux push artifact --provider=azureon Azure DevOps runners.knownhosts key mismatchregression bug in the Flux CLI, source-controller and image-automation-controller.Components changelog
CLI changelog
flux push artifact --provider azureon DevOps runners by @fluxcdbot in #5396knownhosts key mismatchregression bug by @fluxcdbot in #5405Full Changelog: https://github.com/fluxcd/flux2/compare/v2.6.1...v2.6.2
v2.6.1Compare Source
Highlights
Flux v2.6.1 is a patch release that comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
Components changelog
CLI changelog
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.6.0...v2.6.1
v2.6.0Compare Source
Highlights
Flux v2.6.0 is a feature release. Users are encouraged to upgrade for the best experience.
For a compressive overview of new features and API changes included in this release, please refer to the Announcing Flux 2.6 GA blog post.
Overview of the new features:
flux artifactcommandsWaitForTerminationdeletion policy (Kustomization)DisableChartDigestTrackingfeature gate (HelmRelease)❤️ Big thanks to all the Flux contributors that helped us with this release!
Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
v1.31>= 1.31.0v1.32>= 1.32.0v1.33>= 1.33.0OpenShift compatibility
Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub using Flux Operator.
The operator allows the configuration of Flux multi-tenancy lockdown, network policies, persistent storage, sharding, vertical scaling and the synchronization of the cluster state from Git repositories, OCI artifacts, and S3-compatible storage.
Upgrade procedure
Upgrade Flux from
v2.5.0tov2.6.0by following the upgrade guide.To upgrade the APIs, make sure the new CRDs and controllers are deployed, and then change the manifests in Git:
apiVersion: source.toolkit.fluxcd.io/v1in the YAML files that containOCIRepositorydefinitions.api.fluxcd.io/upgrade: "v2.6.0"to theOCIRepositoryresources. (this is not required if Flux Operator is used for upgrade)Bumping the APIs version in manifests can be done gradually.
It is advised to not delay this procedure as the deprecated versions will be removed after 6 months.
Components changelog
New Documentation
What's Changed
flux tracefor HRs fromOCIRepositorys by @makkes in #5349New Contributors
Full Changelog: https://github.com/fluxcd/flux2/compare/v2.5.0...v2.6.0
v2.5.1Compare Source
Highlights
Flux v2.5.1 is a patch release which comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes:
Components changelog
CLI Changelog
Configuration
📅 Schedule: (UTC)
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate.