🛠 CLI Reference¶

NAME:
   helmwave - true release management for helm

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

VERSION:
   0.35.1

DESCRIPTION:
   This tool helps you compose your helm releases!
   0. $ helmwave yml
   1. $ helmwave build
   2. $ helmwave up


COMMANDS:
   yml      📄 render helmwave.yml.tpl -> helmwave.yml
   help, h  Shows a list of commands or help for one command
   BUILD:
     build     🏗 build a plan
     diff, vs  🆚 show differences
     validate  🛂 validate your plan
     graph     show graph
   DEPLOY:
     up        🚢 apply your plan
     list, ls  👀 list of deployed releases
     rollback  ⏮  rollback your plan
     status    👁️status of deployed releases
     down      🔪 delete all
   SUPPORT:
     schema        generate json schema
     version, ver  show shorts version
     completion    generate completion script

GLOBAL OPTIONS:
   --cache-dir value  base directory for cache (default: "/home/runner/.cache/helmwave") [$HELMWAVE_CACHE_DIR, $HELMWAVE_CACHE_HOME]
   --help, -h         show help
   --version, -v      print the version

   LOGGER

   --log-color         on/off color (default: true) [$HELMWAVE_LOG_COLOR]
   --log-format value  You can set: [ text | json | pad | emoji ] (default: "emoji") [$HELMWAVE_LOG_FORMAT]
   --log-level value   You can set: [ debug | info | warn  | fatal | panic | trace ] (default: "info") [$HELMWAVE_LOG_LEVEL, $HELMWAVE_LOG_LVL]
   --log-timestamps    Add timestamps to log messages (default: false) [$HELMWAVE_LOG_TIMESTAMPS]

workflow

flowchart TD step0[step 0: helmwave.yml.tpl] -- yml --> step1[step 1: helmwave.yml] -- build --> step2[step 2: .helmwave/planfile] step2 --> up(up) step2 --> down(down) step2 --> ls(ls) step2 --> s(status) step2 --> r(rollback) step2 --> g(graph) step2 --> v(validate) step2 --> diff(diff)

If you don't see a graph, please reload the page.

`yml`¶

This command renders helmwave.yml.tpl to helmwave.yml.

Flags

--file value, -f value  main yml file (default: "helmwave.yml") [$HELMWAVE_YAML, $HELMWAVE_YML]
--templater value       select template engine: [ sprig | gomplate ] (default: "sprig") [$HELMWAVE_TEMPLATER, $HELMWAVE_TEMPLATE_ENGINE]
--tpl value             main tpl file (default: "helmwave.yml.tpl") [$HELMWAVE_TPL]

`--tpl`¶

Set path to helmwave.yml.tpl

`--file`¶

Set path to helmwave.yml

`--templater`¶

Introduced in v0.17.0

You can define template engine, which will be used to render helmwave.yml file or values files.

Please visit templating reference for more details.

`build`¶

Helmwave builds plan in complete plan directory (.helmwave by default) that other commands use.

A plan includes:

Downloaded remote charts
Downloaded and templated all used values files
Rendered manifests for each release
Markdown file with dependency graph as mermaid diagram
Rendered helmwave.yml that uses plan files (e.g., downloaded chart and values)

Flags

As you can see, build command includes yml command flags. You can pass --yml flag into build command for launching yml command before building a plan.

--graph-width value        set ceil width: 1 – disable graph; 0 – full names; N>1 – show only N symbols; N<0 – drop N symbols from end. (default: 0) [$HELMWAVE_GRAPH_WIDTH]
--plandir value, -p value  path to plandir (default: ".helmwave/") [$HELMWAVE_PLANDIR, $HELMWAVE_PLAN]
--remote-source value      go-getter URL to download build sources [$HELMWAVE_REMOTE_SOURCE]
--skip-unchanged           skip unchanged releases (default: false) [$HELMWAVE_SKIP_UNCHANGED]
--3-way-merge                          show 3-way merge diff (default: false) [$HELMWAVE_DIFF_3_WAY_MERGE]
--diff-mode value                      you can set: [ live | local | none ] (default: "live") [$HELMWAVE_DIFF_MODE]
--find-renames value                   enable rename detection if set to any value greater than 0. (default: 0) [$HELMWAVE_DIFF_FIND_RENAMES]
--show-secret                          show secret in diff (default: true) [$HELMWAVE_DIFF_SHOW_SECRET]
--strip-trailing-cr                    strip trailing carriage return on input (default: false) [$HELMWAVE_DIFF_STRIP_TRAILING_CR]
--suppress value [ --suppress value ]  allows suppression of the values listed in the diff output ("Secret" for example) [$HELMWAVE_DIFF_SUPPRESS]
--wide value                           show line around changes (default: 5) [$HELMWAVE_DIFF_WIDE]
--match-all-tags                                   match all provided tags (default: false) [$HELMWAVE_MATCH_ALL_TAGS]
--tags value, -t value [ --tags value, -t value ]  build releases by tags: -t tag1 -t tag3,tag4 [$HELMWAVE_TAGS]
--file value, -f value  main yml file (default: "helmwave.yml") [$HELMWAVE_YAML, $HELMWAVE_YML]
--templater value       select template engine: [ sprig | gomplate ] (default: "sprig") [$HELMWAVE_TEMPLATER, $HELMWAVE_TEMPLATE_ENGINE]
--tpl value             main tpl file (default: "helmwave.yml.tpl") [$HELMWAVE_TPL]
--yml                   auto helmwave.yml.tpl --> helmwave.yml (default: false) [$HELMWAVE_AUTO_YML, $HELMWAVE_AUTO_YAML]

`--yml`¶

Enable execute yml command before build command.

helmwave yml                                                              
[🙃 aka INFO]: 📄 YML is ready!
        build plan with next command: helmwave build -f helmwave.yml

`--tags`¶

Allow to filter releases by tags. You can use this flag multiple times.

It works with --match-all-tags flag and tags field in helmwave.yaml file.

example

