Flux Roadmap

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

  • Promote HelmRelease API to v2beta2
  • Enhanced helm-controller reconciliation model
  • Improved observability of Helm releases
  • Implement Helm Release drift detection and correction
  • Allow forcing and retrying Helm releases

• OCI artifacts integrations

  • Static Helm OCI repositories
  • Cosign keyless verification for HelmChart artifacts
  • Cosign keyless verification for OCIRepository artifacts
  • Allow connecting to insecure HelmRepositories
  • Allow connecting to insecure ImageRepositories

• 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

  • Benchmark to measure the Mean Time To Production (MTTP)
  • End-to-end testing for Google Cloud integrations
  • End-to-end testing for Kubernetes 1.29

• 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: In progress

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

  • Notation verification for HelmChart artifacts
  • Notation verification for OCIRepository artifacts
  • Add ref.semverFilter to OCIRepository API

• 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

  • Add support for air-gapped bootstrap
  • Implement drift detection and correction for cluster state
  • Improve documentation with concrete examples for the various bootstrap methods

• Conformance testing

  • End-to-end testing for Kubernetes 1.30
  • End-to-end testing for OpenShift

• EOL and Deprecations

  • End support for Flux v2.0.x
  • End support for Kubernetes v1.26.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: Provisional

The primary goal of this milestone is to make a generally available release for the Flux image automation APIs and S3-compatible storage 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

• S3-compatible storage integrations

  • Promote the Bucket API to v1

• OCI artifacts integrations

  • Cache registry credentials for cloud providers
  • Enhance OCI Artifact support
  • Add support for layer extraction from OCI artifacts with ImageIndex

• Git integrations

  • Passwordless authentication for Git repositories
  • Implement Workload Identity auth for Azure DevOps repositories
  • Implement GitHub App auth for GitHub repositories

• 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
  • 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
  • Deprecate APIs in group image.toolkit.fluxcd.io/v1beta2

v2.5 (TBD)

Status: Provisional

This milestone’s tasks have not been determined yet.

• 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
  • 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 Define Flux tenancy models
• RFC Passswordless authentication for Git repositories
• RFC Custom Health Checks for Kustomization using Common Expression Language(CEL)