Flux - the GitOps family of projects

Flux is a set of continuous and progressive delivery solutions for Kubernetes that are open and extensible.

The latest version of Flux brings many new features, making it more flexible and versatile.

Flux is a CNCF Incubating project.

Get started
Terminal
              
            

Flux in short

🤝
Flux provides GitOps for both apps and infrastructure
Flux and Flagger deploy apps with canaries, feature flags, and A/B rollouts. Flux can also manage any Kubernetes resource. Infrastructure and workload dependency management is built in.
🤖
Just push to Git and Flux does the rest
Flux enables application deployment (CD) and (with the help of Flagger) progressive delivery (PD) through automatic reconciliation. Flux can even push back to Git for you with automated container image updates to Git (image scanning and patching).
🔩
Flux works with your existing tools
Flux works with your Git providers (GitHub, GitLab, Bitbucket, can even use s3-compatible buckets as a source), all major container registries, and all CI workflow providers.
☸️
Flux works with any Kubernetes and all common Kubernetes tooling
Kustomize, Helm, RBAC, and policy-driven validation (OPA, Kyverno, admission controllers) so it simply falls into place.
🤹
Flux does Multi-Tenancy (and “Multi-everything”)
Flux uses true Kubernetes RBAC via impersonation and supports multiple Git repositories. Multi-cluster infrastructure and apps work out of the box with Cluster API: Flux can use one Kubernetes cluster to manage apps in either the same or other clusters, spin up additional clusters themselves, and manage clusters including lifecycle and fleets.
📞
Flux alerts and notifies
Flux provides health assessments, alerting to external systems, and external events handling. Just “git push”, and get notified on Slack and other chat systems.
👍
Users trust Flux
Flux is a CNCF Incubating project and was categorised as "Adopt" on the CNCF CI/CD Tech Radar (alongside Helm).
💖
Flux has a lovely community that is very easy to work with!
We welcome contributors of any kind. The components of Flux are on Kubernetes core controller-runtime, so anyone can contribute and its functionality can be extended very easily.

Adopted by

bimspot HMCTS 99 Group identinet NetHunt Weave Cloud happn Bink sngular TietoEVRY Yad2 VNClagoon Trendhim HybridK8s Cloudogu GmbH Liggo BlueStone AG D2iQ Luminovo Nexxiot Crayon Sage AI Labs Bedag Informatik AG Xenit blackmirror media 23 Technologies GmbH SAP SE Virginia Tech particule. Mettle FourteenFish Cybrary AdoreMe DKB Codefactory Canva MacPaw SoulCycle Quivr iits-consulting Sortlist Omaze Alea William & Mary

Flux is a collection of tools for keeping Kubernetes clusters in sync with sources of configuration (like Git repositories), and automating updates to configuration when there is new code to deploy.

Declarative

Describe the entire desired state of your system in Git. This includes apps, configuration, dashboards, monitoring, and everything else.

Automated

Use YAML to enforce conformance to the declared system. You don’t need to run kubectl because all changes are synced automatically.

Auditable

Everything is controlled through pull requests. Your Git history provides a sequence of transactions, allowing you to recover state from any snapshot.

Designed for Kubernetes

Declaratively configurable using Custom Resources, state reports in the object’s status and via Kubernetes Events, and integrations with Kubernetes RBAC

Out-of-the-box integrations

Support for e.g. Kustomize, Helm; GitHub, GitLab, Harbor and custom webhooks; notifications to most team communication platforms; and many more.

Extensible

Easily create a continuous delivery solution with only the components you need, or use the GitOps Toolkit to extend Flux.

Some of the biggest organisations have adopted the Flux family of projects for their GitOps needs.

See who is part of our community and how about joining yourself?

The Flux project aspires to be the vendor-neutral home for GitOps in a Cloud Native world. What we achieved up until today is only possible because of our community.

GitHub Discussions

Join the conversation in GitHub Discussions. Everything Flux related ranging from specifications and feature planning to Show & Tell happens here.

Slack

If you want to talk to the Flux team and community in real-time, join us on Slack. This is a great way to get to know everyone. Get a Slack invite, or go to the #flux channel.

