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-controllerv1.5.1

CLI Changelog

• PR#5215 -@matheuscscp - Update backport labels for 2.5
• PR#5214 -@fluxcdbot - Update kustomize-controller to v1.5.1

Contributors

Highlights

Flux v2.5.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 theAnnouncing Flux 2.5 GA blog post.

Overview of the new features:

• Support for GitHub App authentication (GitRepository andImageUpdateAutomation API)
• Custom Health Checks using CEL (Kustomization API)
• Fine-grained control of garbage collection (Kustomization API)
• Enable decryption of secrets generated by Kustomize components (Kustomization API)
• Support for custom event metadata from annotations (Alert API)
• Git commit status updates for Flux Kustomizations with OCIRepository sources (Alert API)
• Resource filtering using CEL for webhook receivers (Receiver API)
• Debug commands for Flux Kustomizations and HelmReleases (Flux CLI)

❤️ Big thanks to all the Flux contributors that helped us with this release!

Kubernetes compatibility

This release is compatible with the following Kubernetes versions:

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 fromv2.4.0 tov2.5.0 by following theupgrade guide.

There are no new API versions in this release, so no changes are required in the YAML manifests containing Flux resources.

Components changelog

• source-controllerv1.5.0
• kustomize-controllerv1.5.0
• notification-controllerv1.5.0
• helm-controllerv1.2.0
• image-reflector-controllerv0.34.0
• image-automation-controllerv0.40.0

CLI Changelog

• PR#5204 -@stefanprodan - Update kubectl in flux-cli image
• PR#5203 -@stefanprodan - Update flux-cli image
• PR#5200 -@stefanprodan - Update Kubernetes min supported version to 1.30
• PR#5199 -@matheuscscp - Update integration tests dependencies for Flux 2.5
• PR#5195 -@fluxcdbot - Update toolkit components
• PR#5192 -@fluxcdbot - Update toolkit components
• PR#5190 -@dependabot[bot] - build(deps): bump github.com/distribution/distribution/v3 from 3.0.0-rc.2 to 3.0.0-rc.3
• PR#5188 -@matheuscscp - Upgrade pkg/runtime
• PR#5187 -@stefanprodan - Update conformance test suite
• PR#5181 -@dependabot[bot] - build(deps): bump the ci group across 1 directory with 13 updates
• PR#5176 -@YvanGuidoin - fix: alignflux diff skipping with kustomize-controller
• PR#5175 -@stefanprodan - Update dependencies
• PR#5151 -@stefanprodan - [RFC-0009] Custom Health Checks using CEL expressions
• PR#5146 -@sjorsholtrop-ritense - Improve "flux resume" error message on non-existent object
• PR#5142 -@matheuscscp - Fix create command always using imageRepositoryType
• PR#5137 -@scottrigby - Add OpenShift 4.16 & 4.17 to conformance testing
• PR#5117 -@stefanprodan - Implementflux debug kustomization command
• PR#5114 -@stefanprodan - Update dependencies to Kubernetes 1.32.0 and Go 1.23.0
• PR#5111 -@stefanprodan - Run conformance tests for Kubernetes 1.32.0
• PR#5107 -@darkowlzz - workflows: Use setup-terraform to install latest
• PR#5106 -@stefanprodan - Implementflux debug helmrelease command
• PR#5105 -@stefanprodan - Updatefluxcd/pkg dependencies
• PR#5104 -@dependabot[bot] - build(deps): bump the ci group across 1 directory with 11 updates
• PR#5103 -@dipti-pai - [RFC-007] Flux cli support for GitHub app authentication
• PR#5099 -@bkreitch - fix misplaced quotes
• PR#5073 -@mloskot - docs: Mention Flux upgrade guide in release notes
• PR#5071 -@milas - fix: skip remote Kustomizations on recursive diff
• PR#5068 -@h3nryc0ding - fix(cli): confusing error message for missing kind
• PR#5060 -@jdewinne - Use replicated-actions in conformance tests

Contributors

Highlights

Flux v2.4.0 is a feature release. Users are encouraged to upgrade for the best experience.

For a comprehensive overview of new features and API changes included in this release, please refer to theAnnouncing Flux 2.4 GA blog post.

