You are viewing documentation for Flux version: 2.1

Version 2.1 of the documentation is no longer actively maintained. The site that you are currently viewing is an archived snapshot. For up-to-date documentation, see the latest version.

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. After an API reaches GA, users have a six months window to upgrade the Flux CRDs and their Custom Resources from beta to stable.

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

Milestones

The GA roadmap has been split into separate milestones. The Flux team’s current focus is to finalise the tasks from the Flux GitOps GA milestone. We estimate that the Flux features part of this milestone will become generally available in the first quarter of 2023.

Flux GitOps GA (Completed in July 2023)

The goal of this milestone is to make a generally available release for the Flux GitOps APIs, and the Flux Git bootstrap & webhooks functionalities.

The completion of this milestone is marked by the v2.0.0 release of the Flux distribution and CLI.

API promotions to GA
Git operations
Adopt Kubernetes server-side apply
- Rewrite the kustomize-controller reconciler using server-side apply
- Replace kubectl usage in Flux CLI with server-side apply (fluxcd/pkg/ssa)
- Preview local changes with server-side apply dry-run (flux diff kustomization)
Multi-tenancy lockdown
Conformance testing
- End-to-end testing for bootstrap on AMD64 and ARM64 clusters
- End-to-end testing for Flux self-upgrade
- End-to-end testing for multi-tenancy lockdown
Terraform Provider
Documentation
- Install and bootstrap guides for Kubernetes (Generic Git, GitHub, GitLab, BitBucket)
- Install and bootstrap guides for managed Kubernetes (AWS, Azure, Google Cloud)
- gitrepositories.source.toolkit.fluxcd.io API specification
- kustomizations.kustomize.toolkit.fluxcd.io API specification
Kustomize v5 support
- Update Flux controllers to Kustomize v5.0
- Update Kubernetes to 1.27.2

Flux Helm GA (Q1 2024)

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

The completion of this milestone will be marked by the v2.3.0 release of the Flux distribution and CLI.

API promotions to GA
- helmrepositories.source.toolkit.fluxcd.io/v1
- helmcharts.source.toolkit.fluxcd.io/v1
- helmreleases.helm.toolkit.fluxcd.io/v2
Reconcilers
CLI
- Cover more Helm release configuration options
Documentation
- helmrepositories.source.toolkit.fluxcd.io API specification
- helmcharts.source.toolkit.fluxcd.io API specification
- helmreleases.helm.toolkit.fluxcd.io API specification

Flux Notifications GA (TBA)

API promotions to GA
- alerts.notification.toolkit.fluxcd.io/v1
- providers.notification.toolkit.fluxcd.io/v1

This milestone’s tasks haven’t been determined yet.

Flux Image Automation GA (TBA)

API promotions to GA
- imagepolicies.image.toolkit.fluxcd.io/v1
- imageupdateautomations.image.toolkit.fluxcd.io/v1

This milestone’s tasks haven’t been determined yet.

Flux S3-compatible APIs GA (TBA)

API promotions to GA
- buckets.source.toolkit.fluxcd.io/v1

This milestone’s tasks haven’t been determined yet.

Flux OCI artifacts GA (TBA)

API promotions to GA
- ocirepositories.source.toolkit.fluxcd.io/v1

This milestone’s tasks haven’t been determined yet.

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 Define Flux tenancy models
RFC Passswordless authentication for Git repositories