Flux (GitOps) extension release notes

The Flux (GitOps) extension is updated on an ongoing basis. This article provides information about the most recent releases of the extension.

Important

To ensure continued compatibility and avoid errors, update your sources to remove references to deprecated APIs and ensure that clusters are running the latest version of the extension.

The most recent version of the Flux (GitOps) extension and the two previous versions (N-2) are supported. We generally recommend that you use the most recent version of the extension.

When a new version of the microsoft.flux extension is released, it can take several days for the new version to become available in all regions.

Deprecation and removal notice: Changes to `microsoft.flux` extension

Several upstream Flux APIs that were retired by the Flux project are removed in version 1.23.0 of the microsoft.flux extension. These changes align with the Flux community's efforts to streamline and modernize the API surface.

Caution

If you don't update your sources to remove references to deprecated APIs, you might experience disruptions in Flux functionality and see error messages referencing a removed kind/API, such as:

Error Signature: no matches for kind "HelmRepository" in version "source.toolkit.fluxcd.io/v1beta1"

Error Signature: no matches for kind "HelmRelease" in version "helm.toolkit.fluxcd.io/v2beta1"

The following Flux APIs have been removed:

Deprecated APIs in group source.toolkit.fluxcd.io/v1beta1 and source.toolkit.fluxcd.io/v1beta2
Deprecated APIs in group kustomize.toolkit.fluxcd.io/v1beta1 and kustomize.toolkit.fluxcd.io/v1beta2
Deprecated APIs in group helm.toolkit.fluxcd.io/v2beta1 and helm.toolkit.fluxcd.io/v2beta2
Deprecated APIs in group notification.toolkit.fluxcd.io/v1beta1
Deprecated APIs in group image.toolkit.fluxcd.io/v1beta1

For more information, see https://github.com/fluxcd/flux2/issues/5572.

Required action: To ensure continued compatibility and avoid disruptions, update your sources to remove references to deprecated APIs as soon as possible. Use the supported API versions for all impacted resources and upgrade your clusters to use microsoft.flux version 1.23.0, which introduces the Flux 2.7 API version. If your clusters are running 1.20.4 or lower, upgrade them to an interim version (1.21.0 - 1.22.2) first, and then upgrade to version 1.23.0.

Migrate all your resources to the Flux stable APIs in your sources (Git repositories, OCI repositories, buckets, blob storage) by replacing the API version in the manifests:

Kustomization to kustomize.toolkit.fluxcd.io/v1
HelmRelease to helm.toolkit.fluxcd.io/v2
Bucket to source.toolkit.fluxcd.io/v1
GitRepository to source.toolkit.fluxcd.io/v1
HelmChart to source.toolkit.fluxcd.io/v1
HelmRepository to source.toolkit.fluxcd.io/v1
OCIRepository to source.toolkit.fluxcd.io/v1
Receiver to notification.toolkit.fluxcd.io/v1
Alert to notification.toolkit.fluxcd.io/v1beta3
Provider to notification.toolkit.fluxcd.io/v1beta3
ImageRepository to image.toolkit.fluxcd.io/v1beta2
ImagePolicy to image.toolkit.fluxcd.io/v1beta2
ImageUpdateAutomation to image.toolkit.fluxcd.io/v1beta2

Note that the ImageUpdateAutomation commit template should use the fields .Changed.FileChanges, .Changed.Objects and .Changed.Changes instead of the deprecated .Updated and .Changed.ImageResult fields.

Once the manifests are updated in the sources, Flux will reconcile the new API versions.

June 2026 - `microsoft.flux` version 1.23.1

Flux version: Release v2.7.5

source-controller: v1.7.4-13
kustomize-controller: v1.7.3-12
helm-controller: v1.4.5-11
notification-controller: v1.7.5-10
image-automation-controller: v1.0.4-12
image-reflector-controller: v1.0.4-9

Addressed security vulnerabilities in fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controller, kustomize-controller, notification-controller, image-automation-controller, image-reflector-controller, and helm-controller by updating the Go packages and base images.

June 2026 - `microsoft.flux` version 1.23.0

Important

Clusters must be running version 1.21.0 or higher in order to subsequently upgrade to version 1.23.0, which includes the Flux 2.7 API version.

Flux version: Release v2.7.5

source-controller: v1.7.4-10
kustomize-controller: v1.7.3-9
helm-controller: v1.4.5-8
notification-controller: v1.7.5-7
image-automation-controller: v1.0.4-9
image-reflector-controller: v1.0.4-6