This release marks the General Availability (GA) of Flux Bucket API. TheBucket v1 API comes with new features including: proxy support, mTLS and custom STS configuration for AWS S3 and MinIO LDAP authentication.

TheGitRepository v1 API gains support for OIDC authentication. Starting with this version, you can authenticate against Azure DevOps repositories using AKS Workload Identity.

TheOCIRepository v1beta2 API gains support for proxy configuration thus allowing dedicated HTTP/S Proxy authentication on multi-tenant Kubernetes clusters.

TheHelmRelease v2 API gains support for disabling JSON schema validation of the Helm release values during installation and upgrade. And allows adopting existing Kubernetes resources during Helm release installation.

The Flux controllers are now built with Go 1.23 and their dependencies have been updated to Kubernetes 1.31, Helm 3.16, SOPS 3.9 Cosign 2.4 and Notation 1.2.

❤️ Big thanks to all the Flux contributors that helped us with this release!

Kubernetes compatibility

This release is compatible with the following Kubernetes versions:

OpenShift compatibility

Flux can be installed on Red Hat OpenShift cluster directly from OperatorHub usingFlux 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.

API changes

Bucket v1

TheBucket kind was promoted from v1beta2 to v1 (GA).

The v1 API is backwards compatible with v1beta2.

New fields:

• .spec.proxySecretRef allows configuring HTTP/S Proxy authentication for the S3-compatible storage service.
• .spec.certSecretRef allows custom TLS client certificate and CA for secure communication with the S3-compatible storage service.
• .spec.sts allows custom STS configuration for AWS S3 and MinIO LDAP authentication.

GitRepository v1

TheGitRepository kind gains new optional fields with no breaking changes.

New fields:

• .spec.provider allows specifying an OIDC provider used for authentication purposes. Currently, only theazure provider is supported.

OCIRepository v1beta2

TheOCIRepository kind gains new optional fields with no breaking changes.

New fields:

• .spec.proxySecretRef allows configuring HTTP/S Proxy authentication for the container registry service.

HelmRelease v2

TheHelmRelease kind gains new optional fields with no breaking changes.

New fields:

• .spec.install.disableSchemaValidation allows disabling the JSON schema validation of the Helm release values during installation.
• .spec.upgrade.disableSchemaValidation allows disabling the JSON schema validation of the Helm release values during upgrade.

Upgrade procedure

Upgrade Flux fromv2.3.0 tov2.4.0 either byrerunning bootstrap or by using theFlux GitHub Action.

To upgrade the APIs, make sure the new CRDs and controllers are deployed, and then change the manifests in Git:

1. SetapiVersion: source.toolkit.fluxcd.io/v1 in the YAML files that containBucket definitions.
2. 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-controllerv1.4.0v1.4.1
• kustomize-controllerv1.4.0
• notification-controllerv1.4.0
• helm-controllerv1.1.0
• image-reflector-controllerv0.33.0
• image-automation-controllerv0.39.0

New Documentation

• Bucket v1 specification
• Azure DevOps OIDC auth configuration

CLI Changelog

