From 346d8f7583005b3d51b391719a875073e9c421c6 Mon Sep 17 00:00:00 2001 From: Hidde Beydals Date: Tue, 15 Sep 2020 17:52:31 +0200 Subject: [PATCH] docs: add more content to the README.md --- README.md | 65 +++++++++++++++++++++++++++++++++++++++++-- docs/index.md | 6 ++-- docs/roadmap/index.md | 2 +- 3 files changed, 66 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 8abca906..7141ba25 100644 --- a/README.md +++ b/README.md @@ -5,8 +5,67 @@ [![license](https://img.shields.io/github/license/fluxcd/toolkit.svg)](https://github.com/fluxcd/toolkit/blob/master/LICENSE) [![release](https://img.shields.io/github/release/fluxcd/toolkit/all.svg)](https://github.com/fluxcd/toolkit/releases) -Experimental toolkit for assembling CD pipelines the GitOps way. - ![overview](docs/diagrams/gotk-feature.png) -To get started with the toolkit please read the [docs](https://toolkit.fluxcd.io/). +The GitOps Toolkit is a set of composable APIs and specialized tools +that can be used to build a Continuous Delivery platform on top of Kubernetes. + +These tools are build with Kubernetes controller-runtime libraries, and they +can be dynamically configured with Kubernetes custom resources either by +cluster admins or by other automated tools. +The GitOps Toolkit components interact with each other via Kubernetes +events and are responsible for the reconciliation of their designated API objects. + +## `gotk` installation + +With Homebrew: + +```sh +brew tap fluxcd/tap +brew install gotk +``` + +With Bash: + +```sh +curl -s https://toolkit.fluxcd.io/install.sh | sudo bash + +# enable completions in ~/.bash_profile +. <(gotk completion) +``` + +Binaries for macOS and Linux AMD64/ARM64 are available to download on the +[release page](https://github.com/fluxcd/toolkit/releases). + +Verify that your cluster satisfies the prerequisites with: + +```sh +gotk check --pre +``` + +## Get started + +To get started with the GitOps Toolkit, start [browsing the 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/) +- [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/) + +## Components + +- [Toolkit CLI](https://toolkit.fluxcd.io/cmd/gotk/) +- [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/) +- [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/) diff --git a/docs/index.md b/docs/index.md index 2cbbc9bd..95f06c74 100644 --- a/docs/index.md +++ b/docs/index.md @@ -3,17 +3,17 @@ The GitOps Toolkit is a set of composable APIs and specialized tools that can be used to build a Continuous Delivery platform on top of Kubernetes. -These tools are built with Kubernetes controller-runtime libraries and they +These tools are build with Kubernetes controller-runtime libraries, and they can be dynamically configured with Kubernetes custom resources either by cluster admins or by other automated tools. The GitOps Toolkit components interact with each other via Kubernetes -events and are responsible for the reconciliation of their designated API objects. +events and are responsible for the reconciliation of their designated API objects. !!! hint "Work in Progress" We envision a future where **Flux v2** and **Helm Operator v2** will be assembled from the GitOps Toolkit components. The Flux CD team is looking for feedback and help as the toolkit is in an active experimentation phase. - If you wish to take part in this quest please reach out to us on Slack and GitHub. + If you wish to take part in this quest please reach out to us on Slack or GitHub. ![overview](diagrams/gotk-feature.png) diff --git a/docs/roadmap/index.md b/docs/roadmap/index.md index 43ab9f65..b09a414b 100644 --- a/docs/roadmap/index.md +++ b/docs/roadmap/index.md @@ -91,6 +91,6 @@ Tasks - [x] Implement support for values from `Secret` and `ConfigMap` resources - [x] Implement conditional remediation on (failed) Helm actions - [x] Implement support for Helm charts from Git -- [x] Implement support for referring to an alternative chart values file\ +- [x] Implement support for referring to an alternative chart values file - [ ] Stabilize API - [ ] Create a migration guide for Helm Operator users