Flux 2

fluxcd/flux2 last check 206 releases recent
Release notes
2.5.0 · 1y+
view on github

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 the Announcing Flux 2.5 GA blog post.

Overview of the new features:

  • Support for GitHub App authentication (GitRepository and ImageUpdateAutomation 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:

Kubernetes version Minimum required
v1.30 >= 1.30.0
v1.31 >= 1.31.0
v1.32 >= 1.32.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.4.0 to v2.5.0 by following the upgrade guide.

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

Components changelog

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: align flux 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 - Implement flux 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 - Implement flux debug helmrelease command
  • PR #5105 - @stefanprodan - Update fluxcd/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