• PR#5014 -@stefanprodan - Update Kubernetes dependencies to v1.31.1
• PR#5011 -@stefanprodan - Remove TLS deprecated flags fromflux create secret
• PR#5010 -@stefanprodan - Addflux create secret proxy command
• PR#5009 -@stefanprodan - Add--proxy-secret-ref toflux create source commands
• PR#5008 -@stefanprodan - Promotebucket commands to GA
• PR#5007 -@stefanprodan - Run conformance tests for Kubernetes 1.29-1.31
• PR#5005 -@fluxcdbot - Update toolkit components
• PR#5004 -@fluxcdbot - Update source-controller to v1.4.1
• PR#4986 -@dipti-pai - [RFC-0007] Add--provider flag toflux create source git
• PR#4970 -@JasonTheDeveloper - Update notaryproject/notation-go to 1.2.1
• PR#4967 -@mxtw - tests: use tempdir to avoid manual gc
• PR#4959 -@stefanprodan - Fix GitHub bootstrap for repositories with custom properties
• PR#4948 -@harshitasao - fix: fixed GHA token-permission and pinned dependencies issue
• PR#4939 -@bkreitch - Recursively diff Kustomizations
• PR#4936 -@stefanprodan - Build with Go 1.23
• PR#4934 -@stefanprodan - Update dependencies to Kubernetes v1.31.0
• PR#4922 -@bkreitch - Stop spinner on cancel of flux diff kustomization
• PR#4918 -@matheuscscp - Fix reconcile helmrelease command description
• PR#4892 -@stefanprodan - Run conformance tests for Kubernetes v1.31
• PR#4871 -@harshitasao - changed the scorecard badge link to the standard format
• PR#4866 -@nagyv - Introduce visibility flag for bootstrap gitlab
• PR#4863 -@stefanprodan - Update conformance tests to Kubernetes v1.30.2
• PR#4845 -@stefanprodan - Run ARM64 e2e tests on GitHub runners
• PR#4842 -@stefanprodan - Addpart-of label to controllers base
• PR#4835 -@stefanprodan - ci: Adapt config to GoRelease v2
• PR#4806 -@dipti-pai - [RFC] Passwordless authentication for Git repositories

Contributors

Highlights

Flux v2.3.0 is a feature release. Users are encouraged to upgrade for the best experience.

For a comprehensive overview of new features and API changes included in this release, please refer to theAnnouncing Flux 2.3 GA blog post.

This release marks the General Availability (GA) of Flux Helm features and APIs, including helm-controller, theHelmRelease,HelmChart, andHelmRepository APIs.

TheHelmRepository v2 API comes with new features, such as the ability to reference Helm charts fromOCIRepository sources, reuse existingHelmChart resources, and verify the integrity of Helm chart artifacts signed with Notary Notation.

❤️ Big thanks to all the Flux contributors that helped us with this release!

Kubernetes compatibility

This release is compatible with the following Kubernetes versions:

API changes

HelmRelease v2

TheHelmRelease kind was promoted from v2beta2 to v2 (GA).

The v2 API is backwards compatible with v2beta2, with the exception of the deprecated fields which have been removed.

Removed fields:

• .spec.chart.spec.valuesFile replaced by.spec.chart.spec.valuesFiles.
• .spec.postRenderers.kustomize.patchesJson6902 replaced by.spec.postRenderers.kustomize.patches.
• .spec.postRenderers.kustomize.patchesStrategicMerge replaced by.spec.postRenderers.kustomize.patches.
• .status.lastAppliedRevision replaced by.status.history.chartVersion.

New fields:

• .spec.chartRef allows referencing chart artifacts fromOCIRepository andHelmChart objects.
• .spec.chart.spec.ignoreMissingValuesFiles allows ignoring missing values files instead of failing to reconcile.

HelmChart v1

TheHelmChart kind was promoted from v1beta2 to v1 (GA).

The v1 API is backwards compatible with v1beta2, with the exception of the deprecated fields which have been removed.

Removed fields:

• .spec.valuesFile replaced by.spec.chart.valuesFiles.

New fields:

• .spec.ignoreMissingValuesFiles allows ignoring missing values files instead of failing to reconcile.
• .spec.verify.provider: notation verify the signature of a Helm OCI artifacts using Notation trust policy and CA certificate.

HelmRepository v1

TheHelmRepository kind was promoted from v1beta2 to v1 (GA).

The v1 API is backwards compatible with v1beta2.

OCIRepository v1beta2

TheOCIRepository kind gains new optional fields with no breaking changes.

New fields:

• .spec.ref.semverFilter allows filtering the tags based on regular expressions before applying the semver range.
• .spec.verify.provider: notation verify the signature of OCI artifacts using Notation trust policy and CA certificate.

Kustomization v1

The FluxKustomization kind gains new optional fields with no breaking changes.

New fields:

• .spec.namePrefix allows setting a name prefix for the generated resources.
• .spec.nameSuffix allows setting a name suffix for the generated resources.

ImageUpdateAutomation v1beta2

TheImageUpdateAutomation kind was promoted from v1beta1 to v1beta2.

The v1beta2 API is backwards compatible with v1beta1.

Deprecated fields:

• Updated template data has been deprecated in favour ofChanged that is designed to accommodate for all the types of updates made.

