Flux v2.9.0 is a feature release adding a CLI plugin system, Server-Side Apply field ignore rules, Age-based SOPS decryption, and expanded Workload Identity and signing support across controllers. The one breaking change is the removal of the end-of-life image.toolkit.fluxcd.io/v1beta2 and notification.toolkit.fluxcd.io/v1beta2 APIs from the CRDs, so anyone still on those versions must migrate before upgrading.
breakingMigrate off image.toolkit.fluxcd.io/v1beta2
The image.toolkit.fluxcd.io/v1beta2 API has reached end-of-life and has been removed from the CRDs in v2.9.0. Any ImagePolicy, ImageRepository, or ImageUpdateAutomation manifests still using v1beta2 must be migrated to a supported API version before upgrading.
breakingMigrate off notification.toolkit.fluxcd.io/v1beta2
The notification.toolkit.fluxcd.io/v1beta2 API has reached end-of-life and has been removed from the CRDs in v2.9.0. Alert, Provider, or Receiver manifests still on v1beta2 need updating to a supported API version first.
Key changes (8)
- Breaking: image.toolkit.fluxcd.io/v1beta2 and notification.toolkit.fluxcd.io/v1beta2 removed from CRDs after reaching end-of-life; migrate manifests before upgrading
- New Flux CLI Plugin System (`flux plugin`) with Mirror and Schema plugins
- Kustomization gains Server-Side Apply field ignore rules, SOPS decryption with the Age post-quantum cipher, and Workload Identity auth for OpenBao/Vault
- HelmRelease adds post-render strategies with chart hooks and a literal mode for values (mirroring `helm --set-literal`)
- Git commit signing/verification with SSH keys for GitRepository and ImageUpdateAutomation, plus AWS CodeCommit auth via Workload Identity
- Secret-less, OIDC-secured webhook Receivers and custom Sigstore trusted root support for air-gapped OCIRepository verification
- Component controllers bumped (source-controller v1.9.1, kustomize-controller v1.9.1, notification-controller v1.9.1, helm-controller v1.6.1, image-reflector/automation-controller v1.2.1); CLI now builds against Kubernetes 1.36 and Go 1.26
- Plus assorted CLI additions (new commands/flags) and bug fixes: resume exit code, artifact symlink handling, label preservation in `flux build ks`, status-selector filtering