`--match-all-tags`¶

Change behavior of --tags flag. If --match-all-tags is set, then all tags should be matched. Otherwise, at least one tag should be matched.

example

`--skip-unchanged`¶

Introduced in v0.27.0

This flag will skip unchanged helm releases.

TODO: add example

`--graph-width`¶

Introduced in v0.27.1

You can change logic of graph rendering by changing this flag.

1: --graph-width=1 - disable graph rendering
2: --graph-width=0 - try to detect max width of ceil by release name
N<0: --graph-width=-10 - drop 10 symbols.
N>1: --graph-width=10 - show only first 10 symbols.

:material-docs: example

`--remote-source`¶

Introduced in v0.33.0

Remote source to use for building plan. go-getter URL format is used. The downloaded remote source is cached and the cache is reused.

`--diff-mode`¶

Introduced in v0.12.0

live - diff with live cluster
plan - diff with local plan
none - disable diff

diff example

`--wide`¶

Set wide output for diff.

TODO: add example

`--show-secret`¶

Introduced in v0.16.0

Enable showing secret values in diff output.

TODO: add example

`--3-way-merge`¶

Introduced in v0.24.4

Enable 3-way merge for diff.

TODO: add example

`--suppress`¶

Introduced in v0.35.0

Allows suppression of the values listed in the diff output

helmwave build --suppress Secret

`--strip-trailing-cr`¶

Introduced in v0.35.0

strip trailing carriage return on input

`--find-renames`¶

Introduced in v0.35.0

Enable rename detection if set to any value greater than 0.

`up`¶

Helmwave will install repositories and helm releases from a plan.

Flags

--parallel-limit value  limit amount of parallel releases (default: 0) [$HELMWAVE_PARALLEL_LIMIT]
--build                    auto build (default: false) [$HELMWAVE_AUTO_BUILD]
--graph-width value        set ceil width: 1 – disable graph; 0 – full names; N>1 – show only N symbols; N<0 – drop N symbols from end. (default: 0) [$HELMWAVE_GRAPH_WIDTH]
--plandir value, -p value  path to plandir (default: ".helmwave/") [$HELMWAVE_PLANDIR, $HELMWAVE_PLAN]
--remote-source value      go-getter URL to download build sources [$HELMWAVE_REMOTE_SOURCE]
--skip-unchanged           skip unchanged releases (default: false) [$HELMWAVE_SKIP_UNCHANGED]
--3-way-merge                          show 3-way merge diff (default: false) [$HELMWAVE_DIFF_3_WAY_MERGE]
--diff-mode value                      you can set: [ live | local | none ] (default: "live") [$HELMWAVE_DIFF_MODE]
--find-renames value                   enable rename detection if set to any value greater than 0. (default: 0) [$HELMWAVE_DIFF_FIND_RENAMES]
--show-secret                          show secret in diff (default: true) [$HELMWAVE_DIFF_SHOW_SECRET]
--strip-trailing-cr                    strip trailing carriage return on input (default: false) [$HELMWAVE_DIFF_STRIP_TRAILING_CR]
--suppress value [ --suppress value ]  allows suppression of the values listed in the diff output ("Secret" for example) [$HELMWAVE_DIFF_SUPPRESS]
--wide value                           show line around changes (default: 5) [$HELMWAVE_DIFF_WIDE]
--kubedog                        enable/disable kubedog (default: false) [$HELMWAVE_KUBEDOG_ENABLED, $HELMWAVE_KUBEDOG]
--kubedog-log-width value        set kubedog max log line width (default: 140) [$HELMWAVE_KUBEDOG_LOG_WIDTH]
--kubedog-start-delay value      delay kubedog start, don't make it too late (default: 1s) [$HELMWAVE_KUBEDOG_START_DELAY]
--kubedog-status-interval value  interval of kubedog status messages: set -1s to stop showing status progress (default: 5s) [$HELMWAVE_KUBEDOG_STATUS_INTERVAL]
--kubedog-timeout value          timeout of kubedog multitrackers (default: 5m0s) [$HELMWAVE_KUBEDOG_TIMEOUT]
--kubedog-track-all              track almost all resources, experimental (default: false) [$HELMWAVE_KUBEDOG_TRACK_ALL]
--progress                       enable progress logs of helm (INFO log level) (default: false) [$HELMWAVE_PROGRESS]
--match-all-tags                                   match all provided tags (default: false) [$HELMWAVE_MATCH_ALL_TAGS]
--tags value, -t value [ --tags value, -t value ]  build releases by tags: -t tag1 -t tag3,tag4 [$HELMWAVE_TAGS]
--file value, -f value  main yml file (default: "helmwave.yml") [$HELMWAVE_YAML, $HELMWAVE_YML]
--templater value       select template engine: [ sprig | gomplate ] (default: "sprig") [$HELMWAVE_TEMPLATER, $HELMWAVE_TEMPLATE_ENGINE]
--tpl value             main tpl file (default: "helmwave.yml.tpl") [$HELMWAVE_TPL]
--yml                   auto helmwave.yml.tpl --> helmwave.yml (default: false) [$HELMWAVE_AUTO_YML, $HELMWAVE_AUTO_YAML]

`--build`¶

Enable execute build command before.

And you can also use --yml flag that renders helmwave.yml.tpl to helmwave.yml before running --build command.

`--progress`¶

Introduced in v0.17.0

Enable helm debug progress output.

falsetrue

helmwave up --progress=false
[🙃 aka INFO]: 🗄 sync repositories...
[🙃 aka INFO]: 🗄 sync registries...
[🙃 aka INFO]: 🛥 sync releases...
[🙃 aka INFO]: 🛥 deploying... 
        release: a@my-namespace
[🙃 aka INFO]: 🛥 deploying... 
        release: b@my-namespace
[🙃 aka INFO]: ✅
    release: b@my-namespace
[🙃 aka INFO]: ✅
        release: a@my-namespace
[🙃 aka INFO]: Success 2 / 2

