Flux Roadmap

Production readiness

The Flux latest beta and stable APIs (including their reconcilers) are well tested and safe to use in production environments. The beta APIs will be replaced in time with stable versions.

To learn more about Flux supported versions and release cadence, please see the Flux release process.

Milestones

The Flux project roadmap is divided into milestones representing minor releases, each with a set of goals and tasks. The milestones marked as provisional are subject to change based on the project’s priorities and the community’s feedback.

Please note that the Flux maintainers prioritize fixes to defects affecting GA APIs and security issues over new features. Depending on the volume of incoming issues and the complexity of the fixes, the roadmap may be adjusted and new features may be postponed to the next milestone.

v2.2 (Q4 2023)

Status: Completed (v2.2.0 changelog)

The primary goal of this milestone is to promote the HelmRelease beta API to v2beta2 and to introduce a new reconciliation model for Helm releases.

Helm integrations
OCI artifacts integrations
Git integrations
- Support for Gitea bootstrap
- Support for BitBucket commit status updates
Alerting integrations
- Promote the Alert API to v1beta3
- Promote the Provider API to v1beta3
Conformance testing
EOL and Deprecations
- End support for Kubernetes v1.25.x
- Deprecate APIs in group helm.toolkit.fluxcd.io/v2beta1
- Deprecate APIs in group notification.toolkit.fluxcd.io/v2beta2

v2.3 (Q2 2024)

Status: Completed (v2.3.0 changelog)

The primary goal of this milestone is to make a generally available release for the Flux Helm APIs and the Flux Helm functionalities.

Helm integrations
- Promote the HelmRepository API to v1 GA
- Promote the HelmChart API to v1 GA
- Promote the HelmRelease API to v2 GA
- Promote the Flux CLI Helm-related commands to GA
- Reuse charts between releases with OCIRepository
- Reuse existing HelmChart resource between releases
OCI artifacts integrations
CDEvents integrations
- Extend the Receiver API with support for CDEvents
Image automation
- Promote the ImageUpdateAutomation API to v1beta2
- Enhance image-automation-controller reconciliation model
- Add support for selecting image policies with a label selector
- Allow including the previous image tag in the commit message template
Terraform provider
Conformance testing
EOL and Deprecations
- End support for Flux v2.0.x
- End support for Kubernetes v1.27.x
- Deprecate APIs in group helm.toolkit.fluxcd.io/v2beta2
- Deprecate APIs in group image.toolkit.fluxcd.io/v1beta1
- Remove deprecated Terraform providers flux_install and flux_sync

v2.4 (Q3 2024)

Status: Completed (v2.4.0 changelog)

The primary goal of this milestone is to make a generally available release for the Flux S3-compatible storage APIs.

S3-compatible storage integrations
- Promote the Bucket API to v1
- Allow specifying a custom CA certificate in Bucket API
- Allow specifying HTTP/S proxy in Bucket API
- Add support for STS endpoint in the Bucket API
OCI artifacts integrations
- Allow specifying HTTP/S proxy in OCIRepository API
Git integrations
- RFC - Passwordless authentication for Git repositories
- Implement Workload Identity auth for Azure DevOps repositories
Helm integrations
- Adopt existing resources
- Allow disabling JSON schema validation
Alerting integrations
- Teams notifications using the Microsoft Adaptive Card API
Conformance testing
- End-to-end testing for Kubernetes 1.31
- End-to-end testing for AWS integrations
EOL and Deprecations
- End support for Flux v2.1.x
- End support for Kubernetes v1.27.x
- Deprecate Bucket API in group source.toolkit.fluxcd.io/v1beta2

v2.5 (TBD)

Status: In progress

The primary goal of this milestone is to make a generally available release for the Flux image automation APIs.

Image automation
- Promote the ImageUpdateAutomation API to v1
- Promote the ImageRepository API to v1
- Promote the ImagePolicy API to v1
- Add support for updating OCI digests
OCI artifacts integrations
Git integrations
- Implement GitHub App auth for GitHub repositories
Conformance testing
- End-to-end testing for Kubernetes 1.32
EOL and Deprecations
- End support for Flux v2.2.x
- End support for Kubernetes v1.28.x
- Deprecate APIs in group image.toolkit.fluxcd.io/v1beta2
- Remove deprecated APIs in group kustomize.toolkit.fluxcd.io/v1beta1
- Remove deprecated APIs in group source.toolkit.fluxcd.io/v1beta1
- Remove deprecated APIs in group notification.toolkit.fluxcd.io/v1beta1
- Remove deprecated APIs in group helm.toolkit.fluxcd.io/v2beta1
- Remove deprecated APIs in group image.toolkit.fluxcd.io/v1beta1

Request for comments

The RFC process provides a consistent and controlled path for substantial changes to enter Flux.

To keep track of the Flux project current direction and future plans, please see following RFCs:

RFC-0001 Memorandum on the authorization model
RFC-0002 Flux OCI support for Helm
RFC-0003 Flux OCI support for Kubernetes manifests
RFC-0004 Block insecure HTTP connections across Flux
RFC-0005 Artifact Revision format and introduction of Digest
RFC-0006 Flux CDEvents Receiver
RFC-0007 Passwordless authentication for Git repositories
RFC Define Flux tenancy models
RFC Custom Health Checks for Kustomization using Common Expression Language(CEL)
RFC Flux Bootstrap for OCI-compliant Container Registries