kubernetes
/
kubectl
mirror of https://github.com/kubernetes/kubectl.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #255 from monopole/tweakREADME 

tweakREADME
This commit is contained in:
Jeff Regan 2018-02-05 16:20:02 -08:00 committed by GitHub
parent 4573e763e8 b35bb8f5eb
commit c0a6e5e837
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
cmd/kinflate/README.md
View File

@ -2,15 +2,13 @@
`kinflate` is a kubernetes cluster configuration utility, `kinflate` is a kubernetes cluster configuration utility,
a prototype of ideas discussed in this [proposal for a prototype of ideas discussed in this [proposal for
Declarative Application Management](https://goo.gl/T66ZcD). Declarative Application Management](https://goo.gl/T66ZcD) (DAM).
## Declarative Application Management (DAM)
[declarations]: https://kubernetes.io/docs/tutorials/object-management-kubectl/declarative-object-management-configuration/ [declarations]: https://kubernetes.io/docs/tutorials/object-management-kubectl/declarative-object-management-configuration/
DAM allows one to customize native kubernetes resources DAM allows one to customize native kubernetes resources
using new modification declarations rather than using using new modification declarations rather than using
templates or new configuration languages. template or configuration languages.
It facilitates coupling cluster state changes to version It facilitates coupling cluster state changes to version
control commits. It encourages forking a configuration, control commits. It encourages forking a configuration,
@ -19,7 +17,7 @@ upgrades from the original configuration.
## Installation ## Installation
This assumes you have [Go](https://golang.org/) installed. Prerequisites: [Go](https://golang.org/), [git](https://git-scm.com)
<!-- @installKinflate @test --> <!-- @installKinflate @test -->
``` ```
@ -32,21 +30,27 @@ GOBIN=$tmp go get k8s.io/kubectl/cmd/kinflate
[kubectl]: https://kubernetes.io/docs/user-guide/kubectl-overview/ [kubectl]: https://kubernetes.io/docs/user-guide/kubectl-overview/
[YAML]: http://www.yaml.org/start.html [YAML]: http://www.yaml.org/start.html
The following commands checkout a _kinflate app_, Clone an app, customize the resources in the app with a
customize all the resources in the app with a name prefix, name prefix, then pipe the resulting [YAML] directly to
then pipe the resulting [YAML] directly to a cluster via [kubectl]. a cluster via [kubectl].
``` ```
# Download a demo app # Download a demo app
git clone https://github.com/monopole/kapps/demo $tmp cd $tmp
git clone https://github.com/monopole/damapps
cd damapps/demo
# Use kinflate to customize it # Use kinflate to customize it
cd $tmp $tmp/kinflate setprefixname acme-
$GOBIN/kinflate setprefixname acme-
# See the change: # See the added line:
grep prefixName Kube-manifest.yaml grep namePrefix Kube-manifest.yaml
git diff Kube-manifest.yaml
# Send the app to your cluster: # Send the app to your cluster:
$GOBIN/kinflate inflate -f . | kubectl apply -f - $tmp/kinflate inflate -f . | kubectl apply -f -
``` ```
At this point, you could commit your fork
to your own repository, and rebase as desired.