New fields:

• .spec.policySelector allows filteringImagePolicy based on labels.

Receiver v1

TheReceiver kind gains new optional fields with no breaking changes.

New fields:

• .spec.type: cdevents allows receiving, validating and filtering of CDEvents.

Upgrade procedure

Upgrade Flux fromv2.x tov2.3.0 either byrerunning bootstrap or by using theFlux GitHub Action.

For more details, please refer to the upgrade guide from theAnnouncing Flux 2.3 GA blog post.

Components changelog

• source-controllerv1.3.0
• kustomize-controllerv1.3.0
• notification-controllerv1.3.0
• helm-controllerv1.0.0v1.0.1
• image-reflector-controllerv0.32.0
• image-automation-controllerv0.38.0

New Documentation

• HelmRelease v2 specification
• ImageUpdateAutomation v1beta2 specification
• Oracle VBS bootstrap guide
• Azure DevOps bootstrap guide for SSH RSA SHA-2
• OpenShift installation guide and SCC configuration
• Air-gapped installation guide for private container registries
• Bootstrap with Terraform examples
• Flux hub-and-spoke example repository
• Flux CD Architecture Overview blog post

CLI Changelog

• PR#4783 -@stefanprodan - ci: Consolidate conformance tests
• PR#4781 -@stefanprodan - Set Kubernetes 1.28 as min required version
• PR#4780 -@stefanprodan - Update helm-controller to v1.0.1
• PR#4779 -@fluxcdbot - Update toolkit components
• PR#4778 -@darkowlzz - tests/integration: Run flux check after installation
• PR#4777 -@stefanprodan - Add k3s to the conformance test suite
• PR#4775 -@stefanprodan - UpdateHelmRelease API to v2 (GA)
• PR#4773 -@makkes - Add(create|delete|export) source chart commands
• PR#4771 -@matheuscscp - Add 2.3.x release label
• PR#4770 -@stefanprodan - Update Flux architecture diagram
• PR#4769 -@frekw - Add--reproducible flag toflux push artifact
• PR#4768 -@stefanprodan - Improve end-to-end test workflow
• PR#4766 -@souleb - Add support for HelmRelease v2 influx reconcile andflux create
• PR#4764 -@stefanprodan - ci: Adapt image automation test to v1beta2
• PR#4759 -@stefanprodan - Update Helm Source APIs to v1 (GA)
• PR#4754 -@stefanprodan - Add--ssh-hostkey-algos flag to bootstrap command
• PR#4747 -@stefanprodan - Update dependencies to Kubernetes 1.30
• PR#4746 -@swade1987 - Specifying go version in setup-go github action.
• PR#4736 -@dependabot[bot] - build(deps): bump the ci group with 4 updates
• PR#4735 -@JasonTheDeveloper - feat(secret): add create notation secret handler
• PR#4734 -@stefanprodan - Run conformance tests for Kubernetes 1.30.0
• PR#4729 -@stefanprodan - Add OpenShift to the conformance test suite
• PR#4728 -@toomaj - bootstrap: Add support for Git HTTP/S authorization header
• PR#4727 -@makkes - Add flags for issuer/subject OCI signature verification
• PR#4717 -@hawwwdi - SetGOMAXPROCS andGOMEMLIMIT to all Flux controllers
• PR#4710 -@stefanprodan - Addflux envsubst command
• PR#4709 -@stefanprodan - Add--strict-substitute flag toflux build ks andflux diff ks
• PR#4706 -@stefanprodan - Add--registry-creds flag to bootstrap and install commands
• PR#4705 -@stefanprodan - Update dependencies to Kustomize v5.4.0
• PR#4701 -@fluxcdbot - Update toolkit components
• PR#4699 -@stefanprodan - Update dependencies to Go 1.22 and Kubernetes 1.29.3
• PR#4689 -@makkes - Pin envtest version
• PR#4687 -@carlpett - Add permissions required for flow control
• PR#4678 -@darkowlzz - UpdateImageUpdateAutomation API to v1beta2
• PR#4666 -@stefanprodan - Mark RFC-0006 as implementable
• PR#4657 -@stefanprodan - ci: Include all go modules in snyk testing
• PR#4654 -@stefanprodan - Remove deprecated e2e tests
• PR#4629 -@rishinair11 - Fix a typo in--force flag description
• PR#4620 -@stefanprodan - Update Equinix ARM64 GitHub runners
• PR#4610 -@takp - Fix typo in build.go
• PR#4589 -@stefanprodan - Update dependencies
• PR#4583 -@fluxcdbot - Update toolkit components
• PR#4575 -@stefanprodan - Update dependencies to Kubernetes v1.28.6
• PR#4558 -@twinguy -flux check should error o...

