Release Notes

Highlights

Flux v2.9.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.9 GA blog post.

Overview of the new features:

  • Flux CLI Plugin System with the Mirror and Schema plugins (flux plugin)
  • Server-Side Apply field ignore rules for fine-grained drift control (Kustomization)
  • SOPS decryption with the Age post-quantum cipher (Kustomization)
  • Kubernetes Workload Identity authentication for OpenBao and Vault (Kustomization)
  • Helm post-render strategies, including chart hooks support (HelmRelease)
  • Literal mode for Helm values references mirroring helm --set-literal (HelmRelease)
  • Allow empty kind in CEL health check expressions (Kustomization, HelmRelease)
  • Git commit signing and verification with SSH keys (GitRepository, ImageUpdateAutomation)
  • AWS CodeCommit authentication using Workload Identity (GitRepository)
  • Custom Sigstore trusted root for keyless verification in air-gapped environments (OCIRepository)
  • Path pattern directory discovery for monorepos (ArtifactGenerator)
  • Secret-less, OIDC-secured webhook Receivers (Receiver)

❤️ 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.34 | >= 1.34.1 | | v1.35 | >= 1.35.0 | | v1.36 | >= 1.36.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

:warning: The Flux APIs image.toolkit.fluxcd.io/v1beta2 and notification.toolkit.fluxcd.io/v1beta2 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.9.

Components changelog

CLI changelog

  • Add backport label for Flux 2.8 by @matheuscscp in https://github.com/fluxcd/flux2/pull/5732
  • Remove no longer needed workaround for Flux 2.8 by @matheuscscp in https://github.com/fluxcd/flux2/pull/5733
  • Update toolkit components by @fluxcdbot in https://github.com/fluxcd/flux2/pull/5740
  • Add missing things to release notes template by @matheuscscp in https://github.com/fluxcd/flux2/pull/5743
  • ci: add top-level permissions to upgrade-fluxcd-pkg workflow by @gaganhr94 in https://github.com/fluxcd/flux2/pull/5763
  • build(deps): bump the ci group across 1 directory with 11 updates by @dependabot[bot] in https://github.com/fluxcd/flux2/pull/5764
  • Update fluxcd/pkg dependencies by @fluxcdbot in https://github.com/fluxcd/flux2/pull/5766
  • Update toolkit components by @fluxcdbot in https://github.com/fluxcd/flux2/pull/5769
  • Add target branch name to update branch by @matheuscscp in https://github.com/fluxcd/flux2/pull/5773
  • Fix/resume exit code by @Aman-Cool in https://github.com/fluxcd/flux2/pull/5701
  • Mark RFC 0010, 0011 and 0012 as implemented by @stefanprodan in https://github.com/fluxcd/flux2/pull/5776
  • Update toolkit components by @fluxcdbot in https://github.com/fluxcd/flux2/pull/5780
  • Add --resolve-symlinks flag to build and push artifact commands by @rohansood10 in https://github.com/fluxcd/flux2/pull/5724
  • fix: validate --source flag in create kustomization command by @gma1k in https://github.com/fluxcd/flux2/pull/5798
  • Update toolkit components by @fluxcdbot in https://github.com/fluxcd/flux2/pull/5821
  • Add --show-source to flux get ks and flux get hr by @rafaelperoco in https://github.com/fluxcd/flux2/pull/5828
  • Add flux create secret receiver command by @stefanprodan in https://github.com/fluxcd/flux2/pull/5835
  • fix: handle multiple symlinks to same target in build artifact by @Iam-Karan-Suresh in https://github.com/fluxcd/flux2/pull/5833
  • Add --in-memory-build to flux build ks and flux diff ks by @rycli in https://github.com/fluxcd/flux2/pull/5794
  • Migrate end-to-end test to latest cloud SDKs by @stefanprodan in https://github.com/fluxcd/flux2/pull/5840
  • docs: Add AI Coding Assistants Guidance by @stefanprodan in https://github.com/fluxcd/flux2/pull/5841
  • Add AI Agents guidance by @stefanprodan in https://github.com/fluxcd/flux2/pull/5847
  • [RFC-0013] Flux CLI Plugin Sys

[truncated]