helmwave up --progress
[🙃 aka INFO]: 🗄 sync repositories...
[🙃 aka INFO]: 🗄 sync registries...
[🙃 aka INFO]: 🛥 sync releases...
[🙃 aka INFO]: 🛥 deploying... 
        release: a@my-namespace
[🙃 aka INFO]: 🛥 deploying... 
        release: b@my-namespace
[🙃 aka INFO]: getting history for release b
[🙃 aka INFO]: getting history for release a
[🙃 aka INFO]: preparing upgrade for b
[🙃 aka INFO]: preparing upgrade for a
[🙃 aka INFO]: performing update for a
[🙃 aka INFO]: performing update for b
[🙃 aka INFO]: creating upgraded release for a
[🙃 aka INFO]: creating upgraded release for b
[🙃 aka INFO]: checking 4 resources for changes
[🙃 aka INFO]: checking 4 resources for changes
[🙃 aka INFO]: Patch Secret "a-nats" in namespace my-namespace
[🙃 aka INFO]: Patch Secret "b-nats" in namespace my-namespace
[🙃 aka INFO]: Looks like there are no changes for Service "a-nats-headless"
[🙃 aka INFO]: Looks like there are no changes for Service "b-nats-headless"
[🙃 aka INFO]: Patch Service "a-nats" in namespace my-namespace
[🙃 aka INFO]: Patch Service "b-nats" in namespace my-namespace
[🙃 aka INFO]: Patch StatefulSet "a-nats" in namespace my-namespace
[🙃 aka INFO]: Patch StatefulSet "b-nats" in namespace my-namespace
[🙃 aka INFO]: waiting for release a resources (created: 0 updated: 4  deleted: 0)
[🙃 aka INFO]: beginning wait for 4 resources with timeout of 1m0s
[🙃 aka INFO]: waiting for release b resources (created: 0 updated: 4  deleted: 0)
[🙃 aka INFO]: beginning wait for 4 resources with timeout of 1m0s
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/a-nats. 0 out of 1 expected pods have been scheduled
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods have been scheduled
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/a-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods have been scheduled
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/a-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods have been scheduled
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/a-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods have been scheduled
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/a-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods have been scheduled
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/a-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: StatefulSet is ready: my-namespace/a-nats. 1 out of 1 expected pods are ready
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: updating status for upgraded release for a
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: ✅
        release: a@my-namespace
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: StatefulSet is not ready: my-namespace/b-nats. 0 out of 1 expected pods are ready
[🙃 aka INFO]: StatefulSet is ready: my-namespace/b-nats. 1 out of 1 expected pods are ready
[🙃 aka INFO]: updating status for upgraded release for b
[🙃 aka INFO]: ✅
        release: b@my-namespace
[🙃 aka INFO]: Success 2 / 2

`--parallel-limit`¶

Introduced in v0.20.0

Limit the number of parallel helm operations.

Introduced in v0.8.0

`--kubedog`¶

Enable kubedog.

`--kubedog-status-interval`¶

Set interval for kubedog status.

`--kubedog-start-delay`¶

Set delay before kubedog will start.

`--kubedog-timeout`¶

Set timeout for kubedog.

`--kubedog-log-width`¶

Set width of kubedog logboek.

`--kubedog-track-all`¶

Introduced in v0.30.0

Track all resources, not only Deployment, DaemonSet, StatefulSet, Job. Annotations are also respected for these resources but it wasn't tested.

It will probably fail for some non-namespaced custom resources because kubedog can track only namespaced resources. In this case kubedog will fail with a warning

`down`¶

Introduced in v0.12.2

Helmwave will uninstall helm releases from plan.

Flags

--build                    auto build (default: false) [$HELMWAVE_AUTO_BUILD]
--graph-width value        set ceil width: 1 – disable graph; 0 – full names; N>1 – show only N symbols; N<0 – drop N symbols from end. (default: 0) [$HELMWAVE_GRAPH_WIDTH]
--plandir value, -p value  path to plandir (default: ".helmwave/") [$HELMWAVE_PLANDIR, $HELMWAVE_PLAN]
--remote-source value      go-getter URL to download build sources [$HELMWAVE_REMOTE_SOURCE]
--skip-unchanged           skip unchanged releases (default: false) [$HELMWAVE_SKIP_UNCHANGED]
--3-way-merge                          show 3-way merge diff (default: false) [$HELMWAVE_DIFF_3_WAY_MERGE]
--diff-mode value                      you can set: [ live | local | none ] (default: "live") [$HELMWAVE_DIFF_MODE]
--find-renames value                   enable rename detection if set to any value greater than 0. (default: 0) [$HELMWAVE_DIFF_FIND_RENAMES]
--show-secret                          show secret in diff (default: true) [$HELMWAVE_DIFF_SHOW_SECRET]
--strip-trailing-cr                    strip trailing carriage return on input (default: false) [$HELMWAVE_DIFF_STRIP_TRAILING_CR]
--suppress value [ --suppress value ]  allows suppression of the values listed in the diff output ("Secret" for example) [$HELMWAVE_DIFF_SUPPRESS]
--wide value                           show line around changes (default: 5) [$HELMWAVE_DIFF_WIDE]
--match-all-tags                                   match all provided tags (default: false) [$HELMWAVE_MATCH_ALL_TAGS]
--tags value, -t value [ --tags value, -t value ]  build releases by tags: -t tag1 -t tag3,tag4 [$HELMWAVE_TAGS]
--file value, -f value  main yml file (default: "helmwave.yml") [$HELMWAVE_YAML, $HELMWAVE_YML]
--templater value       select template engine: [ sprig | gomplate ] (default: "sprig") [$HELMWAVE_TEMPLATER, $HELMWAVE_TEMPLATE_ENGINE]
--tpl value             main tpl file (default: "helmwave.yml.tpl") [$HELMWAVE_TPL]
--yml                   auto helmwave.yml.tpl --> helmwave.yml (default: false) [$HELMWAVE_AUTO_YML, $HELMWAVE_AUTO_YAML]

