From 186c7d5786e14c2ad4e1aeebb4b644f2ff215e95 Mon Sep 17 00:00:00 2001 From: stefanprodan Date: Thu, 18 Jun 2020 20:10:18 +0300 Subject: [PATCH 1/9] Publish mkdocs to gh-pages --- .github/workflows/docs.yaml | 18 +++++++++++++ docs/_files/flux-icon.svg | 22 +++++++++++++++ docs/_files/flux-icon@2x.png | Bin 0 -> 6764 bytes docs/_static/custom.css | 24 +++++++++++++++++ docs/index.md | 5 ++++ mkdocs.yml | 50 +++++++++++++++++++++++++++++++++++ 6 files changed, 119 insertions(+) create mode 100644 .github/workflows/docs.yaml create mode 100644 docs/_files/flux-icon.svg create mode 100644 docs/_files/flux-icon@2x.png create mode 100644 docs/_static/custom.css create mode 100644 docs/index.md create mode 100644 mkdocs.yml diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml new file mode 100644 index 00000000..93abce6e --- /dev/null +++ b/.github/workflows/docs.yaml @@ -0,0 +1,18 @@ +name: Publish docs via GitHub Pages +on: + push: + branches: + - docs* + +jobs: + build: + name: Deploy docs + runs-on: ubuntu-latest + steps: + - name: Checkout master + uses: actions/checkout@v1 + + - name: Deploy docs + uses: mhausenblas/mkdocs-deploy-gh-pages@master + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/docs/_files/flux-icon.svg b/docs/_files/flux-icon.svg new file mode 100644 index 00000000..36ad500e --- /dev/null +++ b/docs/_files/flux-icon.svg @@ -0,0 +1,22 @@ + + + + flux-icon + Created with Sketch. + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/_files/flux-icon@2x.png b/docs/_files/flux-icon@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..c6293d3013a1adfe8deacabc6544782f22564929 GIT binary patch literal 6764 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 O0000 Date: Thu, 18 Jun 2020 21:12:41 +0300 Subject: [PATCH 2/9] Add get started guide --- docs/get-started/index.md | 197 ++++++++++++++++++++++++++++++++++++++ mkdocs.yml | 4 +- 2 files changed, 199 insertions(+), 2 deletions(-) create mode 100644 docs/get-started/index.md diff --git a/docs/get-started/index.md b/docs/get-started/index.md new file mode 100644 index 00000000..d135bb80 --- /dev/null +++ b/docs/get-started/index.md @@ -0,0 +1,197 @@ +# Get started with GitOps Toolkit + +## Prerequisites + +* Kubernetes >= 1.14 +* kubectl >= 1.18 +* git + +You will need to have Kubernetes set up. +For a quick local test, you can use `minikube`, `kubeadm` or `kind`. +Any other Kubernetes setup will work as well though. + +In order to follow the guide you'll need a GitHub account and a +[personal access token](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line) +that can create repositories. + +## Install the toolkit CLI + +To install the latest `tk` release run: + +```bash +curl -s https://raw.githubusercontent.com/fluxcd/toolkit/master/install/tk.sh | sudo bash +``` + +The install script downloads the tk binary to `/usr/local/bin`. + +Binaries for macOS and Linux AMD64 are available for download on the +[release page](https://github.com/fluxcd/toolkit/releases). + +To configure your shell to load tk completions add to your bash profile: + +```sh +# ~/.bashrc or ~/.bash_profile +. <(tk completion) +``` + +## Bootstrap + +Export your GitHub personal access token with: + +```sh +export GITHUB_TOKEN= +``` + +The bootstrap command creates a GitHub repository if one doesn't exist and +commits the toolkit components manifests to the master branch. +Then it configures the target cluster to synchronize with the repository. +If the toolkit components are present on the cluster, +the bootstrap command will perform an upgrade if needed. + +```sh +tk bootstrap github --owner= --repository= --personal +``` + +If you wish to create the repository under a GitHub organization: + +```sh +tk bootstrap github \ + --owner= \ + --repository= \ + --team= \ + --team= \ + --version=v0.0.1-beta.2 +``` + +Example output: + +```text +$ tk bootstrap github --owner=gitopsrun --repository=fleet-infra --path=dev-cluster --team=devs + +► connecting to github.com +✔ repository created +✔ devs team access granted +✔ repository cloned +✚ generating manifests +✔ components manifests pushed +► installing components in gitops-system namespace +namespace/gitops-system created +customresourcedefinition.apiextensions.k8s.io/gitrepositories.source.fluxcd.io created +customresourcedefinition.apiextensions.k8s.io/helmcharts.source.fluxcd.io created +customresourcedefinition.apiextensions.k8s.io/helmrepositories.source.fluxcd.io created +customresourcedefinition.apiextensions.k8s.io/kustomizations.kustomize.fluxcd.io created +customresourcedefinition.apiextensions.k8s.io/profiles.kustomize.fluxcd.io created +role.rbac.authorization.k8s.io/crd-controller-gitops-system created +rolebinding.rbac.authorization.k8s.io/crd-controller-gitops-system created +clusterrolebinding.rbac.authorization.k8s.io/cluster-reconciler-gitops-system created +service/source-controller created +deployment.apps/kustomize-controller created +deployment.apps/source-controller created +networkpolicy.networking.k8s.io/deny-ingress created +Waiting for deployment "source-controller" rollout to finish: 0 of 1 updated replicas are available... +deployment "source-controller" successfully rolled out +deployment "kustomize-controller" successfully rolled out +✔ install completed +► configuring deploy key +✔ deploy key configured +► generating sync manifests +✔ sync manifests pushed +► applying sync manifests +◎ waiting for cluster sync +✔ bootstrap finished +``` + +If you prefer GitLab, export `GITLAB_TOKEN` env var and use the command `tk bootstrap gitlab`. + +## Create a GitOps workflow + +Clone the repository with: + +```sh +git clone https://github.com/gitopsrun/fleet-infra +cd fleet-infra +``` + +Create a git source pointing to a public repository: + +```sh +tk create source git webapp \ + --url=https://github.com/stefanprodan/podinfo \ + --branch=master \ + --interval=30s \ + --export > ./dev-cluster/webapp-source.yaml +``` + +Create a kustomization for synchronizing the common manifests on the cluster: + +```sh +tk create kustomization webapp-common \ + --source=webapp \ + --path="./deploy/webapp/common" \ + --prune=true \ + --validate=client \ + --interval=1h \ + --export > ./dev-cluster/webapp-common.yaml +``` + +Create a kustomization for the backend service that depends on common: + +```sh +tk create kustomization webapp-backend \ + --depends-on=webapp-common \ + --source=webapp \ + --path="./deploy/webapp/backend" \ + --prune=true \ + --validate=client \ + --interval=10m \ + --health-check="Deployment/backend.webapp" \ + --health-check-timeout=2m \ + --export > ./dev-cluster/webapp-backend.yaml +``` + +Create a kustomization for the frontend service that depends on backend: + +```sh +tk create kustomization webapp-frontend \ + --depends-on=webapp-backend \ + --source=webapp \ + --path="./deploy/webapp/frontend" \ + --prune=true \ + --validate=client \ + --interval=10m \ + --health-check="Deployment/frontend.webapp" \ + --health-check-timeout=2m \ + --export > ./dev-cluster/webapp-frontend.yaml +``` + +Push changes to origin: + +```sh +git add -A && git commit -m "add webapp" && git push +``` + +In about 30s the synchronization should start: + +```text +$ watch tk get kustomizations + +✔ gitops-system last applied revision master/35d5765a1acb9e9ce66cad7274c6fe03eee1e8eb +✔ webapp-backend reconciling +✔ webapp-common last applied revision master/f43f9b2eb6766e07f318d266a99d2ec7c940b0cf +✗ webapp-frontend dependency 'gitops-system/webapp-backend' is not ready +``` + +When the synchronization finishes you can check that the webapp services are running: + +```text +$ kubectl -n webapp get deployments,services + +NAME READY UP-TO-DATE AVAILABLE AGE +deployment.apps/backend 1/1 1 1 4m1s +deployment.apps/frontend 1/1 1 1 3m31s + +NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE +service/backend ClusterIP 10.52.10.22 9898/TCP,9999/TCP 4m1s +service/frontend ClusterIP 10.52.9.85 80/TCP 3m31s +``` + diff --git a/mkdocs.yml b/mkdocs.yml index cc77673e..4da63169 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -35,8 +35,8 @@ markdown_extensions: - pymdownx.tabbed nav: - - Introduction: introduction.md - - CLI: + - Get Started: get-started/index.md + - tk CLI: - Bootstrap: cmd/tk_bootstrap.md - Check: cmd/tk_check.md - Create: cmd/tk_create.md From 5074ff2889feb6215051bc4a0cc8f24202a77454 Mon Sep 17 00:00:00 2001 From: stefanprodan Date: Fri, 19 Jun 2020 14:31:23 +0300 Subject: [PATCH 3/9] Add install script to website --- .github/workflows/docs.yaml | 4 +++- docs/get-started/index.md | 10 +++++++--- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index 93abce6e..3e71f0a0 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -11,7 +11,9 @@ jobs: steps: - name: Checkout master uses: actions/checkout@v1 - + - name: Copy assets + run: | + cp install/tk.sh docs/install.sh - name: Deploy docs uses: mhausenblas/mkdocs-deploy-gh-pages@master env: diff --git a/docs/get-started/index.md b/docs/get-started/index.md index d135bb80..f3b40cb4 100644 --- a/docs/get-started/index.md +++ b/docs/get-started/index.md @@ -19,7 +19,7 @@ that can create repositories. To install the latest `tk` release run: ```bash -curl -s https://raw.githubusercontent.com/fluxcd/toolkit/master/install/tk.sh | sudo bash +curl -s https:/fluxcd.github.io/toolkit/install.sh | sudo bash ``` The install script downloads the tk binary to `/usr/local/bin`. @@ -49,7 +49,11 @@ If the toolkit components are present on the cluster, the bootstrap command will perform an upgrade if needed. ```sh -tk bootstrap github --owner= --repository= --personal +tk bootstrap github \ + --owner= \ + --repository= \ + --path=dev-cluster \ + --personal ``` If you wish to create the repository under a GitHub organization: @@ -60,7 +64,7 @@ tk bootstrap github \ --repository= \ --team= \ --team= \ - --version=v0.0.1-beta.2 + --path=dev-cluster ``` Example output: From 45003436bf57492bf07082ae67d4ec11b0d22718 Mon Sep 17 00:00:00 2001 From: stefanprodan Date: Fri, 19 Jun 2020 16:07:29 +0300 Subject: [PATCH 4/9] Publish docs website on toolkit.fluxcd.io --- .github/workflows/docs.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index 3e71f0a0..aaf01d84 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -18,3 +18,4 @@ jobs: uses: mhausenblas/mkdocs-deploy-gh-pages@master env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + CUSTOM_DOMAIN: toolkit.fluxcd.io From 9ffe908c66c3dd2750ce5e7515aad6b082511d1c Mon Sep 17 00:00:00 2001 From: stefanprodan Date: Fri, 19 Jun 2020 16:19:45 +0300 Subject: [PATCH 5/9] Add docs intro --- cmd/tk/bootstrap_gitlab.go | 2 +- docs/get-started/index.md | 24 ++++++++++++++---------- docs/index.md | 17 ++++++++++++++++- mkdocs.yml | 3 ++- 4 files changed, 33 insertions(+), 13 deletions(-) diff --git a/cmd/tk/bootstrap_gitlab.go b/cmd/tk/bootstrap_gitlab.go index 0ec0e5ac..7e2bac69 100644 --- a/cmd/tk/bootstrap_gitlab.go +++ b/cmd/tk/bootstrap_gitlab.go @@ -18,7 +18,7 @@ var bootstrapGitLabCmd = &cobra.Command{ Use: "gitlab", Short: "Bootstrap GitLab repository", Long: ` -The bootstrap command creates the GitHub repository if it doesn't exists and +The bootstrap command creates the GitLab repository if it doesn't exists and commits the toolkit components manifests to the master branch. Then it configure the target cluster to synchronize with the repository. If the toolkit components are present on the cluster, diff --git a/docs/get-started/index.md b/docs/get-started/index.md index f3b40cb4..bbce51d8 100644 --- a/docs/get-started/index.md +++ b/docs/get-started/index.md @@ -19,11 +19,10 @@ that can create repositories. To install the latest `tk` release run: ```bash -curl -s https:/fluxcd.github.io/toolkit/install.sh | sudo bash +curl -s https://toolkit.fluxcd.io/install.sh | sudo bash ``` The install script downloads the tk binary to `/usr/local/bin`. - Binaries for macOS and Linux AMD64 are available for download on the [release page](https://github.com/fluxcd/toolkit/releases). @@ -36,22 +35,23 @@ To configure your shell to load tk completions add to your bash profile: ## Bootstrap -Export your GitHub personal access token with: +You'll be using a dedicated Git repository e.g. `fleet-infra` to manage one or more Kubernetes clusters. + +First export your GitHub personal access token and GitHub username: ```sh export GITHUB_TOKEN= +export GITHUB_USER= ``` -The bootstrap command creates a GitHub repository if one doesn't exist and -commits the toolkit components manifests to the master branch. -Then it configures the target cluster to synchronize with the repository. -If the toolkit components are present on the cluster, -the bootstrap command will perform an upgrade if needed. +The bootstrap command creates a repository if one doesn't exist and +commits the toolkit components manifests to the master branch at the specified path. +Then it configures the target cluster to synchronize with the specified path inside the repository. ```sh tk bootstrap github \ - --owner= \ - --repository= \ + --owner=$GITHUB_USER \ + --repository=fleet-infra \ --path=dev-cluster \ --personal ``` @@ -107,6 +107,10 @@ deployment "kustomize-controller" successfully rolled out If you prefer GitLab, export `GITLAB_TOKEN` env var and use the command `tk bootstrap gitlab`. +It is safe to run the bootstrap command as many times as you want. +If the toolkit components are present on the cluster, +the bootstrap command will perform an upgrade if needed. + ## Create a GitOps workflow Clone the repository with: diff --git a/docs/index.md b/docs/index.md index 9da4136e..bca35de7 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,5 +1,20 @@ # GitOps Toolkit -Experimental toolkit for assembling CD pipelines the GitOps way. +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 +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. ![](diagrams/tk-overview.png) + +Components: + +- [Toolkit CLI](https://github.com/fluxcd/toolkit) +- [Source Controller](https://github.com/fluxcd/source-controller) +- [Kustomize Controller](https://github.com/fluxcd/kustomize-controller) + +To get started with the toolkit please follow this [guide](get-started/index.md). diff --git a/mkdocs.yml b/mkdocs.yml index 4da63169..6ed3d2dd 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -35,8 +35,9 @@ markdown_extensions: - pymdownx.tabbed nav: + - Introduction: index.md - Get Started: get-started/index.md - - tk CLI: + - Toolkit CLI: - Bootstrap: cmd/tk_bootstrap.md - Check: cmd/tk_check.md - Create: cmd/tk_create.md From c23d40ca7159a105ece8b3c728d408eea06b0d16 Mon Sep 17 00:00:00 2001 From: stefanprodan Date: Fri, 19 Jun 2020 17:27:32 +0300 Subject: [PATCH 6/9] Add instruction for tk kubectl plugin --- install/README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/install/README.md b/install/README.md index 50f6eb33..eaf93799 100644 --- a/install/README.md +++ b/install/README.md @@ -15,6 +15,12 @@ The install script does the following: * copies the tk binary to `/usr/local/bin` * removes the temporary directory +If you want to use tk as a kubectl plugin, rename the binary to `kubectl-tk`: + +```sh +mv /usr/local/bin/tk /usr/local/bin/kubectl-tk +``` + ## Build from source Clone the repository: From 0935a637f988c971d5f309c98390aba4f2792c2f Mon Sep 17 00:00:00 2001 From: stefanprodan Date: Fri, 19 Jun 2020 17:37:24 +0300 Subject: [PATCH 7/9] Add prerequisites check to docs --- docs/get-started/index.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/get-started/index.md b/docs/get-started/index.md index bbce51d8..cc2dd461 100644 --- a/docs/get-started/index.md +++ b/docs/get-started/index.md @@ -33,6 +33,17 @@ To configure your shell to load tk completions add to your bash profile: . <(tk completion) ``` +Verify that your cluster satisfies the prerequisites with: + +```text +$ tk check --pre + +► checking prerequisites +✔ kubectl 1.18.3 >=1.18.0 +✔ kubernetes 1.16.8-eks-e16311 >=1.14.0 +✔ prerequisites checks passed +``` + ## Bootstrap You'll be using a dedicated Git repository e.g. `fleet-infra` to manage one or more Kubernetes clusters. @@ -105,7 +116,7 @@ deployment "kustomize-controller" successfully rolled out ✔ bootstrap finished ``` -If you prefer GitLab, export `GITLAB_TOKEN` env var and use the command `tk bootstrap gitlab`. +If you prefer GitLab, export `GITLAB_TOKEN` env var and use the command [tk bootstrap gitlab](../cmd/tk_bootstrap_gitlab.md). It is safe to run the bootstrap command as many times as you want. If the toolkit components are present on the cluster, @@ -116,7 +127,7 @@ the bootstrap command will perform an upgrade if needed. Clone the repository with: ```sh -git clone https://github.com/gitopsrun/fleet-infra +git clone https://github.com/$GITHUB_USER/fleet-infra cd fleet-infra ``` From 3d7349ee53a64663c8d7016ea4605ca349a589c5 Mon Sep 17 00:00:00 2001 From: stefanprodan Date: Fri, 19 Jun 2020 17:44:08 +0300 Subject: [PATCH 8/9] Generate cmd docs --- cmd/tk/bootstrap_gitlab.go | 4 ++-- docs/cmd/tk.md | 2 +- docs/cmd/tk_bootstrap.md | 2 +- docs/cmd/tk_bootstrap_github.md | 2 +- docs/cmd/tk_bootstrap_gitlab.md | 8 ++++---- docs/cmd/tk_check.md | 2 +- docs/cmd/tk_completion.md | 2 +- docs/cmd/tk_create.md | 2 +- docs/cmd/tk_create_kustomization.md | 2 +- docs/cmd/tk_create_source.md | 2 +- docs/cmd/tk_create_source_git.md | 4 ++-- docs/cmd/tk_delete.md | 2 +- docs/cmd/tk_delete_kustomization.md | 2 +- docs/cmd/tk_delete_source.md | 2 +- docs/cmd/tk_delete_source_git.md | 2 +- docs/cmd/tk_export.md | 2 +- docs/cmd/tk_export_kustomization.md | 2 +- docs/cmd/tk_export_source.md | 2 +- docs/cmd/tk_export_source_git.md | 2 +- docs/cmd/tk_get.md | 2 +- docs/cmd/tk_get_kustomizations.md | 2 +- docs/cmd/tk_get_sources.md | 2 +- docs/cmd/tk_get_sources_git.md | 2 +- docs/cmd/tk_install.md | 2 +- docs/cmd/tk_resume.md | 2 +- docs/cmd/tk_resume_kustomization.md | 2 +- docs/cmd/tk_suspend.md | 2 +- docs/cmd/tk_suspend_kustomization.md | 2 +- docs/cmd/tk_sync.md | 2 +- docs/cmd/tk_sync_kustomization.md | 2 +- docs/cmd/tk_sync_source.md | 2 +- docs/cmd/tk_sync_source_git.md | 2 +- docs/cmd/tk_uninstall.md | 2 +- 33 files changed, 38 insertions(+), 38 deletions(-) diff --git a/cmd/tk/bootstrap_gitlab.go b/cmd/tk/bootstrap_gitlab.go index 7e2bac69..4a950b00 100644 --- a/cmd/tk/bootstrap_gitlab.go +++ b/cmd/tk/bootstrap_gitlab.go @@ -35,7 +35,7 @@ the bootstrap command will perform an upgrade if needed.`, # Run bootstrap for a public repository on a personal account bootstrap gitlab --owner= --repository= --private=false --personal=true - # Run bootstrap for a private repo hosted on GitLab server + # Run bootstrap for a private repo hosted on a GitLab server bootstrap gitlab --owner= --repository= --hostname= `, RunE: bootstrapGitLabCmdRun, @@ -52,7 +52,7 @@ var ( ) func init() { - bootstrapGitLabCmd.Flags().StringVar(&glOwner, "owner", "", "GitLab user or organization name") + bootstrapGitLabCmd.Flags().StringVar(&glOwner, "owner", "", "GitLab user or group name") bootstrapGitLabCmd.Flags().StringVar(&glRepository, "repository", "", "GitLab repository name") bootstrapGitLabCmd.Flags().BoolVar(&glPersonal, "personal", false, "is personal repository") bootstrapGitLabCmd.Flags().BoolVar(&glPrivate, "private", true, "is private repository") diff --git a/docs/cmd/tk.md b/docs/cmd/tk.md index 4381649d..7e5e4174 100644 --- a/docs/cmd/tk.md +++ b/docs/cmd/tk.md @@ -90,4 +90,4 @@ Command line utility for assembling Kubernetes CD pipelines the GitOps way. * [tk sync](tk_sync.md) - Synchronize commands * [tk uninstall](tk_uninstall.md) - Uninstall the toolkit components -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_bootstrap.md b/docs/cmd/tk_bootstrap.md index 09227700..6ceb6cf0 100644 --- a/docs/cmd/tk_bootstrap.md +++ b/docs/cmd/tk_bootstrap.md @@ -29,4 +29,4 @@ Bootstrap commands * [tk bootstrap github](tk_bootstrap_github.md) - Bootstrap GitHub repository * [tk bootstrap gitlab](tk_bootstrap_gitlab.md) - Bootstrap GitLab repository -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_bootstrap_github.md b/docs/cmd/tk_bootstrap_github.md index 80c4bf65..7ffcd2a3 100644 --- a/docs/cmd/tk_bootstrap_github.md +++ b/docs/cmd/tk_bootstrap_github.md @@ -67,4 +67,4 @@ tk bootstrap github [flags] * [tk bootstrap](tk_bootstrap.md) - Bootstrap commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_bootstrap_gitlab.md b/docs/cmd/tk_bootstrap_gitlab.md index 983ede4c..ddb587a8 100644 --- a/docs/cmd/tk_bootstrap_gitlab.md +++ b/docs/cmd/tk_bootstrap_gitlab.md @@ -5,7 +5,7 @@ Bootstrap GitLab repository ### Synopsis -The bootstrap command creates the GitHub repository if it doesn't exists and +The bootstrap command creates the GitLab repository if it doesn't exists and commits the toolkit components manifests to the master branch. Then it configure the target cluster to synchronize with the repository. If the toolkit components are present on the cluster, @@ -30,7 +30,7 @@ tk bootstrap gitlab [flags] # Run bootstrap for a public repository on a personal account bootstrap gitlab --owner= --repository= --private=false --personal=true - # Run bootstrap for a private repo hosted on GitLab server + # Run bootstrap for a private repo hosted on a GitLab server bootstrap gitlab --owner= --repository= --hostname= ``` @@ -41,7 +41,7 @@ tk bootstrap gitlab [flags] -h, --help help for gitlab --hostname string GitLab hostname (default "gitlab.com") --interval duration sync interval (default 1m0s) - --owner string GitLab user or organization name + --owner string GitLab user or group name --path string repository path, when specified the cluster sync will be scoped to this path --personal is personal repository --private is private repository (default true) @@ -63,4 +63,4 @@ tk bootstrap gitlab [flags] * [tk bootstrap](tk_bootstrap.md) - Bootstrap commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_check.md b/docs/cmd/tk_check.md index de378dc8..f0a58cad 100644 --- a/docs/cmd/tk_check.md +++ b/docs/cmd/tk_check.md @@ -44,4 +44,4 @@ tk check [flags] * [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_completion.md b/docs/cmd/tk_completion.md index 904dbedf..4a1b24d8 100644 --- a/docs/cmd/tk_completion.md +++ b/docs/cmd/tk_completion.md @@ -44,4 +44,4 @@ To configure your bash shell to load completions for each session add to your ba * [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_create.md b/docs/cmd/tk_create.md index 4441d63d..824010a3 100644 --- a/docs/cmd/tk_create.md +++ b/docs/cmd/tk_create.md @@ -30,4 +30,4 @@ Create commands * [tk create kustomization](tk_create_kustomization.md) - Create or update a kustomization resource * [tk create source](tk_create_source.md) - Create source commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_create_kustomization.md b/docs/cmd/tk_create_kustomization.md index 1242decb..482ef3c4 100644 --- a/docs/cmd/tk_create_kustomization.md +++ b/docs/cmd/tk_create_kustomization.md @@ -78,4 +78,4 @@ tk create kustomization [name] [flags] * [tk create](tk_create.md) - Create commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_create_source.md b/docs/cmd/tk_create_source.md index e4566e02..53c22c00 100644 --- a/docs/cmd/tk_create_source.md +++ b/docs/cmd/tk_create_source.md @@ -29,4 +29,4 @@ Create source commands * [tk create](tk_create.md) - Create commands * [tk create source git](tk_create_source_git.md) - Create or update a git source -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_create_source_git.md b/docs/cmd/tk_create_source_git.md index 2ab78045..b5416217 100644 --- a/docs/cmd/tk_create_source_git.md +++ b/docs/cmd/tk_create_source_git.md @@ -58,7 +58,7 @@ tk create source git [name] [flags] --branch string git branch (default "master") -h, --help help for git -p, --password string basic authentication password - --ssh-ecdsa-curve ecdsaCurve SSH ECDSA public key curve (p256, p384, p521) (default p384) + --ssh-ecdsa-curve ecdsaCurve SSH ECDSA public key curve (p384, p521, p256) (default p384) --ssh-key-algorithm publicKeyAlgorithm SSH public key algorithm (rsa, ecdsa, ed25519) (default rsa) --ssh-rsa-bits rsaKeyBits SSH RSA public key bit size (multiplies of 8) (default 2048) --tag string git tag @@ -83,4 +83,4 @@ tk create source git [name] [flags] * [tk create source](tk_create_source.md) - Create source commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_delete.md b/docs/cmd/tk_delete.md index 438aaf65..21e7b9ae 100644 --- a/docs/cmd/tk_delete.md +++ b/docs/cmd/tk_delete.md @@ -29,4 +29,4 @@ Delete commands * [tk delete kustomization](tk_delete_kustomization.md) - Delete kustomization * [tk delete source](tk_delete_source.md) - Delete sources commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_delete_kustomization.md b/docs/cmd/tk_delete_kustomization.md index 4cc8db77..946c6305 100644 --- a/docs/cmd/tk_delete_kustomization.md +++ b/docs/cmd/tk_delete_kustomization.md @@ -31,4 +31,4 @@ tk delete kustomization [name] [flags] * [tk delete](tk_delete.md) - Delete commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_delete_source.md b/docs/cmd/tk_delete_source.md index 78184fac..e0d3c699 100644 --- a/docs/cmd/tk_delete_source.md +++ b/docs/cmd/tk_delete_source.md @@ -28,4 +28,4 @@ Delete sources commands * [tk delete](tk_delete.md) - Delete commands * [tk delete source git](tk_delete_source_git.md) - Delete git source -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_delete_source_git.md b/docs/cmd/tk_delete_source_git.md index 57b315fd..df90c79d 100644 --- a/docs/cmd/tk_delete_source_git.md +++ b/docs/cmd/tk_delete_source_git.md @@ -31,4 +31,4 @@ tk delete source git [name] [flags] * [tk delete source](tk_delete_source.md) - Delete sources commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_export.md b/docs/cmd/tk_export.md index fe894afa..9b930882 100644 --- a/docs/cmd/tk_export.md +++ b/docs/cmd/tk_export.md @@ -29,4 +29,4 @@ Export commands * [tk export kustomization](tk_export_kustomization.md) - Export kustomization in YAML format * [tk export source](tk_export_source.md) - Export source commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_export_kustomization.md b/docs/cmd/tk_export_kustomization.md index f855247a..fb0f3bb0 100644 --- a/docs/cmd/tk_export_kustomization.md +++ b/docs/cmd/tk_export_kustomization.md @@ -42,4 +42,4 @@ tk export kustomization [name] [flags] * [tk export](tk_export.md) - Export commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_export_source.md b/docs/cmd/tk_export_source.md index 638dbea3..df0f7930 100644 --- a/docs/cmd/tk_export_source.md +++ b/docs/cmd/tk_export_source.md @@ -29,4 +29,4 @@ Export source commands * [tk export](tk_export.md) - Export commands * [tk export source git](tk_export_source_git.md) - Export git sources in YAML format -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_export_source_git.md b/docs/cmd/tk_export_source_git.md index 5d41f1bb..6c2f3b45 100644 --- a/docs/cmd/tk_export_source_git.md +++ b/docs/cmd/tk_export_source_git.md @@ -43,4 +43,4 @@ tk export source git [name] [flags] * [tk export source](tk_export_source.md) - Export source commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_get.md b/docs/cmd/tk_get.md index afcf9f31..dbb91058 100644 --- a/docs/cmd/tk_get.md +++ b/docs/cmd/tk_get.md @@ -28,4 +28,4 @@ Get commands * [tk get kustomizations](tk_get_kustomizations.md) - Get kustomizations status * [tk get sources](tk_get_sources.md) - Get sources commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_get_kustomizations.md b/docs/cmd/tk_get_kustomizations.md index c7386fa0..1acb49eb 100644 --- a/docs/cmd/tk_get_kustomizations.md +++ b/docs/cmd/tk_get_kustomizations.md @@ -31,4 +31,4 @@ tk get kustomizations [flags] * [tk get](tk_get.md) - Get commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_get_sources.md b/docs/cmd/tk_get_sources.md index b70d4224..dee318ce 100644 --- a/docs/cmd/tk_get_sources.md +++ b/docs/cmd/tk_get_sources.md @@ -27,4 +27,4 @@ Get sources commands * [tk get](tk_get.md) - Get commands * [tk get sources git](tk_get_sources_git.md) - Get git sources status -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_get_sources_git.md b/docs/cmd/tk_get_sources_git.md index 6a26f86b..3b97e118 100644 --- a/docs/cmd/tk_get_sources_git.md +++ b/docs/cmd/tk_get_sources_git.md @@ -31,4 +31,4 @@ tk get sources git [flags] * [tk get sources](tk_get_sources.md) - Get sources commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_install.md b/docs/cmd/tk_install.md index 7b077b31..65954bfa 100644 --- a/docs/cmd/tk_install.md +++ b/docs/cmd/tk_install.md @@ -49,4 +49,4 @@ tk install [flags] * [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_resume.md b/docs/cmd/tk_resume.md index 81c23458..78f8daae 100644 --- a/docs/cmd/tk_resume.md +++ b/docs/cmd/tk_resume.md @@ -27,4 +27,4 @@ Resume commands * [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines * [tk resume kustomization](tk_resume_kustomization.md) - Resume kustomization -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_resume_kustomization.md b/docs/cmd/tk_resume_kustomization.md index 180bc8d1..63eaf4ae 100644 --- a/docs/cmd/tk_resume_kustomization.md +++ b/docs/cmd/tk_resume_kustomization.md @@ -30,4 +30,4 @@ tk resume kustomization [name] [flags] * [tk resume](tk_resume.md) - Resume commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_suspend.md b/docs/cmd/tk_suspend.md index d99a4ddf..46d26484 100644 --- a/docs/cmd/tk_suspend.md +++ b/docs/cmd/tk_suspend.md @@ -27,4 +27,4 @@ Suspend commands * [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines * [tk suspend kustomization](tk_suspend_kustomization.md) - Suspend kustomization -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_suspend_kustomization.md b/docs/cmd/tk_suspend_kustomization.md index eaaf8c60..973e9d1f 100644 --- a/docs/cmd/tk_suspend_kustomization.md +++ b/docs/cmd/tk_suspend_kustomization.md @@ -30,4 +30,4 @@ tk suspend kustomization [name] [flags] * [tk suspend](tk_suspend.md) - Suspend commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_sync.md b/docs/cmd/tk_sync.md index df50a411..ddeadecf 100644 --- a/docs/cmd/tk_sync.md +++ b/docs/cmd/tk_sync.md @@ -28,4 +28,4 @@ Synchronize commands * [tk sync kustomization](tk_sync_kustomization.md) - Synchronize kustomization * [tk sync source](tk_sync_source.md) - Synchronize source commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_sync_kustomization.md b/docs/cmd/tk_sync_kustomization.md index 47c2a65d..13e6e6bd 100644 --- a/docs/cmd/tk_sync_kustomization.md +++ b/docs/cmd/tk_sync_kustomization.md @@ -43,4 +43,4 @@ tk sync kustomization [name] [flags] * [tk sync](tk_sync.md) - Synchronize commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_sync_source.md b/docs/cmd/tk_sync_source.md index 7343d584..a928442c 100644 --- a/docs/cmd/tk_sync_source.md +++ b/docs/cmd/tk_sync_source.md @@ -27,4 +27,4 @@ Synchronize source commands * [tk sync](tk_sync.md) - Synchronize commands * [tk sync source git](tk_sync_source_git.md) - Synchronize git source -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_sync_source_git.md b/docs/cmd/tk_sync_source_git.md index cf4cf226..3713776c 100644 --- a/docs/cmd/tk_sync_source_git.md +++ b/docs/cmd/tk_sync_source_git.md @@ -39,4 +39,4 @@ tk sync source git [name] [flags] * [tk sync source](tk_sync_source.md) - Synchronize source commands -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 diff --git a/docs/cmd/tk_uninstall.md b/docs/cmd/tk_uninstall.md index 1e7e5f25..c7a9c9ed 100644 --- a/docs/cmd/tk_uninstall.md +++ b/docs/cmd/tk_uninstall.md @@ -47,4 +47,4 @@ tk uninstall [flags] * [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines -###### Auto generated by spf13/cobra on 18-Jun-2020 +###### Auto generated by spf13/cobra on 19-Jun-2020 From e92615b3a874fe4b7ad8cfc443dc5c65ee765752 Mon Sep 17 00:00:00 2001 From: stefanprodan Date: Fri, 19 Jun 2020 18:03:41 +0300 Subject: [PATCH 9/9] Publish docs from master branch --- .github/workflows/docs.yaml | 1 + mkdocs.yml | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index aaf01d84..0deb0910 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -3,6 +3,7 @@ on: push: branches: - docs* + - master jobs: build: diff --git a/mkdocs.yml b/mkdocs.yml index 6ed3d2dd..f03df7ba 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -48,4 +48,4 @@ nav: - Resume: cmd/tk_resume.md - Suspend: cmd/tk_suspend.md - Synchronize: cmd/tk_sync.md - - Uninstall: cmd/tk_uninstall.md \ No newline at end of file + - Uninstall: cmd/tk_uninstall.md