diff options
author | Vincent Ambo <tazjin@gmail.com> | 2017-05-04T16·43+0200 |
---|---|---|
committer | Vincent Ambo <tazjin@gmail.com> | 2017-05-04T16·49+0200 |
commit | 211289765af73d4a429fd4eeb304bb64d78fbff1 (patch) | |
tree | 27c7fe49a365c0ae81252289e6c8f8551be9b059 | |
parent | c8a63861aee60a156ed4a63f6b5211dc6abac225 (diff) |
docs README: Update usage examples for kingpin CLI
-rw-r--r-- | README.md | 56 |
1 files changed, 28 insertions, 28 deletions
diff --git a/README.md b/README.md index b9390a8550bc..fbbbcf60697a 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -KonTemplate - A simple Kubernetes templater +Kontemplate - A simple Kubernetes templater =========================================== [![Build Status](https://travis-ci.org/tazjin/kontemplate.svg?branch=master)](https://travis-ci.org/tazjin/kontemplate) @@ -9,7 +9,7 @@ which context (i.e. k8s cluster) is specified. ## Overview -KonTemplate lets you describe resources as you normally would in a simple folder structure: +Kontemplate lets you describe resources as you normally would in a simple folder structure: ``` . @@ -45,48 +45,48 @@ Assuming you have Go configured correctly, you can simply `go get github.com/taz ## Usage -You must have `kubectl` installed to use KonTemplate effectively. +You must have `kubectl` installed to use Kontemplate effectively. ``` -NAME: - kontemplate - simple Kubernetes resource templating +usage: kontemplate [<flags>] <command> [<args> ...] -USAGE: - kontemplate [global options] command [command options] [arguments...] +simple Kubernetes resource templating -VERSION: - 0.0.1 +Flags: + -h, --help Show context-sensitive help (also try --help-long and --help-man). + -i, --include=INCLUDE ... Resource sets to include explicitly + -e, --exclude=EXCLUDE ... Resource sets to exclude explicitly -COMMANDS: - template Interpolate and print templates - apply Interpolate templates and run 'kubectl apply' - replace Interpolate templates and run 'kubectl replace' - delete Interpolate templates and run 'kubectl delete' - help, h Shows a list of commands or help for one command +Commands: + help [<command>...] + Show help. -GLOBAL OPTIONS: - --help, -h show help - --version, -v print the version -``` + template <file> + Template resource sets and print them -All options support the same set of extra flags: + apply [<flags>] <file> + Template resources and pass to 'kubectl apply' + + replace <file> + Template resources and pass to 'kubectl replace' + + delete <file> + Template resources and pass to 'kubectl delete' + + create <file> + Template resources and pass to 'kubectl create' -``` -OPTIONS: - --file value, -f value Cluster configuration file to use - --include value, -i value Limit templating to explicitly included resource sets - --exclude value, -e value Exclude certain resource sets from templating ``` Examples: ``` # Look at output for a specific resource set and check to see if it's correct ... -kontemplate template -f example/prod-cluster.yaml -i some-api +kontemplate template example/prod-cluster.yaml -i some-api # ... maybe do a dry-run to see what kubectl would do: -kontemplate apply -f example/prod-cluster.yaml --dry-run +kontemplate apply example/prod-cluster.yaml --dry-run # And actually apply it if you like what you see: -kontemplate apply -f example/prod-cluster.yaml +kontemplate apply example/prod-cluster.yaml ``` \ No newline at end of file |