$ helmwave down      
[🙃 aka INFO]: ✅ frontend@test uninstalled!
[🙃 aka INFO]: ✅ database@test uninstalled!
[🙃 aka INFO]: ✅ backend@test uninstalled!

`ls`¶

Introduced in v0.11.0

Helmwave will get a list of helm releases from a plan.

Flags

--build                    auto build (default: false) [$HELMWAVE_AUTO_BUILD]
--graph-width value        set ceil width: 1 – disable graph; 0 – full names; N>1 – show only N symbols; N<0 – drop N symbols from end. (default: 0) [$HELMWAVE_GRAPH_WIDTH]
--plandir value, -p value  path to plandir (default: ".helmwave/") [$HELMWAVE_PLANDIR, $HELMWAVE_PLAN]
--remote-source value      go-getter URL to download build sources [$HELMWAVE_REMOTE_SOURCE]
--skip-unchanged           skip unchanged releases (default: false) [$HELMWAVE_SKIP_UNCHANGED]
--3-way-merge                          show 3-way merge diff (default: false) [$HELMWAVE_DIFF_3_WAY_MERGE]
--diff-mode value                      you can set: [ live | local | none ] (default: "live") [$HELMWAVE_DIFF_MODE]
--find-renames value                   enable rename detection if set to any value greater than 0. (default: 0) [$HELMWAVE_DIFF_FIND_RENAMES]
--show-secret                          show secret in diff (default: true) [$HELMWAVE_DIFF_SHOW_SECRET]
--strip-trailing-cr                    strip trailing carriage return on input (default: false) [$HELMWAVE_DIFF_STRIP_TRAILING_CR]
--suppress value [ --suppress value ]  allows suppression of the values listed in the diff output ("Secret" for example) [$HELMWAVE_DIFF_SUPPRESS]
--wide value                           show line around changes (default: 5) [$HELMWAVE_DIFF_WIDE]
--match-all-tags                                   match all provided tags (default: false) [$HELMWAVE_MATCH_ALL_TAGS]
--tags value, -t value [ --tags value, -t value ]  build releases by tags: -t tag1 -t tag3,tag4 [$HELMWAVE_TAGS]
--file value, -f value  main yml file (default: "helmwave.yml") [$HELMWAVE_YAML, $HELMWAVE_YML]
--templater value       select template engine: [ sprig | gomplate ] (default: "sprig") [$HELMWAVE_TEMPLATER, $HELMWAVE_TEMPLATE_ENGINE]
--tpl value             main tpl file (default: "helmwave.yml.tpl") [$HELMWAVE_TPL]
--yml                   auto helmwave.yml.tpl --> helmwave.yml (default: false) [$HELMWAVE_AUTO_YML, $HELMWAVE_AUTO_YAML]

$ helmwave ls      
[🙃 aka INFO]: Should be 3 releases
   NAME    | NAMESPACE | REVISION |            UPDATED             |  STATUS  | CHART | VERSION  
-----------+-----------+----------+--------------------------------+----------+-------+----------
  frontend | test      |        1 | 2021-11-10 04:41:23.330989     | deployed | this  | 0.1.0    
           |           |          | +0300 MSK                      |          |       |          
  database | test      |        1 | 2021-11-10 04:41:23.353473     | deployed | this  | 0.1.0    
           |           |          | +0300 MSK                      |          |       |          
  backend  | test      |        1 | 2021-11-10 04:41:23.270076     | deployed | this  | 0.1.0    
           |           |          | +0300 MSK                      |          |       |

`status`¶

Introduced in v0.11.0

Helmwave try getting status of helm releases from a plan.

Flags

--build                    auto build (default: false) [$HELMWAVE_AUTO_BUILD]
--graph-width value        set ceil width: 1 – disable graph; 0 – full names; N>1 – show only N symbols; N<0 – drop N symbols from end. (default: 0) [$HELMWAVE_GRAPH_WIDTH]
--plandir value, -p value  path to plandir (default: ".helmwave/") [$HELMWAVE_PLANDIR, $HELMWAVE_PLAN]
--remote-source value      go-getter URL to download build sources [$HELMWAVE_REMOTE_SOURCE]
--skip-unchanged           skip unchanged releases (default: false) [$HELMWAVE_SKIP_UNCHANGED]
--3-way-merge                          show 3-way merge diff (default: false) [$HELMWAVE_DIFF_3_WAY_MERGE]
--diff-mode value                      you can set: [ live | local | none ] (default: "live") [$HELMWAVE_DIFF_MODE]
--find-renames value                   enable rename detection if set to any value greater than 0. (default: 0) [$HELMWAVE_DIFF_FIND_RENAMES]
--show-secret                          show secret in diff (default: true) [$HELMWAVE_DIFF_SHOW_SECRET]
--strip-trailing-cr                    strip trailing carriage return on input (default: false) [$HELMWAVE_DIFF_STRIP_TRAILING_CR]
--suppress value [ --suppress value ]  allows suppression of the values listed in the diff output ("Secret" for example) [$HELMWAVE_DIFF_SUPPRESS]
--wide value                           show line around changes (default: 5) [$HELMWAVE_DIFF_WIDE]
--match-all-tags                                   match all provided tags (default: false) [$HELMWAVE_MATCH_ALL_TAGS]
--tags value, -t value [ --tags value, -t value ]  build releases by tags: -t tag1 -t tag3,tag4 [$HELMWAVE_TAGS]
--file value, -f value  main yml file (default: "helmwave.yml") [$HELMWAVE_YAML, $HELMWAVE_YML]
--templater value       select template engine: [ sprig | gomplate ] (default: "sprig") [$HELMWAVE_TEMPLATER, $HELMWAVE_TEMPLATE_ENGINE]
--tpl value             main tpl file (default: "helmwave.yml.tpl") [$HELMWAVE_TPL]
--yml                   auto helmwave.yml.tpl --> helmwave.yml (default: false) [$HELMWAVE_AUTO_YML, $HELMWAVE_AUTO_YAML]