Mailing list

Join our (low-traffic) mailing list to stay up to day on announcements and sporadic discussions.

Our Team Calendar

The upcoming meetings, talks and community events in the next month are listed below. (All times are UTC.)

  • 2022-01-26
    13:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308
  • 2022-01-27
    15:00
    CNCF Flux Project Meeting (late)
    Meeting agenda, minutes and videos: here
    Meeting ID: 438 118 8348 One tap mobile +19292056099,,4381188348# US (New York) +13017158592,,4381188348# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) 877 853 5247 US Toll-free 888 788 0099 US Toll-free Meeting ID: 438 118 8348 Find your local number: here
  • 2022-01-27
    18:00
    GitOps & Flux: A Refresher with Priyanka Ravi
    GitOps & Flux: A Refresher with Priyanka Ravi 10:00 - 11:00 PT / 18:00 - 19:00 GMT Speaker: Priyanka Ravi, Developer Experience Engineer, Weaveworks --------------------------------------- Please register in advance: here
    To join, download the zoom client ( here
    ) and join meeting ID 879 6948 7526 --------------------------------------- Priyanka “Pinky” Ravi, Developer Experience Engineer at Weaveworks, kicks off this new refresher series by going back to the basics. Pinky will walk us through a high-level view of GitOps and Flux, a CNCF Incubating project (on its way to graduation), where it fits into the CloudNative landscape, who it's for, the core concepts and components, and the true power it brings to automating and securing your delivery pipeline to give you increased reliability and velocity. Resources: ⭐️ Flux - the GitOps family of projects: fluxcd.io ( here
    ) ⭐️ Flux Docs: here
    ⭐️ Flux GitHub Repo: here
    ⭐️ Flux on CNCF Slack: here
    (or get an invite here: here
    ) Speaker Bio: Priyanka is a Developer Experience Engineer at Weaveworks. She has worked on a multitude of topics including front end development, UI automation for testing and API development. Previously she was a software developer at State Farm where she was on the delivery engineering team working on GitOps enablement. She was instrumental in the multi-tenancy migration to utilize Flux for an internal Kubernetes offering. Outside of work, Priyanka enjoys hanging out with her husband and two rescue dogs as well as traveling around the globe. --------------------------------------- Please register in advance: here
    To join, download the zoom client ( here
    ) and join meeting ID 879 6948 7526
  • 2022-02-02
    12:00
    CNCF Flux Project Meeting (early)
    Meeting agenda, minutes and videos: here
    Join Zoom Meeting here
    Meeting ID: 438 118 8348 One tap mobile +19292056099,,4381188348# US (New York) +13017158592,,4381188348# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) 877 853 5247 US Toll-free 888 788 0099 US Toll-free Meeting ID: 438 118 8348 Find your local number: here
  • 2022-02-02
    18:00
    Get Started with Flux - Priyanka Ravi
    Get Started with Flux - Priyanka Ravi 10:00 - 11:00 PT / 18:00 - 19:00 GMT Speaker: Priyanka Ravi, Developer Experience Engineer, Weaveworks --------------------------------------- Please register in advance: here
    To join, download the zoom client ( here
    ) and join meeting ID 893 9402 0236 --------------------------------------- Priyanka “Pinky” Ravi, Developer Experience Engineer at Weaveworks, shows you how to bootstrap Flux to a Kubernetes cluster and deploy a sample application in a GitOps manner. By the end of this session Pinky will have bootstrapped Flux on a Kubernetes Cluster, deployed a sample application using Flux, and customized application configuration through Kustomize patches. Resources: ⭐️ Flux - the GitOps family of projects: fluxcd.io ( here
    ) ⭐️ Get Started with Flux Guide: here
    ⭐️ Flux GitHub Repo: here
    ⭐️ Flux on CNCF Slack: here
    (or get an invite here: here
    ) Speaker Bio: Priyanka is a Developer Experience Engineer at Weaveworks. She has worked on a multitude of topics including front end development, UI automation for testing and API development. Previously she was a software developer at State Farm where she was on the delivery engineering team working on GitOps enablement. She was instrumental in the multi-tenancy migration to utilize Flux for an internal Kubernetes offering. Outside of work, Priyanka enjoys hanging out with her husband and two rescue dogs as well as traveling around the globe. --------------------------------------- Please register in advance: here
    To join, download the zoom client ( here
    ) and join meeting ID 893 9402 0236
  • 2022-02-03
    18:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308
  • 2022-02-09
    13:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308
  • 2022-02-10
    15:00
    CNCF Flux Project Meeting (late)
    Meeting agenda, minutes and videos: here
    Meeting ID: 438 118 8348 One tap mobile +19292056099,,4381188348# US (New York) +13017158592,,4381188348# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) 877 853 5247 US Toll-free 888 788 0099 US Toll-free Meeting ID: 438 118 8348 Find your local number: here
  • 2022-02-16
    12:00
    CNCF Flux Project Meeting (early)
    Meeting agenda, minutes and videos: here
    Join Zoom Meeting here
    Meeting ID: 438 118 8348 One tap mobile +19292056099,,4381188348# US (New York) +13017158592,,4381188348# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) 877 853 5247 US Toll-free 888 788 0099 US Toll-free Meeting ID: 438 118 8348 Find your local number: here
  • 2022-02-17
    18:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308
  • 2022-02-23
    13:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308
  • 2022-02-24
    15:00
    CNCF Flux Project Meeting (late)
    Meeting agenda, minutes and videos: here
    Meeting ID: 438 118 8348 One tap mobile +19292056099,,4381188348# US (New York) +13017158592,,4381188348# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) 877 853 5247 US Toll-free 888 788 0099 US Toll-free Meeting ID: 438 118 8348 Find your local number: here