Contributors

Highlights

Flux v2.2.3 is a patch release which comes with various fixes and improvements. Users are encouraged to upgrade for the best experience.

💡 For upgrading to Flux v2.2, please seethe procedure documented in 2.2.0.

This release updates the Kubernetes dependencies to v1.28.6 and various other dependencies to their latest version to patch upstream CVEs.

All controllers are built with Go 1.21.6 using Alpine Linux 3.19.1 base image.

Fixes:

• Reconciling empty directories and directories without Kubernetes manifests no longer results in an error. This regressing bug was introduced with the kustomize-controller upgrade to Kustomize v5.3 and has been fixed in this patch release.
• The regression due to whichRoles andClusterRoles with aggregated roles were continuous reconciled by kustomize-controller has been fixed.
• Fix the Git revision displaying when notification-controller sends alerts to Grafana.
• The HelmRelease status reporting has been improved by ensuring that the stale failure conditions get updated after failure recovery.

See the components changelog for a full list of bug fixes.

Components changelog

• source-controllerv1.2.4
• kustomize-controllerv1.2.2
• notification-controllerv1.2.4
• helm-controllerv0.37.4
• image-reflector-controllerv0.31.2
• image-automation-controllerv0.37.1

CLI Changelog

• PR#4589 -@stefanprodan - Update dependencies
• PR#4585 -@dependabot[bot] - build(deps): bump the ci group with 3 updates
• PR#4583 -@fluxcdbot - Update toolkit components
• PR#4575 -@stefanprodan - Update dependencies to Kubernetes v1.28.6
• PR#4573 -@dependabot[bot] - build(deps): bump the ci group with 5 updates
• PR#4558 -@twinguy -flux check should error on unrecognised args
• PR#4557 -@twinguy -flux stats should error on unrecognised args
• PR#4554 -@dependabot[bot] - build(deps): bump the ci group with 3 updates
• PR#4553 -@twinguy - Properly detect unexpected arguments during uninstall
• PR#4535 -@dependabot[bot] - build(deps): bump github.com/cloudflare/circl from 1.3.6 to 1.3.7
• PR#4533 -@darkowlzz - tests/int: Add separate resource cleanup step

Contributors

Highlights

Flux v2.2.2 is a patch release that addresses an issue with the label selector sharding functionality in the helm-controller. Users are encouraged to upgrade for the best experience.

💡 For upgrading to Flux v2.2, please seethe procedure documented in 2.2.0.

Components changelog

• helm-controllerv0.37.2

CLI Changelog

• PR#4505 -@hiddeco - Update helm-controller to v0.37.2 in tests
• PR#4501 -@fluxcdbot - Update toolkit components
• PR#4499 -@stuebingerb - Fix typo in Git bootstrap
• PR#4495 -@dependabot[bot] - build(deps): bump golang.org/x/crypto from 0.16.0 to 0.17.0 in /tests/integration
• PR#4494 -@dependabot[bot] - build(deps): bump golang.org/x/crypto from 0.16.0 to 0.17.0
• PR#4493 -@dependabot[bot] - build(deps): bump golang.org/x/crypto from 0.16.0 to 0.17.0 in /tests/azure
• PR#4491 -@dependabot[bot] - build(deps): bump the ci group with 3 updates

Contributors

Highlights

Flux v2.2.1 is a patch release that comes with fixes to API backwards compatibility.
Users are encouraged to upgrade for the best experience.

💡 For upgrading to Flux v2.2, please seethe procedure documented in 2.2.0.

This version was tested with the latest Kubernetes release, and extends Flux support to Kubernetes v1.29.