$ helmwave status      
[🙃 aka INFO]: Status of frontend@test
        status: deployed
        revision: 1
        name: frontend
        namespace: test
        chart: frontend-0.1.0
        last deployed: 2021-11-10 04:41:23.330989 +0300 MSK
[🙃 aka INFO]: Status of database@test
        status: deployed
        revision: 1
        name: database
        namespace: test
        chart: database-0.1.0
        last deployed: 2021-11-10 04:41:23.353473 +0300 MSK
[🙃 aka INFO]: Status of backend@test
        name: backend
        namespace: test
        chart: backend-0.1.0
        last deployed: 2021-11-10 04:41:23.270076 +0300 MSK
        status: deployed
        revision: 1

`rollback`¶

Introduced in v0.12.0

Rollback helm releases from a plan.

Flags

--revision value                                   rollback all releases to this revision (default: -1)
--build                    auto build (default: false) [$HELMWAVE_AUTO_BUILD]
--graph-width value        set ceil width: 1 – disable graph; 0 – full names; N>1 – show only N symbols; N<0 – drop N symbols from end. (default: 0) [$HELMWAVE_GRAPH_WIDTH]
--plandir value, -p value  path to plandir (default: ".helmwave/") [$HELMWAVE_PLANDIR, $HELMWAVE_PLAN]
--remote-source value      go-getter URL to download build sources [$HELMWAVE_REMOTE_SOURCE]
--skip-unchanged           skip unchanged releases (default: false) [$HELMWAVE_SKIP_UNCHANGED]
--3-way-merge                          show 3-way merge diff (default: false) [$HELMWAVE_DIFF_3_WAY_MERGE]
--diff-mode value                      you can set: [ live | local | none ] (default: "live") [$HELMWAVE_DIFF_MODE]
--find-renames value                   enable rename detection if set to any value greater than 0. (default: 0) [$HELMWAVE_DIFF_FIND_RENAMES]
--show-secret                          show secret in diff (default: true) [$HELMWAVE_DIFF_SHOW_SECRET]
--strip-trailing-cr                    strip trailing carriage return on input (default: false) [$HELMWAVE_DIFF_STRIP_TRAILING_CR]
--suppress value [ --suppress value ]  allows suppression of the values listed in the diff output ("Secret" for example) [$HELMWAVE_DIFF_SUPPRESS]
--wide value                           show line around changes (default: 5) [$HELMWAVE_DIFF_WIDE]
--kubedog                        enable/disable kubedog (default: false) [$HELMWAVE_KUBEDOG_ENABLED, $HELMWAVE_KUBEDOG]
--kubedog-log-width value        set kubedog max log line width (default: 140) [$HELMWAVE_KUBEDOG_LOG_WIDTH]
--kubedog-start-delay value      delay kubedog start, don't make it too late (default: 1s) [$HELMWAVE_KUBEDOG_START_DELAY]
--kubedog-status-interval value  interval of kubedog status messages: set -1s to stop showing status progress (default: 5s) [$HELMWAVE_KUBEDOG_STATUS_INTERVAL]
--kubedog-timeout value          timeout of kubedog multitrackers (default: 5m0s) [$HELMWAVE_KUBEDOG_TIMEOUT]
--kubedog-track-all              track almost all resources, experimental (default: false) [$HELMWAVE_KUBEDOG_TRACK_ALL]
--match-all-tags                                   match all provided tags (default: false) [$HELMWAVE_MATCH_ALL_TAGS]
--tags value, -t value [ --tags value, -t value ]  build releases by tags: -t tag1 -t tag3,tag4 [$HELMWAVE_TAGS]
--file value, -f value  main yml file (default: "helmwave.yml") [$HELMWAVE_YAML, $HELMWAVE_YML]
--templater value       select template engine: [ sprig | gomplate ] (default: "sprig") [$HELMWAVE_TEMPLATER, $HELMWAVE_TEMPLATE_ENGINE]
--tpl value             main tpl file (default: "helmwave.yml.tpl") [$HELMWAVE_TPL]
--yml                   auto helmwave.yml.tpl --> helmwave.yml (default: false) [$HELMWAVE_AUTO_YML, $HELMWAVE_AUTO_YAML]

`--revision`¶

Rollback all releases to specific revision.

Introduced in v0.30.0

`--kubedog`¶

Enable kubedog.

`--kubedog-status-interval`¶

Set interval for kubedog status.

`--kubedog-start-delay`¶

Set delay before kubedog will start.

`--kubedog-timeout`¶

Set timeout for kubedog.

`--kubedog-log-width`¶

Set width of kubedog logboek.

`--kubedog-track-all`¶

Introduced in v0.30.0

Track all resources, not only Deployment, DaemonSet, StatefulSet, Job. Annotations are also respected for these resources but it wasn't tested.

It will probably fail for some non-namespaced custom resources because kubedog can track only namespaced resources. In this case kubedog will fail with a warning

$ helmwave rollback      
[🙃 aka INFO]: ✅ frontend@test rollback!
[🙃 aka INFO]: ✅ database@test rollback!
[🙃 aka INFO]: ✅ backend@test rollback!

`graph`¶

Introduced in v0.27.2

Show only graph of helm releases from plan. Graph draws with helmwave/asciigraph

Flags

