Helm v3.7.0 is a feature release. Users are encouraged to upgrade for the best experience.

The community keeps growing, and we'd love to see you there!

• Join the discussion in Kubernetes Slack:
  • for questions and just to hang out
  • for discussing PRs, code, and bugs
• Hang out at the Public Developer Call: Thursday, 9:30 Pacific via Zoom
• Test, debug, and contribute charts: ArtifactHub/packages

Notable Changes

A few major changes were made to the experimental OCI feature:

• helm chart export has been removed
• helm chart list has been removed
• helm chart pull has been replaced with helm pull
• helm chart push has been replaced with helm push
• helm chart remove has been removed
• helm chart save has been replaced with helm package

In addition, a change to the experimental OCI manifest format was introduced, preventing Helm 3.7 from fetching charts built
with older versions of the experimental OCI feature. Users will need to re-package and upload their OCI charts when upgrading to Helm 3.7. This change does not affect standard Helm charts.

Many of the details of these changes can be found in HIP 6.

Other notable changes:

• introduced helm uninstall --wait
• introduced helm show crds
• introduced --max-col-width to helm dependency list
• introduced --password-stdin to helm repo add
• helm install and helm upgrade now respond to SIGTERM events
• helm repo update now accepts an optional repository name
• introduced {{ .Chart.IsRoot }} to the template engine
• updated to Cobra's Bash Completion v2
• updated to Kubernetes 1.22 client packages
• updated to Go 1.16

Installation and Upgrading

Download Helm v3.7.0. The common platform binaries are here:

• MacOS amd64 (checksum / 0bf671be69563a0c2b4253c393bed271fab90a4aa9321d09685a781f583b5c9d)
• MacOS arm64 (checksum / 6968d3488cf36cae00b33c3b5799a9cfa0211270ce6f90d61a5ced5eeb54c635)
• Linux amd64 (checksum / 096e30f54c3ccdabe30a8093f8e128dba76bb67af697b85db6ed0453a2701bf9)
• Linux arm (checksum / c9609757e56fa11036da469c0b7f21b6e21f05618bc437451050a8507441fe1b)
• Linux arm64 (checksum / 03bf55435b4ebef739f862334bdfbf7b7eed714b94340a22298c485b6626aaca)
• Linux i386 (checksum / daeb6979e1a8d32c5adaf0ce0ea6b4fede200ebe483bdd109b3b1294a6f33c2e)
• Linux ppc64le (checksum / 0f997b9228a64477fc83ea515831c281074f2e01d3d0bf2c72c6163fca70d053)
• Linux s390x (checksum / 3fca8e8a58a0ef834ca2b7ccc10dfc07dcbb19483166351695737f55e6742d08)
• Windows amd64 (checksum / cf6dd076898e2dc1e7f4af593d011f99a9de353b6a2d019731dbc254a1ec880e)

This release was signed with 967F 8AC5 E221 6F9F 4FD2 70AD 92AA 783C BAAE 8E3B and can be found at @bacongobbler's keybase account. Please use the attached signatures for verifying this release using gpg.

The Quickstart Guide will get you going from there. For upgrade instructions or detailed installation notes, check the install guide. You can also use a script to install on any system with bash.

What's Next

• 3.7.1 will contain only bug fixes.
• 3.8.0 is the next feature release.

Changelog