The Helm SDK was updated to the latest version, v3.13.3.

Logging in kustomize-controller and helm-controller has been improved to provide faster feedback on any HTTP errors encountered while fetching artifacts from source-controller.

Components changelog

• source-controllerv1.2.3
• kustomize-controllerv1.2.1
• notification-controllerv1.2.3
• helm-controllerv0.37.1

CLI Changelog

• PR#4488 -@hiddeco - tests: update API dependencies
• PR#4484 -@stefanprodan - Run conformance tests for Kubernetes v1.29.0
• PR#4483 -@fluxcdbot - Update toolkit components
• PR#4481 -@hoexter - Remove duplicate part of the reconcile hr --reset help message
• PR#4478 -@stefanprodan - Remove deprecated monitoring configs
• PR#4476 -@hiddeco - Properly detect unsupported API errors
• PR#4468 -@hiddeco - Add 2.2.x backport label

Contributors

Highlights

Flux v2.2.0 is a feature release. Users are encouraged to upgrade for the best experience.

The Flux CLI and controllers have been updated to Kustomize v5.3.0 and Kubernetes v1.28.4.

Flux helm-controller's reconciliation model underwent a significant overhaul, addressing persistent issues such as the automatic recovery of releases stuck in a pending state. In addition, it improves the observability of the release status, and it introduces the ability to enable drift detection on a per-object basis. For more details on the helm-controller improvements, please see theAnnouncing Flux 2.2 GA blog post.

The Flux CLI can now be used to force or reset the reconciliation state of aHelmRelease v2beta2 object usingflux reconcile hr --force andflux reconcile hr --reset.

Flux CLI comes with support for bootstrappingGitea repositories and adds guardrails toflux install andflux bootstrap to protect users from destructive operations. Theflux version andflux check commands now print the Flux distribution version deployed on the cluster.

The Flux alerting capabilities have been extended withNATS andBitbucket Server & Data Center support.

Starting with this release, Flux minor versions are benchmark to measure the Mean Time To Production (MTTP). The results for this version can be found at
github.com/fluxcd/flux-benchmark.

❤️ Big thanks to all the Flux contributors that helped us with this release!

Kubernetes compatibility

This release is compatible with the following Kubernetes versions:

Note that Flux may work on older versions of Kubernetes e.g. 1.25, but we don't recommend running end-of-life versions in production nor do we offer support for these versions.

API changes

HelmRelease v2beta2

TheHelmRelease kind was promoted from v2beta1 to v2beta2.

The v2beta2 API is backwards compatible with v2beta1, the v2beta1 API is deprecated and will be removed in a future release.

Deprecated fields:

• The.patchesStrategicMerge and.patchesJson6902 Kustomize post-rendering fields have been deprecated in favor of.patches.
• The.status.lastAppliedRevision and.status.lastReleaseRevision fields have been deprecated in favor of.status.history.
• The.status.lastAttemptedValuesChecksum has been deprecated in favor of.status.lastAttemptedConfigDigest.

New fields:

• Drift detection and correction is now enabled on a per-release basis using the.spec.driftDetection.mode field.
• Ignoring specific fields during drift detection and correction is now supported using the.spec.driftDetection.ignore
• Helm tests can now be selectively run using the.spec.test.filters field.
• A history of metadata from Helm releases up to the previous successful release is now available in the.status.history field. This includes any Helm test results when enabled.
• The.status.lastHandledForceAt and.status.lastHandledResetAt fields have been introduced to track the last time a force upgrade or reset was handled.

Alert and Provider v1beta3

TheAlert andProvider kinds were promoted from v1beta2 to v1beta3.

The v1beta3 API is backwards compatible with v1beta2, the.status field was removed making the resources static objects. Any errors encountered while sending notifications are now recorded as Kubernetes Events associated with the Alert objects.

Bucket v1beta2

A new field,.spec.prefix, has been added to theBucket API, which enables server-side filtering of files if the object's.spec.provider is set togeneric,aws orgcp.

OCIRepository and HelmChart v1beta2