--build                    auto build (default: false) [$HELMWAVE_AUTO_BUILD]
--graph-width value        set ceil width: 1 – disable graph; 0 – full names; N>1 – show only N symbols; N<0 – drop N symbols from end. (default: 0) [$HELMWAVE_GRAPH_WIDTH]
--plandir value, -p value  path to plandir (default: ".helmwave/") [$HELMWAVE_PLANDIR, $HELMWAVE_PLAN]
--remote-source value      go-getter URL to download build sources [$HELMWAVE_REMOTE_SOURCE]
--skip-unchanged           skip unchanged releases (default: false) [$HELMWAVE_SKIP_UNCHANGED]
--3-way-merge                          show 3-way merge diff (default: false) [$HELMWAVE_DIFF_3_WAY_MERGE]
--diff-mode value                      you can set: [ live | local | none ] (default: "live") [$HELMWAVE_DIFF_MODE]
--find-renames value                   enable rename detection if set to any value greater than 0. (default: 0) [$HELMWAVE_DIFF_FIND_RENAMES]
--show-secret                          show secret in diff (default: true) [$HELMWAVE_DIFF_SHOW_SECRET]
--strip-trailing-cr                    strip trailing carriage return on input (default: false) [$HELMWAVE_DIFF_STRIP_TRAILING_CR]
--suppress value [ --suppress value ]  allows suppression of the values listed in the diff output ("Secret" for example) [$HELMWAVE_DIFF_SUPPRESS]
--wide value                           show line around changes (default: 5) [$HELMWAVE_DIFF_WIDE]
--match-all-tags                                   match all provided tags (default: false) [$HELMWAVE_MATCH_ALL_TAGS]
--tags value, -t value [ --tags value, -t value ]  build releases by tags: -t tag1 -t tag3,tag4 [$HELMWAVE_TAGS]
--file value, -f value  main yml file (default: "helmwave.yml") [$HELMWAVE_YAML, $HELMWAVE_YML]
--templater value       select template engine: [ sprig | gomplate ] (default: "sprig") [$HELMWAVE_TEMPLATER, $HELMWAVE_TEMPLATE_ENGINE]
--tpl value             main tpl file (default: "helmwave.yml.tpl") [$HELMWAVE_TPL]
--yml                   auto helmwave.yml.tpl --> helmwave.yml (default: false) [$HELMWAVE_AUTO_YML, $HELMWAVE_AUTO_YAML]

`--graph-width`¶

Introduced in v0.27.1

You can change logic of graph rendering by changing this flag.

1: --graph-width=1 - disable graph rendering
2: --graph-width=0 - try to detect max width of ceil by release name
N<0: --graph-width=-10 - drop 10 symbols.
N>1: --graph-width=10 - show only first 10 symbols.

:material-docs: example

`validate`¶

Introduced in v0.12.0

Helmwave will validate a plan. Helmwave always validates plan before any command.

Flags

--plandir value, -p value  path to plandir (default: ".helmwave/") [$HELMWAVE_PLANDIR, $HELMWAVE_PLAN]

$ helmwave validate                                                          
$ echo $?                   
0

`diff`¶

Introduced in v0.18.0

Flags

--3-way-merge                          show 3-way merge diff (default: false) [$HELMWAVE_DIFF_3_WAY_MERGE]
--find-renames value                   enable rename detection if set to any value greater than 0. (default: 0) [$HELMWAVE_DIFF_FIND_RENAMES]
--show-secret                          show secret in diff (default: true) [$HELMWAVE_DIFF_SHOW_SECRET]
--strip-trailing-cr                    strip trailing carriage return on input (default: false) [$HELMWAVE_DIFF_STRIP_TRAILING_CR]
--suppress value [ --suppress value ]  allows suppression of the values listed in the diff output ("Secret" for example) [$HELMWAVE_DIFF_SUPPRESS]
--wide value                           show line around changes (default: 5) [$HELMWAVE_DIFF_WIDE]

`--wide`¶

Set wide output for diff.

TODO: add example

`--show-secret`¶

Introduced in v0.16.0

Enable showing secret values in diff output.

TODO: add example

`--3-way-merge`¶

Introduced in v0.24.4

Enable 3-way merge for diff.

TODO: add example

`--suppress`¶

Introduced in v0.35.0

Allows suppression of the values listed in the diff output

helmwave build --suppress Secret

`--strip-trailing-cr`¶

Introduced in v0.35.0

strip trailing carriage return on input

`--find-renames`¶

Introduced in v0.35.0

Enable rename detection if set to any value greater than 0.

Diff has 2 subcommands plan and live.

liveplan

This command will diff with manifests in the kubernetes cluster

options

--plandir value, -p value  path to plandir (default: ".helmwave/") [$HELMWAVE_PLANDIR, $HELMWAVE_PLAN]
--3-way-merge  show 3-way merge diff (default: false) [$HELMWAVE_DIFF_3_WAY_MERGE]

helmwave diff live

This command will diff with local plan

options

--plandir1 value  path to plandir1 (default: ".helmwave/") [$HELMWAVE_PLANDIR_1, $HELMWAVE_PLANDIR]
--plandir2 value  path to plandir2 (default: ".helmwave/") [$HELMWAVE_PLANDIR_2]

helmwave diff plan

`version`¶

Get version of current helmwave.

Long versionShort version

$ helmwave --version  
helmwave version 0.35.1

$ helmwave -v
helmwave version 0.35.1

$ helmwave version
0.35.1

$ helmwave ver
0.35.1

`completion`¶

Generates scripts for shell completion.

bash zsh

Add this code to your ~/.bashrc

source <(helmwave completion bash)

echo "source <(helmwave completion bash)" >> ~/.bashrc

bash completion example

Add this code to your ~/.zshrc

source <(helmwave completion zsh)

echo "source <(helmwave completion zsh)" >> ~/.zshrc

zsh completion example

`schema`¶

You can generate json schema for autocomplete and validate helmwave.yml in your IDE.

helmwave schema > helmwave.schema.json

🏳️ Global flags¶

Global flags available in any command.

Flags

--log-color         on/off color (default: true) [$HELMWAVE_LOG_COLOR]
--log-format value  You can set: [ text | json | pad | emoji ] (default: "emoji") [$HELMWAVE_LOG_FORMAT]
--log-level value   You can set: [ debug | info | warn  | fatal | panic | trace ] (default: "info") [$HELMWAVE_LOG_LEVEL, $HELMWAVE_LOG_LVL]
--log-timestamps    Add timestamps to log messages (default: false) [$HELMWAVE_LOG_TIMESTAMPS]

Helmwave uses sirupsen/logrus as internal logger.

`--cache-dir`¶