• fix tarFromLocalDir saving file dependencies in dest path eeac838 (Matthew Fisher)
• Fixing issue with non-existant .Template when using tpl function 4a7c306 (Matt Farina)
• bump version to 3.7 548fae1 (Matt Farina)
• Revert moving registry actions back to pkg/ caa9715 (Josh Dolitsky)
• Move registry actions back to pkg/ 7775096 (Josh Dolitsky)
• Fix HELM_DRIVER docs for sql option bc1fefa (Ed Carrel)
• Rename newly introduced interface to InterfaceExt 75fe888 (Mike Ng)
• Fix encoded path for 'helm dependency build' 58018d1 (Mathieu Parent)
• Wrap error 101370a (Stephane Moser)
• Introduce a new interface for WaitForDelete() to avoid breaking backwards compatibility d51a61f (Mike Ng)
• feat: add optional boolean '--wait' flag to 'uninstall' command. If set, 'uninstall' command will wait until all the resources are deleted before returning. It will wait for as long as --timeout 655bdcd (Mike Ng)
• improved coalesce readability by getting rid of continue statements 5cf9735 (Bernd Gutjahr)
• enhanced coelesce_test with some more test cases 1740e7f (Bernd Gutjahr)
• Fixing issue where helm show all fails to show crds when no readme 0ff5394 (Matt Farina)
• Updating to Kubernetes 1.22 packages 95276d8 (Matt Farina)
• Add Chart IsRoot test 8fcaf7b (Kai Takac)
• Make Chart's IsRoot available to templates 06ae6f9 (Kai Takac)
• Fix SIGSEGV when job.Spec.Completions is nil 249d1b5 (lsowen)
• feat(comp): Add descriptions for repo completion e2836ff (Marc Khouzam)
• Update github.com/rubenv/sql-migrate b9b340d (John Howard)
• Update oras-go to v0.4.0 82a2abf (John Howard)
• fix: refactor downloadAll 4b23d0a (Matthew Fisher)
• Implement show crds subcommand fae7853 (Mario Valderrama)
• [fix concern] implement test 2131f4c (André Schröder)
• [fix concern] use io.ReadAll instead of ioutil.ReadAll 6515ea8 (André Schröder)
• Add flag for failing if repo update fails ccb0cf6 (Martin Hickey)
• fix(engine): parse fail messages with newlines 79df392 (Cory Snider)
• add unittest 133c227 (yxxhero)
• fix HELM PLUGINS behavior another_way 90fa4c9 (yxxhero)
• Resolve PR comments 4bc901c (Stephane Moser)
• modify registry test to only listen on loopback 82cdb0b (Josh Dolitsky)
• Switch to distribution v3 4801818 (Matthew Fisher)
• feat(comp): Move to Cobra's bash completion V2 efe2638 (Marc Khouzam)
• feat(comp): Add support for powershell completion c6dfb49 (Marc Khouzam)
• kube client lib bump to v0.21.3 4691ab3 (Shoubhik Bose)
• feat(helm): add --password-stdin to helm repo add b14fe2c (André Schröder)
• test: Make internal/resolver/resolver_test.go pass on Win 84a07a4 (Víctor Cuadrado Juan)
• Refactor SIGTERM logic c62ce12 (Stephane Moser)
• fix(typo): fix typo of storage doc 2deb641 (longkai)
• feat(pkg/engine): expose subcharts scope in parent 3daaea0 (Valentin Flaux)
• Migrate to oras-go library see oras-project/oras#265 663c569 (Nicolas De Loof)
• Revert change in PrintingKubeClient 4026190 (Stephane Moser)
• Improve tests 7bfb2a3 (Stephane Moser)
• Rename time dependecy 2164e3f (Stephane Moser)
• fix(tests): Remove unnecessary test 6a3daaa (Marc Khouzam)
• chore(deps): Update to Cobra 1.2.1 95b80ed (Marc Khouzam)
• Reverse DependingChart test logic, add debug logs 30a8ce5 (Josh Dolitsky)
• Better NewOCIPusher test, add ORAS link 241f23d (Josh Dolitsky)
• Clean up extra spaces fc5473f (jayonlau)
• feat(cmd): Allow to specify which repos to update 6951cd5 (Marc Khouzam)
• Revert "Use official golangci-lint action" 28f44b8 (Josh Dolitsky)
• Use official golangci-lint action 07a25a2 (Josh Dolitsky)
• verify golangci-lint sha256 checksum b16091a (Josh Dolitsky)
• refactor: use os instead of ioutil's ReadDir f9b1445 (Kally Fox)
• Remove LoginResult/LogoutResult types 8202ccd (Josh Dolitsky)
• Use setup-go v2 7605db0 (Josh Dolitsky)
• Add build-pr github actions workflow 2f63045 (Josh Dolitsky)
• feat(linter): check for nested resource-policy annotations 53263c6 (Adam Reese)
• fix(ci-lint): increase timeout for golangci-lint d1da9e7 (Adam Reese)
• fix(doc): fix kube client interface doc. (#9882) cf0c6fe (小龙同学)
• Move locks from global var to the structs c6c4157 (Stephane Moser)
• Add test for atomic upgrade and install when it is interrupted 660183d (Stephane Moser)
• Add test for Upgrade Release Interrupted 2fa339b (Stephane Moser)
• Hande SIGINT in install command 3434053 (Stephane Moser)
• Refactor logic d7833eb (Stephane Moser)
• Handle SIGTERM 027cea4 (Stephane Moser)
• revert change related to reading prov file 4884ca0 (Josh Dolitsky)
• return errors directly, less lines of code ec84339 (Josh Dolitsky)
• add checkOCI helper method fc98f2e (Josh Dolitsky)
• remove hardcoded oci strings, add constant/util 230e37c (Josh Dolitsky)
• Adding test for user/pass without repo on Helm install 385fcae (Matt Farina)
• consolidate registry source files bfa5036 (Josh Dolitsky)
• return err directly from pusher.Push 4d948b4 (Josh Dolitsky)
• use version.GetUserAgent faf7fc5 (Josh Dolitsky)
• do not re-use err 31588e7 (Josh Dolitsky)
• Fix the url being set by WithURL on the getters 4e2e408 (Matt Farina)
• Set Helm as manager for managedFields aeb9479 (Matt Farina)
• refactor(getter): refine http GET request 0d9ebc7 (longkai)
• modify helm push help text 56028e8 (Josh Dolitsky)
• remove tmp path in case it exists 4ed8e77 (Josh Dolitsky)
• do not update oci-based repos e5b03c7 (Josh Dolitsky)
• provide hint if attempting to push directory e856df8 (Josh Dolitsky)
• return friendly error if missing scheme 04d2da3 (Josh Dolitsky)
• remove action errors assuming CLI 3e17c1a (Josh Dolitsky)
• remove the --with-prov option 35fdc68 (Josh Dolitsky)
• move experimental actions to new internal package eba63be (Josh Dolitsky)
• resolve golint errors 8f60ee7 (Josh Dolitsky)
• move pkg/uploader, pkg/pusher to internal 24a216d (Josh Dolitsky)
• inline data fetching for pull result 4073e4d (Josh Dolitsky)
• one-line JSON unmarshall dd7bc40 (Josh Dolitsky)
• do not wrap single imports/vars 817ac8f (Josh Dolitsky)
• use TLS client information from repo config when downloading a chart 8232a76 (Christophe VILA)
• Ensure RawPath match Path when resolving reference dbb4eb6 (Mathieu Parent)
• tweak basic handling 17ed9c4 (Matt Farina)
• Upgrade to oras-go v0.4.0 f7247c4 (Josh Dolitsky)
• Upgrade to oras-go v0.3.0 866e7e8 (Josh Dolitsky)
• Implement changes proposed in HIP 6 00985ca (Josh Dolitsky)
• Add a more friendly prompt when index.yaml is empty. 20e2aec (yxxhero)
• Fix coalesce globals to prevent subchart globals to leak upstream 3b68afc (Giacomo Margaria)
• fix(dep update): helm dep update is not respecting the "version" stipulated in the requirements 402c7f1 (cndoit18)
• Switched Brian emeritus 6e329b1 (Matt Butcher)
• Improve markdown rendering of commands help for shell completion 61e08c6 (Alexandre Garnier)
• Move viglesiasce to emeritus 465ab01 (Vic Iglesias)
• bump version to v3.6.0 3415b6e (Matt Farina)
• Remove link. Align usage example with unit test ac099d6 (Iaroslav Sheptykin)
• support max-col-width parameters a79cad5 (cndoit18)
• Add example of --template usage 892130a (Iaroslav Sheptykin)
• Add upgrade dependency update test cea906a (David Mládek)
• Add --udpate-dependencies to upgrade command d6eab46 (David Mládek)
• Update install dependency-update help text 78ac14b (David Mládek)
• fix v2 install script, hardcode to v2.17.0 74c4117 (Cameron Motevasselani)
• fix helm dep build/update doesn't inherit --insecure-skip-tls-verify from helm repo add f735a24 (yxxhero)
• Fixed Test 7a663a5 (Marcus Speight)
• Added test for lint mode 8aa4282 (Marcus Speight)
• [FIX]error string should not be capitalized 89f2f84 (Scaat Feng) [FIX]comment should start with whitespace 9020c95 (Scaat Feng)
• [FIX]comment should start with whitespace f1f2e6f (Scaat Feng)
• [FIX]comment should start with whitespace 1852694 (Scaat Feng)
• [FIX]error string should not be capitalized 14f6bde (Scaat Feng)
• [COMMENT]fix comment 0de8968 (Scaat Feng)
• [FIX]'rest' collides with imported package name b6bd8d7 (Scaat Feng)
• [FIX]receiver names are different 5c14eec (Scaat Feng)
• Fail message is now the same as the required message. Fixed #8973 Helm function 'fail' should not fail when doing 'helm lint' 7a0739a (Marcus Speight)
• Add Test cases for repository-config without file extension ccada71 (Leon Bentrup)
• Correctly determine repository-config lockfile path f091b9c (Leon Bentrup)
• keep existing behavior of returning ErrReleaseNotFound when release(s) failed to decode 3be333b (Mike Ng)
• fix(sql storage): Query() should return ErrReleaseNotFound immediately when no records are found b86105a (Mike Ng)