diff --git a/README.md b/README.md index 8abca9069044262af1126184d14e73b96128a819..7141ba2549373b177f5487523609e5d11c56691d 100644 --- a/README.md +++ b/README.md @@ -5,8 +5,67 @@ [](https://github.com/fluxcd/toolkit/blob/master/LICENSE) [](https://github.com/fluxcd/toolkit/releases) -Experimental toolkit for assembling CD pipelines the GitOps way. -  -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 2cbbc9bd96bcd522b06391f13764269a9803bf47..95f06c740e787eea4a1918aeabdef16766307990 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.  diff --git a/docs/roadmap/index.md b/docs/roadmap/index.md index 43ab9f65935ff742e1be0bea93deed4a19e0d7ef..b09a414b46bec9b234a4923e41add983a3be1470 100644 --- a/docs/roadmap/index.md +++ b/docs/roadmap/index.md @@ -91,6 +91,6 @@ Tasks - [x] <span style="color:grey">Implement support for values from `Secret` and `ConfigMap` resources</span> - [x] <span style="color:grey">Implement conditional remediation on (failed) Helm actions</span> - [x] <span style="color:grey">Implement support for Helm charts from Git</span> -- [x] <span style="color:grey">Implement support for referring to an alternative chart values file</span>\ +- [x] <span style="color:grey">Implement support for referring to an alternative chart values file</span> - [ ] Stabilize API - [ ] Create a migration guide for Helm Operator users