Repository files navigation

VMware has made the difficult decision to stop driving this project and therefore we will no longer actively respond to issues or pull requests. The project will be externally maintained in the following fork:https://github.com/kubecfg/kubecfg

Thank You.

A tool for managing Kubernetes resources as code.

kubecfg allows you to express the patterns across yourinfrastructure and reuse these powerful "templates" across manyservices, and then manage those templates as files in version control.The more complex your infrastructure is, the more you will gain fromusing kubecfg.

Yes, Google employees will recognise this as being very similar to asimilarly-named internal tool ;)

Pre-compiled executables exist for some platforms ontheGithub releasespage.

On macOS, it can also be installed viaHomebrew:brew install kubecfg

To build from source:

%PATH=$PATH:$GOPATH/bin%go get github.com/bitnami/kubecfg

#Show generated YAML%kubecfg show -o yaml examples/guestbook.jsonnet#Create resources%kubecfg update examples/guestbook.jsonnet#Modify configuration (downgrade gb-frontend image)%sed -i.bak'\,gcr.io/google-samples/gb-frontend,s/:v4/:v3/' examples/guestbook.jsonnet#See differences vs server%kubecfg diff examples/guestbook.jsonnet#Update to new config%kubecfg update examples/guestbook.jsonnet#Clean up after demo%kubecfg delete examples/guestbook.jsonnet

• Supports JSON, YAML or jsonnet files (by file suffix).
• Best-effort sorts objects before updating, so that dependencies arepushed to the server before objects that refer to them.
• Additional jsonnet builtin functions. Seelib/kubecfg.libsonnet.
• Optional "garbage collection" of objects removed from config (see--gc-tag).

The idea is to describeas much as possible about your configurationas files in version control (eg: git).

Changes to the configuration follow a regular review, approve, merge,etc code change workflow (github pull-requests, phabricator diffs,etc). At any point, the config in version control captures the entiredesired-state, so the system can be easily recreated in a QA clusteror to recover from disaster.

Kubecfg relies heavily onjsonnet to describeKubernetes resources, and is really just a thin Kubernetes-specificwrapper around jsonnet evaluation. You should read the jsonnettutorial, and skim the functions available in the jsonnetstdlibrary.

• #jsonnet on Kubernetes Slack

Clickhere to sign up to the Kubernetes Slack org.