flux-operator

What is flux-operator?

The Flux Operator is a Kubernetes CRD controller that manages the lifecycle of CNCF Flux CD and the ControlPlane enterprise distribution. It automates installation, configuration, and upgrades of Flux controllers via a declarative API, removing the operational burden of managing Flux across fleets of clusters.

How to use flux-operator?

Install the operator using Helm (or OperatorHub, kubectl) and create a FluxInstance resource in the flux-system namespace to deploy the Flux controllers. Use sync configuration to bootstrap cluster state from a Git repository, container registry, or S3-compatible storage.

Key features of flux-operator

• Automates Flux installation, configuration, and upgrades across clusters
• Enables self-service environments via the ResourceSet API
• Provides deep insights with reports and Prometheus metrics
• Integrates with Git pull requests for ephemeral preview environments
• Supports AI-assisted GitOps through the Flux MCP Server
• Simplifies multi-tenancy, sharding, scaling, and persistent storage

Use cases of flux-operator

• Automating Flux CD deployment across a fleet of Kubernetes clusters
• Creating ephemeral environments for pull request testing on GitHub, GitLab, Gitea, and Azure DevOps
• Managing time-based delivery windows for application rollouts
• Providing platform teams with a self-service catalog of standardized Kubernetes resources

FAQ from flux-operator

What dependencies or runtime does flux-operator require?

It runs on any Kubernetes cluster and is end-to-end tested on Red Hat OpenShift, Amazon EKS, Azure AKS, and Google GKE.

How do I install flux-operator?

You can install using Helm, OperatorHub, Terraform, or kubectl. Example: helm install flux-operator oci://ghcr.io/controlplaneio-fluxcd/charts/flux-operator --namespace flux-system.

Where does flux-operator store its data?

Configuration and state are stored in Kubernetes custom resources (FluxInstance, FluxReport, ResourceSet) within the cluster.

Can I preview changes before applying?

Yes, the operator supports ephemeral environments for GitHub pull requests, GitLab merge requests, and other Git providers.

What transport or authentication does flux-operator use?

It leverages standard Kubernetes API authentication and authorization. For private Git repos, you provide credentials via a Kubernetes secret referenced in the FluxInstance spec.