mirror of https://github.com/fluxcd/flux2.git
docs: add CLI help
parent
28101c809d
commit
be3f65d800
@ -0,0 +1,92 @@
|
|||||||
|
## tk
|
||||||
|
|
||||||
|
Command line utility for assembling Kubernetes CD pipelines
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Command line utility for assembling Kubernetes CD pipelines the GitOps way.
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Check prerequisites
|
||||||
|
tk check --pre
|
||||||
|
|
||||||
|
# Install the latest version of the toolkit
|
||||||
|
tk install --version=master
|
||||||
|
|
||||||
|
# Create a source from a public Git repository
|
||||||
|
tk create source git webapp-latest \
|
||||||
|
--url=https://github.com/stefanprodan/podinfo \
|
||||||
|
--branch=master \
|
||||||
|
--interval=3m
|
||||||
|
|
||||||
|
# List git sources and their status
|
||||||
|
tk get sources git
|
||||||
|
|
||||||
|
# Trigger a git sync
|
||||||
|
tk sync source git webapp-latest
|
||||||
|
|
||||||
|
# Export git sources in YAML format
|
||||||
|
tk export source git --all > sources.yaml
|
||||||
|
|
||||||
|
# Create a kustomization for deploying a series of microservices
|
||||||
|
tk create kustomization webapp-dev \
|
||||||
|
--source=webapp-latest \
|
||||||
|
--path="./deploy/webapp/" \
|
||||||
|
--prune="instance=webapp" \
|
||||||
|
--generate=true \
|
||||||
|
--interval=5m \
|
||||||
|
--validate=client \
|
||||||
|
--health-check="Deployment/backend.webapp" \
|
||||||
|
--health-check="Deployment/frontend.webapp" \
|
||||||
|
--health-check-timeout=2m
|
||||||
|
|
||||||
|
# Trigger a git sync and apply changes if any
|
||||||
|
tk sync kustomization webapp-dev --with-source
|
||||||
|
|
||||||
|
# Suspend a kustomization reconciliation
|
||||||
|
tk suspend kustomization webapp-dev
|
||||||
|
|
||||||
|
# Export kustomizations in YAML format
|
||||||
|
tk export kustomization --all > kustomizations.yaml
|
||||||
|
|
||||||
|
# Resume a kustomization reconciliation
|
||||||
|
tk resume kustomization webapp-dev
|
||||||
|
|
||||||
|
# Delete a kustomization
|
||||||
|
tk delete kustomization webapp-dev
|
||||||
|
|
||||||
|
# Delete a git source
|
||||||
|
tk delete source git webapp-latest
|
||||||
|
|
||||||
|
# Uninstall the toolkit and delete CRDs
|
||||||
|
tk uninstall --crds
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
-h, --help help for tk
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk check](tk_check.md) - Check requirements and installation
|
||||||
|
* [tk create](tk_create.md) - Create commands
|
||||||
|
* [tk delete](tk_delete.md) - Delete commands
|
||||||
|
* [tk export](tk_export.md) - Export commands
|
||||||
|
* [tk get](tk_get.md) - Get commands
|
||||||
|
* [tk install](tk_install.md) - Install the toolkit components
|
||||||
|
* [tk resume](tk_resume.md) - Resume commands
|
||||||
|
* [tk suspend](tk_suspend.md) - Suspend commands
|
||||||
|
* [tk sync](tk_sync.md) - Synchronize commands
|
||||||
|
* [tk uninstall](tk_uninstall.md) - Uninstall the toolkit components
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,47 @@
|
|||||||
|
## tk check
|
||||||
|
|
||||||
|
Check requirements and installation
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
|
||||||
|
The check command will perform a series of checks to validate that
|
||||||
|
the local environment is configured correctly and if the installed components are healthy.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk check [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Run pre-installation checks
|
||||||
|
check --pre
|
||||||
|
|
||||||
|
# Run installation checks
|
||||||
|
check
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for check
|
||||||
|
--pre only run pre-installation checks
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,32 @@
|
|||||||
|
## tk create
|
||||||
|
|
||||||
|
Create commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Create commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for create
|
||||||
|
--interval duration source sync interval (default 1m0s)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,70 @@
|
|||||||
|
## tk create kustomization
|
||||||
|
|
||||||
|
Create or update a kustomization resource
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
|
||||||
|
The kustomization source command generates a kustomization.kustomize.fluxcd.io resource for a given GitRepository source.
|
||||||
|
API spec: https://github.com/fluxcd/kustomize-controller/tree/master/docs/spec/v1alpha1
|
||||||
|
|
||||||
|
```
|
||||||
|
tk create kustomization [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Create a kustomization from a source at a given path
|
||||||
|
create kustomization contour \
|
||||||
|
--source=contour \
|
||||||
|
--path="./examples/contour/" \
|
||||||
|
--prune="instance=contour" \
|
||||||
|
--generate=true \
|
||||||
|
--interval=10m \
|
||||||
|
--validate=client \
|
||||||
|
--health-check="Deployment/contour.projectcontour" \
|
||||||
|
--health-check="DaemonSet/envoy.projectcontour" \
|
||||||
|
--health-check-timeout=3m
|
||||||
|
|
||||||
|
# Create a kustomization that depends on the previous one
|
||||||
|
create kustomization webapp \
|
||||||
|
--depends-on=contour \
|
||||||
|
--source=webapp \
|
||||||
|
--path="./deploy/overlays/dev" \
|
||||||
|
--prune="env=dev,instance=webapp" \
|
||||||
|
--interval=5m \
|
||||||
|
--validate=client
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
--depends-on stringArray kustomization that must be ready before this kustomization can be applied
|
||||||
|
--generate generate the kustomization.yaml for all the Kubernetes manifests in the specified path and sub-directories
|
||||||
|
--health-check stringArray workload to be included in the health assessment, in the format '<kind>/<name>.<namespace>'
|
||||||
|
--health-check-timeout duration timeout of health checking operations (default 2m0s)
|
||||||
|
-h, --help help for kustomization
|
||||||
|
--path string path to the directory containing the kustomization file (default "./")
|
||||||
|
--prune string label selector used for garbage collection
|
||||||
|
--source string GitRepository name
|
||||||
|
--validate string validate the manifests before applying them on the cluster, can be 'client' or 'server'
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--interval duration source sync interval (default 1m0s)
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk create](tk_create.md) - Create commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,31 @@
|
|||||||
|
## tk create source
|
||||||
|
|
||||||
|
Create source commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Create source commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for source
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--interval duration source sync interval (default 1m0s)
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,74 @@
|
|||||||
|
## tk create source git
|
||||||
|
|
||||||
|
Create or update a git source
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
|
||||||
|
The create source command generates a GitRepository resource and waits for it to sync.
|
||||||
|
For Git over SSH, host and SSH keys are automatically generated and stored in a Kubernetes secret.
|
||||||
|
For private Git repositories, the basic authentication credentials are stored in a Kubernetes secret.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk create source git [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Create a source from a public Git repository master branch
|
||||||
|
create source git podinfo \
|
||||||
|
--url=https://github.com/stefanprodan/podinfo \
|
||||||
|
--branch=master
|
||||||
|
|
||||||
|
# Create a source from a Git repository pinned to specific git tag
|
||||||
|
create source git podinfo \
|
||||||
|
--url=https://github.com/stefanprodan/podinfo \
|
||||||
|
--tag="3.2.3"
|
||||||
|
|
||||||
|
# Create a source from a public Git repository tag that matches a semver range
|
||||||
|
create source git podinfo \
|
||||||
|
--url=https://github.com/stefanprodan/podinfo \
|
||||||
|
--tag-semver=">=3.2.0 <3.3.0"
|
||||||
|
|
||||||
|
# Create a source from a Git repository using SSH authentication
|
||||||
|
create source git podinfo \
|
||||||
|
--url=ssh://git@github.com/stefanprodan/podinfo \
|
||||||
|
--branch=master
|
||||||
|
|
||||||
|
# Create a source from a Git repository using basic authentication
|
||||||
|
create source git podinfo \
|
||||||
|
--url=https://github.com/stefanprodan/podinfo \
|
||||||
|
--username=username \
|
||||||
|
--password=password
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
--branch string git branch (default "master")
|
||||||
|
-h, --help help for git
|
||||||
|
-p, --password string basic authentication password
|
||||||
|
--tag string git tag
|
||||||
|
--tag-semver string git tag semver range
|
||||||
|
--url string git address, e.g. ssh://git@host/org/repository
|
||||||
|
-u, --username string basic authentication username
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--interval duration source sync interval (default 1m0s)
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk create source](tk_create_source.md) - Create source commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,32 @@
|
|||||||
|
## tk delete
|
||||||
|
|
||||||
|
Delete commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Delete commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for delete
|
||||||
|
--silent delete resource without asking for confirmation
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,34 @@
|
|||||||
|
## tk delete kustomization
|
||||||
|
|
||||||
|
Delete kustomization
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Delete kustomization
|
||||||
|
|
||||||
|
```
|
||||||
|
tk delete kustomization [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for kustomization
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--silent delete resource without asking for confirmation
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk delete](tk_delete.md) - Delete commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,31 @@
|
|||||||
|
## tk delete source
|
||||||
|
|
||||||
|
Delete sources commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Delete sources commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for source
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--silent delete resource without asking for confirmation
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,34 @@
|
|||||||
|
## tk delete source git
|
||||||
|
|
||||||
|
Delete git source
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Delete git source
|
||||||
|
|
||||||
|
```
|
||||||
|
tk delete source git [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for git
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--silent delete resource without asking for confirmation
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk delete source](tk_delete_source.md) - Delete sources commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,32 @@
|
|||||||
|
## tk export
|
||||||
|
|
||||||
|
Export commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Export commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
--all select all resources
|
||||||
|
-h, --help help for export
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,45 @@
|
|||||||
|
## tk export kustomization
|
||||||
|
|
||||||
|
Export kustomization in YAML format
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Export kustomization in YAML format
|
||||||
|
|
||||||
|
```
|
||||||
|
tk export kustomization [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Export all kustomizations
|
||||||
|
export kustomization --all > kustomizations.yaml
|
||||||
|
|
||||||
|
# Export a kustomization
|
||||||
|
export kustomization my-app > kustomization.yaml
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for kustomization
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--all select all resources
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk export](tk_export.md) - Export commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,32 @@
|
|||||||
|
## tk export source
|
||||||
|
|
||||||
|
Export source commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Export source commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for source
|
||||||
|
--with-credentials include credential secrets
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--all select all resources
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,46 @@
|
|||||||
|
## tk export source git
|
||||||
|
|
||||||
|
Export git sources in YAML format
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Export git sources in YAML format
|
||||||
|
|
||||||
|
```
|
||||||
|
tk export source git [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Export all git sources
|
||||||
|
export source git --all > sources.yaml
|
||||||
|
|
||||||
|
# Export a git source including the SSH keys or basic auth credentials
|
||||||
|
export source git my-private-repo --with-credentials > source.yaml
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for git
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--all select all resources
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
--with-credentials include credential secrets
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk export source](tk_export_source.md) - Export source commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,31 @@
|
|||||||
|
## tk get
|
||||||
|
|
||||||
|
Get commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Get commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for get
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,34 @@
|
|||||||
|
## tk get kustomizations
|
||||||
|
|
||||||
|
Get kustomizations status
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
|
||||||
|
The get kustomizations command prints the status of the resources.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk get kustomizations [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for kustomizations
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk get](tk_get.md) - Get commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,30 @@
|
|||||||
|
## tk get sources
|
||||||
|
|
||||||
|
Get sources commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Get sources commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for sources
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,34 @@
|
|||||||
|
## tk get sources git
|
||||||
|
|
||||||
|
Get git sources status
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
|
||||||
|
The get sources command prints the status of the git resources.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk get sources git [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for git
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk get sources](tk_get_sources.md) - Get sources commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,52 @@
|
|||||||
|
## tk install
|
||||||
|
|
||||||
|
Install the toolkit components
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
|
||||||
|
The install command deploys the toolkit components in the specified namespace.
|
||||||
|
If a previous version is installed, then an in-place upgrade will be performed.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk install [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Install the latest version in the gitops-systems namespace
|
||||||
|
install --version=master --namespace=gitops-systems
|
||||||
|
|
||||||
|
# Dry-run install for a specific version and a series of components
|
||||||
|
install --dry-run --version=0.0.1 --components="source-controller,kustomize-controller"
|
||||||
|
|
||||||
|
# Dry-run install with manifests preview
|
||||||
|
install --dry-run --verbose
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
--dry-run only print the object that would be applied
|
||||||
|
-h, --help help for install
|
||||||
|
--manifests string path to the manifest directory, dev only
|
||||||
|
-v, --version string toolkit tag or branch (default "master")
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,30 @@
|
|||||||
|
## tk resume
|
||||||
|
|
||||||
|
Resume commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Resume commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for resume
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,33 @@
|
|||||||
|
## tk resume kustomization
|
||||||
|
|
||||||
|
Resume kustomization
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
The resume command marks a previously suspended Kustomization resource for reconciliation and waits for it to finish the apply.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk resume kustomization [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for kustomization
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk resume](tk_resume.md) - Resume commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,30 @@
|
|||||||
|
## tk suspend
|
||||||
|
|
||||||
|
Suspend commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Suspend commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for suspend
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,33 @@
|
|||||||
|
## tk suspend kustomization
|
||||||
|
|
||||||
|
Suspend kustomization
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
The suspend command disables the reconciliation of a Kustomization resource.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk suspend kustomization [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for kustomization
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk suspend](tk_suspend.md) - Suspend commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,31 @@
|
|||||||
|
## tk sync
|
||||||
|
|
||||||
|
Synchronize commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Synchronize commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for sync
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,46 @@
|
|||||||
|
## tk sync kustomization
|
||||||
|
|
||||||
|
Synchronize kustomization
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
|
||||||
|
The sync kustomization command triggers a reconciliation of a Kustomization resource and waits for it to finish.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk sync kustomization [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Trigger a kustomization apply outside of the reconciliation interval
|
||||||
|
sync kustomization podinfo
|
||||||
|
|
||||||
|
# Trigger a git sync of the kustomization source and apply changes
|
||||||
|
sync kustomization podinfo --with-source
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for kustomization
|
||||||
|
--with-source synchronize kustomization source
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk sync](tk_sync.md) - Synchronize commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,30 @@
|
|||||||
|
## tk sync source
|
||||||
|
|
||||||
|
Synchronize source commands
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Synchronize source commands
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for source
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [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 30-Apr-2020
|
@ -0,0 +1,42 @@
|
|||||||
|
## tk sync source git
|
||||||
|
|
||||||
|
Synchronize git source
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
|
||||||
|
The sync source command triggers a reconciliation of a GitRepository resource and waits for it to finish.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk sync source git [name] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Trigger a git pull for an existing source
|
||||||
|
sync source git podinfo
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
-h, --help help for git
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk sync source](tk_sync_source.md) - Synchronize source commands
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,49 @@
|
|||||||
|
## tk uninstall
|
||||||
|
|
||||||
|
Uninstall the toolkit components
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
|
||||||
|
The uninstall command removes the namespace, cluster roles,
|
||||||
|
cluster role bindings and CRDs.
|
||||||
|
|
||||||
|
```
|
||||||
|
tk uninstall [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
# Dry-run uninstall of all components
|
||||||
|
uninstall --dry-run --namespace=gitops-system
|
||||||
|
|
||||||
|
# Uninstall all components and delete custom resource definitions
|
||||||
|
uninstall --crds --namespace=gitops-system
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
```
|
||||||
|
--crds removes all CRDs previously installed
|
||||||
|
--dry-run only print the object that would be deleted
|
||||||
|
-h, --help help for uninstall
|
||||||
|
--silent delete components without asking for confirmation
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--components strings list of components, accepts comma-separated values (default [source-controller,kustomize-controller])
|
||||||
|
--kubeconfig string path to the kubeconfig file (default "~/.kube/config")
|
||||||
|
--namespace string the namespace scope for this operation (default "gitops-system")
|
||||||
|
--timeout duration timeout for this operation (default 5m0s)
|
||||||
|
--verbose print generated objects
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [tk](tk.md) - Command line utility for assembling Kubernetes CD pipelines
|
||||||
|
|
||||||
|
###### Auto generated by spf13/cobra on 30-Apr-2020
|
@ -0,0 +1,12 @@
|
|||||||
|
# Release
|
||||||
|
|
||||||
|
To release a new version the following steps should be followed:
|
||||||
|
|
||||||
|
1. Create a new branch from `master` i.e. `release-<next semver>`. This
|
||||||
|
will function as your release preparation branch.
|
||||||
|
1. Change the `VERSION` value in `cmd/tk/main.go` to that of the
|
||||||
|
semver release you are going to make. Commit and push your changes.
|
||||||
|
1. Create a PR for your release branch and get it merged into `master`.
|
||||||
|
1. Create a `<next semver>` tag for the merge commit in `master` and
|
||||||
|
push it to remote.
|
||||||
|
1. Confirm CI builds and releases the newly tagged version.
|
Loading…
Reference in New Issue