See this page for more detail and subscription options.

If you are new to Flux, you might want to check out some of the following resources to get started.

Find more on our dedicated resources page.

The Power of GitOps with Flux Playlist

This playlist is designed to show the powerful GitOps capabilities of Flux (and the GitOps Toolkit). Videos include project overviews, reviews, technical demos, and walk-throughs of our guides.

Flux Deep Dive with Stefan Prodan

Stefan walks through what Flux is, who it’s for and its components. Then gives a demo on how to use Flux for delivering infrastructure and applications changes onto Kubernetes.

From Wild West to Flux Multi-tenancy with Mae Large & Russ Parmer

Mae and Russ share how the State Farm GitOps team helped to simplify application deployment while meeting compliance requirements, enable the admin team to handle scale and embrace the declarative nature of Kubernetes.

Flux’s Catalog - Keeping Track of Things! with Leigh Capili

Leigh Capili gives us a black belt, under-the-covers look at how Flux’s kustomize-controller tracks the child objects for a Kustomization in the Kubernetes API.

Handling Dependencies with Flux with Jason Morgan

Jason walks through how to use Flux’s dependency manager to ensure that your apps get added to your mesh every time.

Flux v2 Deep Dive series with Geert Baeke

In this 5 video series, Geert Baeke takes a deep dive of Flux v2 and the use of GitOps principles with an Intro to Flux v2, Intro to Kustomize, Deploying Manifests, Monitoring & Alerting, and Helm Basics.

GitOps Toolkit

The set of APIs and controllers that make up the runtime for Flux. You can use the GitOps Toolkit to extend Flux, and to build your own systems for continuous delivery.

GitOps Toolkit

Flagger

Kubernetes Operator for the automation of promoting canary deployments using Istio, Linkerd, App Mesh, NGINX, Skipper, Contour, Gloo or Traefik routing for traffic shifting, and Prometheus metrics for canary analysis.

The canary analysis can be extended with webhooks for running system integration/acceptance tests, load tests, or any other custom validation.

Flagger

Flux v1 and Helm Operator

We owe our success and good reputation as GitOps project to Flux and Helm Operator. They are the v1 iteration of our project and currently in maintenance mode.

We strongly advise everyone to familiarise themselves with the latest version of Flux and start the process of migrating.

Flux v1 and Helm Operator