Declaratively deploy your Kubernetes manifests, Kustomize configs, and Charts as Helm releases in one shot

Go to file

Justin Nauman 2e914c652a Relative path resolution changes This aims to improve on relative, absolute and <repo>/<chart> resolution for several of Helmfile manifest attributes as well as command line arguments. - Uusers may now utilize the `-f <filepath>` flag to reference a helmfile manifest outside of their PWD and have relative paths in the the `charts[].values` and `charts[].chart` attribute resolve relative to the manfiest's location properly - Values provided in the `--values` argument are no longer automatically assumed as relative path references from PWD but instead are conditionally joined with the PWD if it is determined they are relative file paths - Users may still signify a chart in the `.charts[*].chart` attribute as they do now by having an explicit `<repo>/<chart>` value		2017-09-06 23:03:37 -05:00
helmexec	Relative path resolution changes	2017-09-06 23:03:37 -05:00
state	Relative path resolution changes	2017-09-06 23:03:37 -05:00
vendor	vendor: add deps	2016-11-22 12:37:41 -05:00
.gitignore	ignore dist	2017-04-12 11:22:19 -04:00
Dockerfile	container: add helm	2016-11-22 21:40:24 -05:00
Makefile	ignore standard ignores	2017-04-19 15:31:15 -04:00
README.md	Adding in details around the diff subcommand	2017-08-28 17:38:32 -05:00
circle.yml	build: add docker login	2016-11-22 21:40:50 -05:00
main.go	Adding in option to pass in --args	2017-08-31 16:56:39 -05:00

README.md

helmfile

Deploy Kubernetes Helm Charts

about

Helmfile is a declarative spec for deploying helm charts. It lets you...

Keep a directory of chart value files and maintain changes in version control.
Apply CI/CD to configuration changes.
Periodically sync to avoid skew in environments.

To avoid upgrades for each iteration of helm, the helmfile executable delegates to helm - as a result, helm must be installed.

The default helmfile is charts.yaml:

repositories:
  - name: roboll
    url: http://roboll.io/charts

charts:
  - name: vault                          # helm deployment name
    namespace: vault                     # target namespace
    chart: roboll/vault-secret-manager   # chart reference
    values: [ vault.yaml ]               # value files (--values)
    set:                                 # values (--set)
      - name: address
        value: https://vault.example.com
    env:                                 # values (--set) but value will be pulled from environment variables. Will throw an error if the environment variable is not set.
      - name: db.password
        value: DB_PASSWORD               # $DB_PASSOWRD needs to be set in the calling environment ex: export DB_PASSWORD='password1'

install

go get github.com/roboll/helmfile or releases or container

usage

NAME:
   helmfile -

USAGE:
   main [global options] command [command options] [arguments...]

COMMANDS:
     repos   sync repositories from state file (helm repo add && helm repo update)
     charts  sync charts from state file (helm repo upgrade --install)
     diff    diff charts from state file against env (helm diff)
     sync    sync all resources from state file (repos && charts)
     delete  delete charts from state file (helm delete)

GLOBAL OPTIONS:
   --file FILE, -f FILE  load config from FILE (default: "charts.yaml")
   --quiet, -q           silence output
   --kube-context value  Set kubectl context. Uses current context by default
   --help, -h            show help
   --version, -v         print the version

diff

The helmfile diff sub-command executes the helm-diff plugin across all of the charts/releases defined in the manifest.

Under the covers Helmfile is simply using the helm diff plugin, so that needs to be installed prior. For Helm 2.3+ you should be able to simply execute helm plugin install https://github.com/databus23/helm-diff. For more details please look at their documentation.