Introduced in v0.33.0

The directory to use for storing remote sources.

`--log-format`¶

Helmwave supports different log formatters

features	`text`	`json`	`pad`	`emoji` (default)
Color	✅	❌	✅	🌈
Human readable	🧐	🤖	🧐🧐	✅
Performance	🚀	🐢	✈️	🐢
Module	TextFormatter (in-built `logrus` formatter)	JSONFormatter (in-built `logrus` formatter)	TextFormatter (in-built `logrus` formatter)	logrus-emoji-formatter special for helmwave

textjsonpademoji

$ helmwave --log-format text build -f docs/examples/quick-start/helmwave.yml
INFO 🔨 Building releases...                       
INFO 🔨 Building graphs...                         
INFO show graph:
┌─────────────────┐
│ a@my-namespace  │
└─────────────────┘



┌─────────────────┐
│ b@my-namespace  │
└─────────────────┘ 
INFO 🔨 Building values...                         
INFO 🔨 no values provided                          release=a@my-namespace
INFO 🔨 no values provided                          release=b@my-namespace
INFO 🔨 Building repositories...                   
INFO 🔨 Building registries...                     
INFO 🗄 registry has been added to the plan         registry=registry-1.docker.io
INFO 🔨 Building charts...                         
INFO Pulled: registry-1.docker.io/bitnamicharts/nats:7.8.3 
INFO Digest: sha256:5f80350b8a85177e4a9c7ed968f77c47bedcc461418172fb66594bc61fa1ffac 
INFO Pulled: registry-1.docker.io/bitnamicharts/nats:7.8.3 
INFO Digest: sha256:5f80350b8a85177e4a9c7ed968f77c47bedcc461418172fb66594bc61fa1ffac 
INFO 🔨 Building manifests...                      
INFO ❎ skipping updating dependencies for remote chart  release=b@my-namespace
INFO ❎ skipping updating dependencies for remote chart  release=a@my-namespace
INFO Pulled: registry-1.docker.io/bitnamicharts/nats:7.8.3 
INFO Digest: sha256:5f80350b8a85177e4a9c7ed968f77c47bedcc461418172fb66594bc61fa1ffac 
INFO Pulled: registry-1.docker.io/bitnamicharts/nats:7.8.3 
INFO Digest: sha256:5f80350b8a85177e4a9c7ed968f77c47bedcc461418172fb66594bc61fa1ffac
...

$ helmwave --log-format json build -f docs/examples/quick-start/helmwave.yml
{
  "level": "info",
  "msg": "🔨 Building releases...",
}
{
  "level": "info",
  "msg": "🔨 Building graphs...",
}
{
  "level": "info",
  "msg": "show graph:\n┌─────────────────┐\n│ a@my-namespace  │\n└─────────────────┘\n                   \n                   \n                   \n┌─────────────────┐\n│ b@my-namespace  │\n└─────────────────┘\n",
}
{
  "level": "info",
  "msg": "🔨 Building values...",
}

$ helmwave --log-format pad build -f docs/examples/quick-start/helmwave.yml
INFO    🔨 Building releases...                       
INFO    🔨 Building graphs...                         
INFO    show graph:
┌─────────────────┐
│ a@my-namespace  │
└─────────────────┘



┌─────────────────┐
│ b@my-namespace  │
└─────────────────┘ 
INFO    🔨 Building values...                         
INFO    🔨 no values provided                          release=b@my-namespace
INFO    🔨 no values provided                          release=a@my-namespace
INFO    🔨 Building repositories...                   
INFO    🔨 Building registries...                     
INFO    🗄 registry has been added to the plan         registry=registry-1.docker.io
INFO    🔨 Building charts...

$ helmwave --log-format emoji build -f docs/examples/quick-start/helmwave.yml
[🙃 aka INFO]: 🔨 Building releases...
[🙃 aka INFO]: 🔨 Building graphs...
[🙃 aka INFO]: show graph:
┌─────────────────┐
│ a@my-namespace  │
└─────────────────┘



┌─────────────────┐
│ b@my-namespace  │
└─────────────────┘

[🙃 aka INFO]: 🔨 Building values...
[🙃 aka INFO]: 🔨 no values provided
        release: b@my-namespace
[🙃 aka INFO]: 🔨 no values provided
        release: a@my-namespace
[🙃 aka INFO]: 🔨 Building repositories...
[🙃 aka INFO]: 🔨 Building registries...
[🙃 aka INFO]: 🗄 registry has been added to the plan
        registry: registry-1.docker.io
[🙃 aka INFO]: 🔨 Building charts...
[🙃 aka INFO]: Pulled: registry-1.docker.io/bitnamicharts/nats:7.8.3

`--log-level`¶

This option manage how much information you want to get. This modern way instead of verbose (-vvvvv) logging.

_	`info` (default)	`debug`	`warn`	`fatal`	`panic`	`trace`
general info	✅	✅	✅	✅	✅	✅
incompatible version	❌	✅	✅	✅	✅	✅
helm-debug without `--progress`	❌	✅	✅	✅	✅	✅
helm-debug with `--progress`	✅	✅	✅	✅	✅	✅
lifecycle hooks `show=true`	✅	✅	✅	✅	✅	✅
lifecycle hooks `show=false`	❌	✅	✅	✅	✅	✅
file content	❌	✅	❌	✅	✅	✅
helm manifests, bug report	❌	❌	❌	❌	❌	✅

`--log-color`¶

Enable/Disable color in output.

--log-color=false--log-color=true

output with disabled log colors

output with enabled log colors

`--log-timestamps`¶

Add additional block with timestamp information in logs.

textjsonemoji

helmwave --log-timestamps --log-format text build -f docs/examples/quick-start/helmwave.yml 
INFO[2023-06-19T05:51:32+04:00] 🔨 Building releases...                       
INFO[2023-06-19T05:51:32+04:00] 🔨 Building graphs...                         
INFO[2023-06-19T05:51:32+04:00] show graph:
┌─────────────────┐
│ a@my-namespace  │
└─────────────────┘