Two new fields,.spec.verify.matchOIDCIdentity.issuer and.spec.verify.matchOIDCIdentity.subject have been added to theHelmChart andOCIRepository APIs. If the image has been keylessly signed via Cosign, these fields can be used to verify the OIDC issuer of the Fulcio certificate and the
OIDC identity's subject respectively.

HelmRepository and ImageRepository v1beta2

A new boolean field,.spec.insecure, has been introduced to the
HelmRepository andImageRepository APIs, which allows connecting to a non-TLS HTTP container registry. For HelmRepositories it is only considered if the object's.spec.type is set tooci.

From this release onwards, HelmRepository objects of type OCI are treated as static objects, i.e. they have an empty status.

Upgrade procedure

Upgrade Flux fromv2.x tov2.2.0 either byrerunning bootstrap or by using theFlux GitHub Action.

To upgrade the APIs, make sure the new CRDs and controllers are deployed, and then change the manifests in Git:

1. SetapiVersion: helm.toolkit.fluxcd.io/v2beta2 in the YAML files that containHelmRelease definitions.
2. SetapiVersion: notification.toolkit.fluxcd.io/v1beta3 in the YAML files that containAlert andProvider definitions.
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.

New Documentation

• HelmRelease v2beta2 specification
• Enable in-memory kustomize builds guide

Components changelog

• source-controllerv1.2.2
• kustomize-controllerv1.2.0
• notification-controllerv1.2.2
• helm-controllerv0.37.0
• image-reflector-controllerv0.31.1
• image-automation-controllerv0.37.0

CLI Changelog

• PR#4467 -@stefanprodan - Drop support for Kubernetes EOL versions
• PR#4465 -@stefanprodan - build: Update alpine and kubectl in flux-cli image
• PR#4464 -@souleb - Update go-git-providers to v0.19.2
• PR#4463 -@stefanprodan - Update Git dependencies
• PR#4461 -@fluxcdbot - Update toolkit components
• PR#4455 -@chewong - Fix typos in flux bootstrap documentation
• PR#4454 -@fluxcdbot - Update toolkit components
• PR#4437 -@stefanprodan - Add force and reset flags toflux reconcile hr
• PR#4433 -@darkowlzz - Update Helm OCI RFC - static HelmRepository design
• PR#4424 -@somtochiama - Show distribution name in flux check and flux version
• PR#4422 -@somtochiama - bootstrap: More details forcontext deadline exceeded error
• PR#4416 -@stefanprodan - Update dependencies to Kubernetes v1.28
• PR#4409 -@somtochiama - Make events cmd work well with lowercased and only kind selector
• PR#4404 -@VinGarcia - Fix flux install command so it returns an error when unexpected arguments are passed
• PR#4402 -@mclarke47 - fix build_artifact.go typo
• PR#4388 -@stefanprodan - [RFC-0003] OIDC identity matching for keyless verification
• PR#4382 -@darkowlzz - tests/int: Set exit code 1 on tf destroy fail
• PR#4380 -@hiddeco - Tweak permissions on created files
• PR#4355 -@somtochiama - Confirm before overriding installation by another manager
• PR#4345 -@somtochiama - Preventflux install from overriding bootrapped cluster
• PR#4332 -@matheuscscp - Add CLI flags for OCIRepository signature verification
• PR#4329 -@hiddeco - Address various issues throughout code base
• PR#4324 -@somtochiama - bootstrap: Fix error msg when the Git token doesn't match the repo owner
• PR#4323 -@stefanprodan - e2e: Update Go dependencies
• PR#4317 -@Jaykul - Correct "sync" to "component" in log lines
• PR#4313 -@fluxcdbot - Update toolkit components
• PR#4311 -@darkowlzz - Check readiness of Flux kinds using kstatus
• PR#4298 -@darkowlzz - Add support for HelmRepo OCI and NC v1beta3 static objects
• PR#4296 -@Skarlso - fix: only wait for changeset if the result is not empty
• PR#4285 -@matheuscscp - Add badge for SLSA Level 3
• PR#4284 -@errordeveloper - Makeflux pull work for OCI artifacts produced by other tools
• PR#4270 -@Azhovan - feat: add bootstrap gitea command
• PR#4255 -@hiddeco - tests/azure: update controller dependencies
• PR#4251 -@fluxcdbot - Update toolkit components
• PR#4238 -@makkes - Upgrade github.com/fluxcd/pkg/{git,git/gogit}
• PR#4233 -@sonbui00 - chore: remove support armv6h for aur package
• PR#4228 -@sonbui00 - Improve AUR package templates
• PR#4226 -@somtochiama - Update descriptio...

