mirror of https://github.com/fluxcd/flux2.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
115 lines
5.1 KiB
Markdown
115 lines
5.1 KiB
Markdown
# Flux version 2
|
|
|
|
[](https://github.com/fluxcd/flux2/actions)
|
|
[](https://goreportcard.com/report/github.com/fluxcd/flux2)
|
|
[](https://github.com/fluxcd/flux2/blob/main/LICENSE)
|
|
[](https://github.com/fluxcd/flux2/releases)
|
|
|
|
Flux is a tool 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.
|
|
|
|
Flux version 2 ("v2") is built from the ground up to use Kubernetes'
|
|
API extension system, and to integrate with Prometheus and other core
|
|
components of the Kubernetes ecosystem. In version 2, Flux supports
|
|
multi-tenancy and support for syncing an arbitrary number of Git
|
|
repositories, among other long-requested features.
|
|
|
|
Flux v2 is constructed with the [GitOps Toolkit](#gitops-toolkit), a
|
|
set of composable APIs and specialized tools for building Continuous
|
|
Delivery on top of Kubernetes.
|
|
|
|
## Flux installation
|
|
|
|
With Homebrew:
|
|
|
|
```sh
|
|
brew install fluxcd/tap/flux
|
|
```
|
|
|
|
With Bash:
|
|
|
|
```sh
|
|
curl -s https://toolkit.fluxcd.io/install.sh | sudo bash
|
|
|
|
# enable completions in ~/.bash_profile
|
|
. <(flux completion bash)
|
|
```
|
|
|
|
Arch Linux (AUR) packages:
|
|
|
|
- [flux-bin](https://aur.archlinux.org/packages/flux-bin): install the latest
|
|
stable version using a pre-build binary (recommended)
|
|
- [flux-go](https://aur.archlinux.org/packages/flux-go): build the latest
|
|
stable version from source code
|
|
- [flux-scm](https://aur.archlinux.org/packages/flux-scm): build the latest
|
|
(unstable) version from source code from our git `main` branch
|
|
|
|
Binaries for macOS, Windows and Linux AMD64/ARM are available to download on the
|
|
[release page](https://github.com/fluxcd/flux2/releases).
|
|
|
|
Verify that your cluster satisfies the prerequisites with:
|
|
|
|
```sh
|
|
flux check --pre
|
|
```
|
|
|
|
## Get started
|
|
|
|
To get started with Flux, start [browsing the
|
|
documentation](https://toolkit.fluxcd.io) or get started with one of
|
|
the following guides:
|
|
|
|
- [Get started with Flux (deep dive)](https://toolkit.fluxcd.io/get-started/)
|
|
- [Installation](https://toolkit.fluxcd.io/guides/installation/)
|
|
- [Manage Helm Releases](https://toolkit.fluxcd.io/guides/helmreleases/)
|
|
- [Setup Notifications](https://toolkit.fluxcd.io/guides/notifications/)
|
|
- [Setup Webhook Receivers](https://toolkit.fluxcd.io/guides/webhook-receivers/)
|
|
|
|
## GitOps Toolkit
|
|
|
|
The GitOps Toolkit is the set of APIs and controllers that make up the
|
|
runtime for Flux v2. The APIs comprise Kubernetes custom resources,
|
|
which can be created and updated by a cluster user, or by other
|
|
automation tooling.
|
|
|
|
|
|
|
|
You can use the toolkit to extend Flux, or to build your own systems
|
|
for continuous delivery -- see [the developer
|
|
guides](https://toolkit.fluxcd.io/dev-guides/source-watcher/).
|
|
|
|
### Components
|
|
|
|
- [Source Controller](https://toolkit.fluxcd.io/components/source/controller/)
|
|
- [GitRepository CRD](https://toolkit.fluxcd.io/components/source/gitrepositories/)
|
|
- [HelmRepository CRD](https://toolkit.fluxcd.io/components/source/helmrepositories/)
|
|
- [HelmChart CRD](https://toolkit.fluxcd.io/components/source/helmcharts/)
|
|
- [Bucket CRD](https://toolkit.fluxcd.io/components/source/buckets/)
|
|
- [Kustomize Controller](https://toolkit.fluxcd.io/components/kustomize/controller/)
|
|
- [Kustomization CRD](https://toolkit.fluxcd.io/components/kustomize/kustomization/)
|
|
- [Helm Controller](https://toolkit.fluxcd.io/components/helm/controller/)
|
|
- [HelmRelease CRD](https://toolkit.fluxcd.io/components/helm/helmreleases/)
|
|
- [Notification Controller](https://toolkit.fluxcd.io/components/notification/controller/)
|
|
- [Provider CRD](https://toolkit.fluxcd.io/components/notification/provider/)
|
|
- [Alert CRD](https://toolkit.fluxcd.io/components/notification/alert/)
|
|
- [Receiver CRD](https://toolkit.fluxcd.io/components/notification/receiver/)
|
|
|
|
## Community
|
|
|
|
The Flux project is always looking for new contributors and there are a multitude of ways to get involved.
|
|
Depending on what you want to do, some of the following bits might be your first steps:
|
|
|
|
- Join our upcoming dev meetings ([meeting access and agenda](https://docs.google.com/document/d/1l_M0om0qUEN_NNiGgpqJ2tvsF2iioHkaARDeh6b70B0/view))
|
|
- Talk to us in the #flux channel on [CNCF Slack](https://slack.cncf.io/)
|
|
- Ask questions and propose features on our [GH Discussions page](https://github.com/fluxcd/flux2/discussions)
|
|
- And if you are completely new to Flux and the GitOps Toolkit, take a look at our [Get Started guide](https://toolkit.fluxcd.io/get-started/) and give us feedback
|
|
- To be part of the conversation about Flux's development, [join the flux-dev mailing list](https://lists.cncf.io/g/cncf-flux-dev).
|
|
- Check out [how to contribute](CONTRIBUTING.md) to the project
|
|
|
|
### Events
|
|
|
|
Check out our **[events calendar](https://fluxcd.io/community/#talks)**, both with upcoming talks you can attend or past events videos you can watch.
|
|
|
|
We look forward to seeing you with us!
|