┌─────────────────┐
│ b@my-namespace  │
└─────────────────┘ 
INFO[2023-06-19T05:51:32+04:00] 🔨 Building values...                         
INFO[2023-06-19T05:51:32+04:00] 🔨 no values provided                          release=b@my-namespace
INFO[2023-06-19T05:51:32+04:00] 🔨 no values provided                          release=a@my-namespace
INFO[2023-06-19T05:51:32+04:00] 🔨 Building repositories...                   
INFO[2023-06-19T05:51:32+04:00] 🔨 Building registries...                     
INFO[2023-06-19T05:51:32+04:00] 🗄 registry has been added to the plan         registry=registry-1.docker.io
INFO[2023-06-19T05:51:32+04:00] 🔨 Building charts...                         
INFO[2023-06-19T05:51:34+04:00] Pulled: registry-1.docker.io/bitnamicharts/nats:7.8.3

helmwave --log-timestamps --log-format json build -f docs/examples/quick-start/helmwave.yml 
{
  "level": "info",
  "msg": "🔨 Building releases...",
  "time": "2023-06-19T05:52:24+04:00"
}
{
  "level": "info",
  "msg": "🔨 Building graphs...",
  "time": "2023-06-19T05:52:24+04:00"
}
{
  "level": "info",
  "msg": "show graph:\n┌─────────────────┐\n│ a@my-namespace  │\n└─────────────────┘\n                   \n                   \n                   \n┌─────────────────┐\n│ b@my-namespace  │\n└─────────────────┘\n",
  "time": "2023-06-19T05:52:24+04:00"
}
{
  "level": "info",
  "msg": "🔨 Building values...",
  "time": "2023-06-19T05:52:24+04:00"
}
{
  "level": "info",
  "msg": "🔨 no values provided",
  "release": "b@my-namespace",
  "time": "2023-06-19T05:52:24+04:00"
}
{
  "level": "info",
  "msg": "🔨 no values provided",
  "release": "a@my-namespace",
  "time": "2023-06-19T05:52:24+04:00"
}
{
  "level": "info",
  "msg": "🔨 Building repositories...",
  "time": "2023-06-19T05:52:24+04:00"
}
{
  "level": "info",
  "msg": "🔨 Building registries...",
  "time": "2023-06-19T05:52:24+04:00"
}

$ helmwave --log-timestamps build -f docs/examples/quick-start/helmwave.yml 
[2023-06-19T03:31:18+04:00] [🙃 aka INFO]: 🔨 Building releases...
[2023-06-19T03:31:18+04:00] [🙃 aka INFO]: 🔨 Building graphs...
[2023-06-19T03:31:18+04:00] [🙃 aka INFO]: show graph:
┌─────────────────┐
│ a@my-namespace  │
└─────────────────┘



┌─────────────────┐
│ b@my-namespace  │
└─────────────────┘

[2023-06-19T03:31:18+04:00] [🙃 aka INFO]: 🔨 Building values...
[2023-06-19T03:31:18+04:00] [🙃 aka INFO]: 🔨 no values provided
        release: b@my-namespace
[2023-06-19T03:31:18+04:00] [🙃 aka INFO]: 🔨 no values provided
        release: a@my-namespace
[2023-06-19T03:31:18+04:00] [🙃 aka INFO]: 🔨 Building repositories...

🛠 CLI Reference¶

yml¶

--tpl¶

--file¶

--templater¶

build¶

--yml¶

--tags¶

--match-all-tags¶

--skip-unchanged¶

--graph-width¶

--remote-source¶

--diff-mode¶

--wide¶

--show-secret¶

--3-way-merge¶

--suppress¶

--strip-trailing-cr¶

--find-renames¶

up¶

--build¶

--progress¶

--parallel-limit¶

--kubedog¶

--kubedog-status-interval¶

--kubedog-start-delay¶

--kubedog-timeout¶

--kubedog-log-width¶

--kubedog-track-all¶

down¶

ls¶

status¶

rollback¶

--revision¶

--kubedog¶

--kubedog-status-interval¶

--kubedog-start-delay¶

--kubedog-timeout¶

--kubedog-log-width¶

--kubedog-track-all¶

graph¶

--graph-width¶

validate¶

diff¶

--wide¶

--show-secret¶

--3-way-merge¶

--suppress¶

--strip-trailing-cr¶

--find-renames¶

version¶

completion¶

schema¶

🏳️ Global flags¶

--cache-dir¶

--log-format¶

--log-level¶

--log-color¶

--log-timestamps¶

`yml`¶

`--tpl`¶

`--file`¶

`--templater`¶

`build`¶

`--yml`¶

`--tags`¶

`--match-all-tags`¶

`--skip-unchanged`¶

`--graph-width`¶

`--remote-source`¶

`--diff-mode`¶

`--wide`¶

`--show-secret`¶

`--3-way-merge`¶

`--suppress`¶

`--strip-trailing-cr`¶

`--find-renames`¶

`up`¶

`--build`¶

`--progress`¶

`--parallel-limit`¶

`--kubedog`¶

`--kubedog-status-interval`¶

`--kubedog-start-delay`¶

`--kubedog-timeout`¶

`--kubedog-log-width`¶

`--kubedog-track-all`¶

`down`¶

`ls`¶

`status`¶

`rollback`¶

`--revision`¶

`--kubedog`¶

`--kubedog-status-interval`¶

`--kubedog-start-delay`¶

`--kubedog-timeout`¶

`--kubedog-log-width`¶

`--kubedog-track-all`¶

`graph`¶

`--graph-width`¶

`validate`¶

`diff`¶

`--wide`¶

`--show-secret`¶

`--3-way-merge`¶

`--suppress`¶

`--strip-trailing-cr`¶

`--find-renames`¶

`version`¶

`completion`¶

`schema`¶

`--cache-dir`¶

`--log-format`¶

`--log-level`¶

`--log-color`¶

`--log-timestamps`¶