Contributors

Highlights

Fluxv2.1.2 is a patch release which comes with various fixes. Users are encouraged to upgrade for the best experience.

Fixes

• Ensures faster recovery ofKustomization andHelmRelease resources when the source-controller has restarted and is working on restoring the storage.
• Prevent source-controller from failing to reconcileOCIRepositories when artifacts contain symlinks.
• Addresses issue with helm-controller miss-labeling Custom Resource Definitions.
• Detect immutable field errors in Google Cloud resources managed by FluxKustomizations.
• Better error reporting forflux bootstrap when the owner doesn't match the identity associated with the given token.
• Allowflux pull artifact to fetch OCI artifacts produced by other tools.

Components changelog

• source-controllerv1.1.2
• kustomize-controllerv1.1.1
• helm-controllerv0.36.2

CLI Changelog

• PR#4324 -@somtochiama - bootstrap: Fix error msg when the Git token doesn't match the repo owner
• PR#4323 -@stefanprodan - e2e: Update Go dependencies
• PR#4313 -@fluxcdbot - Update toolkit components
• PR#4296 -@Skarlso - fix: only wait for changeset if the result is not empty
• PR#4285 -@matheuscscp - Add badge for SLSA Level 3
• PR#4284 -@errordeveloper - Makeflux pull work for OCI artifacts produced by other tools

Contributors

Highlights

Fluxv2.1.1 is a patch release which comes with various fixes. Users are encouraged to upgrade for the best experience.

Fixes

• Use auto lookup strategy for Buckets to widen support for S3-compatible object storage services (source-controller).
• Fix Secret type check for HelmRepositories TLS certs referred in.spec.secretRef (source-controller).
• Fix the branch name reporting when the push branch is the same as the checkout branch (image-automation-controller).
• Restore Helm logs inclusion in failure events (helm-controller).
• Fix the impersonation of the default service account when diffing HelmReleases (helm-controller).
• Check source fornil artifact before loading Helm charts (helm-controller).
• Update the description of Kubernetes specific flag to distinguish them from Flux bootstrap flags (flux CLI).

Components changelog

• source-controllerv1.1.1
• helm-controllerv0.36.1
• image-automation-controllerv0.36.1

CLI Changelog

• PR#4255 -@hiddeco - tests/azure: update controller dependencies
• PR#4251 -@fluxcdbot - Update toolkit components
• PR#4246 -@dependabot[bot] - build(deps): bump the ci group with 4 updates
• PR#4238 -@makkes - Upgrade github.com/fluxcd/pkg/{git,git/gogit}
• PR#4233 -@sonbui00 - chore: remove support armv6h for aur package
• PR#4228 -@sonbui00 - Improve AUR package templates
• PR#4227 -@dependabot[bot] - build(deps): bump the ci group with 3 updates
• PR#4226 -@somtochiama - Update description of kubeconfig specific flag
• PR#4222 -@dependabot[bot] - build(deps): bump github.com/cyphar/filepath-securejoin from 0.2.3 to 0.2.4 in /tests/integration
• PR#4221 -@dependabot[bot] - build(deps): bump github.com/cyphar/filepath-securejoin from 0.2.3 to 0.2.4 in /tests/azure
• PR#4215 -@dependabot[bot] - build(deps): bump the ci group with 4 updates
• PR#4213 -@dependabot[bot] - build(deps): bump github.com/docker/distribution from 2.8.1+incompatible to 2.8.2+incompatible in /tests/integration
• PR#4212 -@dependabot[bot] - build(deps): bump github.com/docker/docker from 23.0.1+incompatible to 23.0.3+incompatible in /tests/integration
• PR#4198 -@makkes - Add 2.1.x backport label
• PR#4197 -@stefanprodan - Fix links to fluxcd.io
• PR#4195 -@dependabot[bot] - build(deps): bump the ci group with 2 updates

Contributors