flux-operator

# flux-operator [](https://github.com/controlplaneio-fluxcd/flux-operator/releases) [](https://artifacthub.io/packages/helm/flux-operator/flux-operator) [](https://operatorhub.io/operator/flux-operator) [](https://github.com/controlplaneio-fluxcd/flux-operator/actions/workflows/e2e.yaml) [](https://github.com/controlplaneio-fluxcd/flux-operator/blob/main/LICENSE) [](https://fluxcd.control-plane.io/distribution/security/) The Flux Operator is a Kubernetes CRD controller that manages the lifecycle of CNCF [Flux CD](https://fluxcd.io) and the [ControlPlane enterprise distribution](https://github.com/controlplaneio-fluxcd/distribution). The operator extends Flux with self-service capabilities, deployment windows, and preview environments for GitHub, GitLab and Azure DevOps pull requests testing. --- <p align="center"> <a href="https://fluxoperator.dev"> <img src="docs/logo/flux-operator-banner.png" width="100%"> </a> </p> --- **Autopilot for Flux CD** - The operator offers an alternative to the Flux Bootstrap procedure, it removes the operational burden of managing Flux across fleets of clusters by fully automating the installation, configuration, and upgrade of the Flux controllers based on a declarative API. **Advanced Configuration** - The operator simplifies the configuration of Flux multi-tenancy lockdown, sharding, horizontal and vertical scaling, persistent storage, and allows fine-tuning the Flux controllers with Kustomize patches. The operator streamlines the transition from Git as the delivery mechanism for the cluster desired state to OCI artifacts and S3-compatible storage. **Deep Insights** - The operator provides deep insights into the delivery pipelines managed by Flux, including detailed reports and Prometheus metrics about the Flux controllers readiness status, reconcilers statistics, and cluster state synchronization. **Self-Service Environments** - The operator [ResourceSet API](https://fluxoperator.dev/docs/resourcesets/introduction/) enables platform teams to define their own application standard as a group of Flux and Kubernetes resources that can be templated, parameterized and deployed as a single unit on self-service environments. The ResourceSet API integrates with Git pull requests to create ephemeral environments for testing and validation. **AI-Assisted GitOps** - The [Flux MCP Server](https://fluxoperator.dev/mcp-server/) connects AI assistants to Kubernetes clusters running the operator, enabling seamless interaction through natural language. It serves as a bridge between AI tools and GitOps pipelines, allowing you to analyze deployment across environments, troubleshoot issues, and perform operations using conversational prompts. **Enterprise Support** - The operator is a key component of the ControlPlane [Enterprise offering](https://fluxcd.control-plane.io/pricing/), and is designed to automate the rollout of new Flux versions, CVE patches and hotfixes to production environments in a secure and reliable way. The operator is end-to-end tested along with the ControlPlane Flux distribution on Red Hat OpenShift, Amazon EKS, Azure AKS and Google GKE. ## Quickstart Guide ### Install the Flux Operator Install the Flux Operator in the `flux-system` namespace, for example using Helm: ```shell helm install flux-operator oci://ghcr.io/controlplaneio-fluxcd/charts/flux-operator \ --namespace flux-system ``` > [!NOTE] > The Flux Operator can be installed using Helm, Terraform, OperatorHub, kubectl and other methods. > For more information, refer to the > [installation guide](https://fluxoperator.dev/docs/guides/install/). ### Install the Flux Controllers Create a [FluxInstance](https://fluxoperator.dev/docs/crd/fluxinstance/) resource named `flux` in the `flux-system` namespace to install the latest Flux stable version: ```yaml apiVersion: fluxcd.controlplane.io/v1 kind: FluxInstance metadata: name: flux namespace: flux-system annotations: fluxcd.controlplane.io/reconcileEvery: "1h" fluxcd.controlplane.io/reconcileArtifactEvery: "10m" fluxcd.controlplane.io/reconcileTimeout: "5m" spec: distribution: version: "2.x" registry: "ghcr.io/fluxcd" artifact: "oci://ghcr.io/controlplaneio-fluxcd/flux-operator-manifests" components: - source-controller - kustomize-controller - helm-controller - notification-controller - image-reflector-controller - image-automation-controller cluster: type: kuberne