Minimal rewrite of README to explain Flux v2

- Adjust the description so it talks about the whole system (Flux) as
   one thing

 - Describe what GitOps Toolkit is, and how it relates to Flux v2.

Signed-off-by: Michael Bridgen <michael@weave.works>
pull/385/head
Michael Bridgen 4 years ago committed by Stefan Prodan
parent 49ffc972f8
commit de944d0095
No known key found for this signature in database
GPG Key ID: 3299AEB0E4085BAF

@ -1,4 +1,4 @@
# GitOps Toolkit # Flux version 2
[![e2e](https://github.com/fluxcd/toolkit/workflows/e2e/badge.svg)](https://github.com/fluxcd/toolkit/actions) [![e2e](https://github.com/fluxcd/toolkit/workflows/e2e/badge.svg)](https://github.com/fluxcd/toolkit/actions)
[![report](https://goreportcard.com/badge/github.com/fluxcd/toolkit)](https://goreportcard.com/report/github.com/fluxcd/toolkit) [![report](https://goreportcard.com/badge/github.com/fluxcd/toolkit)](https://goreportcard.com/report/github.com/fluxcd/toolkit)
@ -6,14 +6,19 @@
[![release](https://img.shields.io/github/release/fluxcd/toolkit/all.svg)](https://github.com/fluxcd/toolkit/releases) [![release](https://img.shields.io/github/release/fluxcd/toolkit/all.svg)](https://github.com/fluxcd/toolkit/releases)
![overview](docs/diagrams/gitops-toolkit.png) ![overview](docs/diagrams/gitops-toolkit.png)
The GitOps Toolkit is a set of composable APIs and specialized tools Flux is a tool for keeping Kubernetes clusters in sync with sources of
that can be used to build a Continuous Delivery platform on top of Kubernetes. configuration (like Git repositories), and automating updates to
configuration when there is new code to deploy.
These tools are build with Kubernetes controller-runtime libraries, and they Flux version 2 ("v2") is built from the ground up to use Kubernetes'
can be dynamically configured with Kubernetes custom resources either by API extension system, and to integrate with Prometheus and other core
cluster admins or by other automated tools. components of the Kubernetes ecosystem. In version 2, Flux supports
The GitOps Toolkit components interact with each other via Kubernetes multi-tenancy and support for syncing an arbitrary number of Git
events and are responsible for the reconciliation of their designated API objects. 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.
## `gotk` installation ## `gotk` installation
@ -44,8 +49,9 @@ gotk check --pre
## Get started ## Get started
To get started with the GitOps Toolkit, start [browsing the documentation](https://toolkit.fluxcd.io) To get started with Flux, start [browsing the
or get started with one of the following guides: documentation](https://toolkit.fluxcd.io) or get started with one of
the following guides:
- [Get started with GitOps Toolkit (deep dive)](https://toolkit.fluxcd.io/get-started/) - [Get started with GitOps Toolkit (deep dive)](https://toolkit.fluxcd.io/get-started/)
- [Installation](https://toolkit.fluxcd.io/guides/installation/) - [Installation](https://toolkit.fluxcd.io/guides/installation/)
@ -53,7 +59,18 @@ or get started with one of the following guides:
- [Setup Notifications](https://toolkit.fluxcd.io/guides/notifications/) - [Setup Notifications](https://toolkit.fluxcd.io/guides/notifications/)
- [Setup Webhook Receivers](https://toolkit.fluxcd.io/guides/webhook-receivers/) - [Setup Webhook Receivers](https://toolkit.fluxcd.io/guides/webhook-receivers/)
## Components ## 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/).
### Components
- [Toolkit CLI](https://toolkit.fluxcd.io/cmd/gotk/) - [Toolkit CLI](https://toolkit.fluxcd.io/cmd/gotk/)
- [Source Controller](https://toolkit.fluxcd.io/components/source/controller/) - [Source Controller](https://toolkit.fluxcd.io/components/source/controller/)

Loading…
Cancel
Save