Joining the Flux community

We want the Flux project to be the vendor-neutral home for GitOps in a Cloud Native world.

Started in 2016 to automate deployments at Weaveworks, the project has taken on a new life since then. The Flux community has become the home for a family of projects, all solving a variety of specific GitOps needs.

We also want our community to be diverse, helpful, collaborative and a fun place to be, so we would love to have you join us!

Getting involved

Meetings

We run regular meetings and discuss things there.

The upcoming meetings, talks, and community events for the next month are here:

Our calendar data is hosted on the CNCF-Flux-Dev List, which has the option to subscribe: https://lists.cncf.io/g/cncf-flux-dev/calendar

We are very happy if new users, contributors and developers join and we can put names to faces!

Review how to subscribe to the Flux Calendar to add the Flux meetups on your own calendar.

We are looking forward to seeing you there.

Recordings

Check out the https://www.youtube.com/@fluxcd channel for recordings of Flux Dev Meetings and other Flux-related playlists.

Schedules

The recurring meetings and their schedules (in English) are listed below with their source time zones, and a link to any meeting “Minutes” docs.

Some regularly scheduled meetings are scheduled in their hosts’ local time zones.

Do note that Daylight Savings Time changes can vary across regions, which can cause some confusion.

The calendar at https://fluxcd.io/community#meetings has been localized to show the events in your local time zone.

Subscribing to the Flux calendar

To add the meetings to your e.g. Google calendar

1. visit the Flux calendar

   For this you might need to create an account for lists.cncf.io

2. click on “Subscribe to Calendar” at the very bottom of the page
3. copy the iCalendar URL
4. open e.g. your Google calendar
5. find the “add calendar” option
6. choose “add by URL”
7. paste iCalendar URL (ends with .ics)
8. done

Finding your interest

To get started, it’s important you find out which parts of Flux you are interested in first.

Maintained, with stable APIs:

And there is loads more under https://github.com/fluxcd, we all work on this as a community together.

Joining the community

All the projects have docs to help you get started, so a first step is obviously using the projects and getting some first-hand experience. Afterwards you can help out on Slack answering questions, maybe extend the docs or fix some small issues.

Teams

The Flux project uses GitHub org teams to make it easier for Project Members and above to communicate within and across teams. Members of those teams however should be defined in publicly accessible files for transparency to org non-members. See https://github.com/fluxcd/community/blob/main/community-roles.md.

The process of formalising team structures apart from “interest in one or more given sub-project(s)” is ongoing. There currently are:

• The core maintainers
• The Security team
• The Community team

All projects and teams are open to contributors and every part of the Flux project appreciates your help and consideration. Check out the links above to learn more about the team in question.

Communication

Here is a list of good entry points into our community. Here is how we stay in touch and how you can meet us as a team.

• Slack: Join in and talk to us in the #flux channel on CNCF Slack
• Meetings: We run weekly, public meetings - join one of the upcoming dev meetings, introduce yourself and get involved this way
• Join the Flux discussions on GitHub
• Mailing list: To be updated on Flux progress regularly, you might want to join the flux-dev mailing list as well
• Social media: Follow Flux on Twitter, join the discussion in the Flux LinkedIn group
• Blog: Stay up to date on the Flux blog
• Check out our guides on how to contribute to Flux
• And if you are completely new to the Flux project, take a look at our Get Started guide and give us feedback

Maintainers

Flux project maintainers may differ across Git repositories within the fluxcd GitHub org. The codebase itself is a multi-component design, spread across multiple Git repositories. Flux also includes non-code contributions, such as documentation and community information. Maintainers of each repo are listed in a MAINTAINERS file in the root of that repo.

See https://github.com/fluxcd/community/blob/main/project/flux-project-maintainers.yaml for an aggregated list of all maintainers from each of the project’s individual Git repos.

Rules

The Flux community is governed by the governance document, involvement is defined in https://github.com/fluxcd/community/blob/main/community-roles.md, and processes can be found in https://github.com/fluxcd/community/blob/main/PROCESS.md. We as a community follow the code of conduct.