flux

Bootstrap Flux on a Kubernetes cluster with GitHub

$ flux bootstrap github --owner=[username] --repository=[repo] --path=[clusters/my-cluster]

$ flux check --pre

$ flux check

$ flux get all

$ flux reconcile kustomization [name]

$ flux suspend kustomization [name]

$ flux resume kustomization [name]

$ flux export source git --all

flux [COMMAND] [FLAGS]

Flux is a GitOps continuous delivery tool for Kubernetes. It automatically synchronizes cluster state with configuration stored in Git repositories, ensuring that the live cluster matches the desired state defined in version control.
Flux monitors Git repositories, Helm repositories, and OCI registries for changes. When updates are detected, it applies them to the cluster automatically. This enables declarative, auditable infrastructure management following GitOps principles.
The flux CLI bootstraps Flux components into a cluster and provides management commands for sources, kustomizations, and Helm releases. Flux uses Kubernetes custom resources to define what to sync and how.

--kubeconfig FILE

Path to kubeconfig file.

Namespace for CLI operations (default: flux-system).

Kubernetes context to use.

Timeout for operations.

Enable verbose output.

Display help for command.

bootstrap PROVIDER

Deploy Flux on a cluster the GitOps way (github, gitlab, bitbucket).

Check prerequisites and component status.

Install Flux components without GitOps bootstrap.

Uninstall Flux components from cluster.

Get status of Flux resources (sources, kustomizations, helmreleases).

Trigger reconciliation of a resource.

Suspend reconciliation of a resource.

Resume reconciliation of a resource.

Export resources to YAML manifests.

Create Flux resources.

Delete Flux resources.

Display logs from Flux controllers.

Requires kubectl configured with cluster access. Bootstrap creates resources in the flux-system namespace by default. Git repository access requires appropriate credentials or SSH keys. Flux components run as controllers in the cluster and require sufficient RBAC permissions.

Flux was originally created by Weaveworks in 2016 as one of the first GitOps tools for Kubernetes. Flux v2 was released in 2020 as a complete rewrite using the GitOps Toolkit, providing a more modular and extensible architecture. Flux became a CNCF Graduated project in 2022, reflecting its maturity and wide adoption in the cloud-native ecosystem.

kubectl(1), helm(1), kustomize(1), argocd(1)