Helm

helm/helm last check 2026-10-23 04:02 UTC 175 releases recent

Notes

no notes yet

Release notes

2.9.0 · Helm v2.9.0 · 1y+

Helm 2.9.0 is a feature release. This release contains a metric tonne of fixes and new features. We would like to take the time to thank everyone who contributed to this release. We cannot thank you enough for your time and hard work debugging issues, submitting tickets, contributing patches or crafting new features that extend Helm's usefulness. :heart:

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

Join the discussion in Kubernetes Slack:
- #helm-users for questions and just to hang out
- #helm-dev for discussing PRs, code, and bugs
- #charts for discussing about the official Kubernetes Charts repository
Hang out at the Public Developer Call: Thursday, 9:30 Pacific via Zoom
Test, debug, and contribute charts: GitHub/kubernetes/charts

Installation and Upgrading

Download Helm 2.9. The common platform binaries are here:

Once you have the client installed, upgrade Tiller with helm init --upgrade.

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

2.9.1 will contain only bug fixes.
2.10.0 is the next feature release. While it is likely to have some notable features, we will continue to prioritize stability and reliability over major feature additions.

Changelog

bump version to v2.9.0 f6025bb9ee7daf9fee0026541c90a6f557a3e0bc (Matthew Fisher)
remove need for type reflection 411a0461fb33ffe75c2e5ca56d5cd6bd284ef159 (Matthew Fisher)
Fix for - Downloader plugins not used when downloading new repo's index.yaml #3938 26f4405fdf9d7334fc8ae966aae8f880e2b1b9a4 (eyalbe4)
fix(kube): output internal object table 4c14bc4f342786a949d256c5b7dbe4335bb329bb (Adam Reese)
ref(pkg/tiller): clarify reuseValues comment 1bc01fdbef7243870c5d8830bb3715da77ba3594 (Michelle Noorali)
fix(pkg/tiller): reuseValues combines all prev val 4dd21780bb6debf2eccfef2c37bdcb52bf649abd (Michelle Noorali)
fix(kube): get correct versioned object from info helper f91c62f888e0a8f764fda8d7e3c2abf98abf1081 (Adam Reese)
swallow the error when returning the default HTTP client 88c006563cd1d0e9c15ed4d2a4787cba92a1ca09 (Matthew Fisher)
fix(kube): use correct object type in watch 561e034ada08d9ab707227756a62a4da47cee10d (Adam Reese)
Basic auth credentials from repo not used in install/upgrade/fetch commands #3858 8380e24994c5b0be8ee4dcb20edc7f16940214b1 (eyalbe4)
remove unused servicePort from default ingress template 1d2205732cb79e5a916b58aa5c7c7ed6529f9c4b (Steffen Windoffer)
toYaml - Fixes #3410 - trailing \n issue 9d81cc097119a88b072ebddc31db9ad941c1da44 (Erik Sundell)
toYaml - Fixes #3470 - trailing \n issue 1dc32f78491856085b88217a1686936a8bb6ef5c (Erik Sundell)
Updated tests for PR #3837 4d51d22e075af4d6d26dbe4555888503e8acc001 (Erik Sundell)
Switch flag to update existing record 8ff9bc5acba66e1e9dba1fc6bd19f1d702df1e91 (Stuart Leeks)
fix helm get manifest context deadline exceeded error 73324d5ec971359c2a6fa4011d619232dc1e34f5 (Matthew Fisher)
using existing mechanism to flag for failures 3378e69c6e17fcf7495b9ac0b6a011cf7c0bd954 (Ryan Hartje)
return a non 0 exit code when lint fails due to missing Chart.yaml cc9de2315fb8b9e22d82b746c42f5dc832e0e050 (Ryan Hartje)
ref(cmd/helm): show grpc error msg from prettyError beeac8b0c8725021898493aac4b9a9eb2ea28ecc (Michelle Noorali)
closes #3795 cb2f5b7015569c7bb5df5ec1bff48c310c33623e (ReSearchITEng)
Fix tiller deployment on RBAC clusters 992effc1cd8870ab9061ec5d56847bf25e818af3 (John Koleszar)
import client auth plugins c52707fb26e67609606f6ec35971068e79e32641 (Matthew Fisher)
Add hook-delete-policy ReleaseServer unit tests b7fe0d0bd7d059ad45b71fe84be5275f66e1bf4a (Timofey Kirillov)
release list paritioning ad99c1b749df43c6dcdbc1df278a88e8093290fb (fibonacci1729)
fix(helm): fix output leak from unit tests of helm create command e0056a9e41d5432192ee4d103a72e36ba9aeec36 (Arash Deshmeh)
stream releases when listing 2dd9b34d28338e24a646d393ed4e522be55b7851 (fibonacci1729)
Removed typos (additional plus signs) 3334309a9193b61da6b24ceceb5435ef4d2f71ed (Shredgar)
fix 'eveything' -> 'everything' (#3754) 0ba75b6652aec058c51fc1152988e01403496318 (muhongwei)
fix 'mulitenant'->'multitenant' (#3755) 75387fe3183a724684b2bea29c2a0023e7a9a354 (muhongwei)
Fix several golint warnings (#3756) 1a55161a53345816d724e1df9664f789113e1328 (adshmh)
Remove outdated note. 6e3a0a129172db913491a83443813ea0ae3861c5 (Jonathan Hall)
Updated kubernetes_distros.md with DC/OS note. 52b7abac26ca0088082121aa26215bf411ad928b (Shredgar)
ref(*): kubernetes v1.10 support 7c19cb7040810f0eaedb50ca29eafb108bd9611e (Adam Reese)
Update tiller_ssl.md 31c03a24845a29fd4bf32c5ad934424acc9bf18e (AdamDang)
Updated to mention the --purge flag on delete 9d0dc294d76d1401809b586a75e7bec000f4aa22 (Russell Morrisey)
fixed typo + moved into Helm Included section 6abbee0d44f2890ad76cb5f2bd09a79a540a63d9 (James Strachan)
Update to specify version command output. 537bfbb75ef25cc3f3e18607d98a7c2633aab9f0 (Justin Scott)
Add issue_template.md which asks for version info. 49cda9a81d4453f2e9b67f701dd1db9a48561bb4 (Justin Scott)
fix Syntax error bddb6591d46ce176e87668ed458da54fa0da5eaf (fqsghostcloud)
Fix HTML parsing when setting TAG with wget 908addd6fc778515fc0b2ed54a5050149554b961 (Ferenc-)
add a link to Jenkins X and how it uses helm 502db80b263a9498535f42c71e36adcdbacad4fa (James Strachan)
Create index.yaml if missing when running repo index --merge 141e0155903f85d245e156746fadfca4bf6734fa (Helgi Þorbjörnsson)
Implement before-hook-creation delete policy 1d4883bf3c85ea43ed071dff4e02cc47bb66f44f (Alexey igrychev)
Adding --set-string flag to force string values. a615f80c9266c49110773662d7d7c3b6700971c6 (Arturo Contreras)
Authentication support for remote charts repositories (#3206) b6335b7dfeb0e68952ee914877fe456ecd257779 (Eyal Ben Moshe)
Fixed typo 08f450404b1a7711d12efcdbfc47abafdd42bcda (Andrii Soldatenko)
fix(helm): fix helm history unit tests 34b6d12ebe0824cae6fc9ebb1b14d3c8fd822a92 (Adam Reese)
Add actionable message in the error afed555572a1476dcb7c3bebc2701268cfde1de8 (Daisuke Maki)
fix(helm): refactor tests on helm dependency list command to remove duplication 74bf7584a0333e817bca52b80e56e189cb1ed98c (Arash Deshmeh)
fix(helm): remove duplication in tests of repo-add command b66c10df10a4039adc26ae21edb649b7a2a5f630 (Arash Deshmeh)
fixed an issue in versioning.mk (#3653) a53f93c8ee28ad6b5ac043382b63e483a1f70e55 (John Rowley)
fix windows path issues on helm template -x 6de9ebccbca7dd085f5d8857f1715c20075ed40e (Matthew Fisher)
fix(helm): refactor search command tests to remove duplication 1e4770248c9f263ee2fd54516a93a28cd2fd6670 (Arash Deshmeh)
fix(helm): search command returns error on index search failures (specifically on regular expression errors) 4b145622a268a3aca5643c149da5a3172df03dd4 (Arash Deshmeh)
Fixed referencing the wrong env variable if SHA sum doesn't match. 08a92b23d1defbb03a3f6580f3ce9b3dcb935c76 (Michal Zerola)
update documentation as per review feedback 333341425aea49e15cc5f0afa3ef63c5a810d6e6 (Rajat Jindal)
feat(helm): inspect readme 3625241025783f0b5c48b64e382780f74f7c4148 (Florian Zysset)
add newline after header 421499708f7353c7054ccb87516ea878f7756979 (Matthew Fisher)
Fix link to github issues bb932f77022b55d3090506cb0a02d4431c52eaf2 (Stuart Leeks)
fix(helm): refactor helm version command tests to remove duplication 23b570fabdb2907a6cc2887a4885cc9086cc7ad3 (Arash Deshmeh)
docs(OWNERS): add emeritus section (#3667) 4f3832488b86e0b1249af8a375684ebbeac93bcf (Matt Butcher)
remove "This Repository" link from releases page 0935384bd57e3b8dc2bd7383fcd56af6515a1d91 (Matthew Fisher)
Now returning error and stopping installation 5311bf40a8bc243d29e705b46201b760b35c6e5c (scriptonist)
add back the default 5 second connection timeout 3014b9277f0be853593820d7eefe0f063f6852a3 (Matthew Fisher)
fix(helm) refactor helm status command tests to use releaseCase struct and the corresponding function runReleaseCases. Fixes #3659 e25df2ae76e3c772ee6ae86e2eaf5be3be72cca9 (Arash Deshmeh)
make table explicitly default c93ff32f5203c14fb0eed3afcbf4689f8f9d9a20 (Rajat Jindal)
fix(helm): remove duplicate code from cmd/helm/history_test.go. Closes #3649 cdd9a85676edc2f126486ff7ccb5b14093744857 (Arash Deshmeh)
add support for output format in json or yaml 46ed8027508a8ff0df9604d0ca8f0449c1d973e1 (Rajat Jindal)
Accept .yml files as well as .yaml for templates. 73017d7e88929b950bca4cc81638fa4deebcf44c (Nic Doye)
Added code to recover from a tiller pod crash in an event of template render failure 6cfaa4ebf27374789a421246bed3b85931e3055b (scriptonist)
fix typo in docs and fake 92972b0353430344c7dc1b9f7abc152f08bdc4f2 (Rajat Jindal)
Add helm-unittest in plugins d01c5e0ee6171cf9207eb1acb613d2d5e55e046e (Patrick Liu)
replace FAILED deployments with helm upgrade --install --force 13730b0dab2feb91eb9e7ca95e7a6d501e556c94 (Matthew Fisher)
fix protoc 250d25fdceaf5546f29228f3711cedd8d6776fcd (Matthew Fisher)
fix helm init --wait a66a39a171fa453f6515cbe23d7d2715cba9cc81 (Matthew Fisher)
fix(helm): remove duplicate test code from cmd/helm/list_test. Closes #3637 75ccc353eb12884ebf2f8c653cee7730cc397f67 (Arash Deshmeh)
Respect env proxy settings when using custom Transport bf7e755ef39c436e16681df97334d67c6a63cfa3 (Greg Burton)
bump go to 1.10 e73c82f51ea839b28c33ca31daa21c8ba7c1cc4f (Matthew Fisher)
fix kubeVersion example 01b404b68e4be94fe7776fc51cd65c155308a5fa (Matthew Fisher)
Fixed bad link to Issues page 3058644f364f5fbce596aac1fc0edd718b504f5b (bryangunn)
fix(helm): fix the bug in test code 'cmd/helm/init_test.go' and 'cmd/helm/repo_update_test.go' that leave behind temporary helm home directories during build. With this fix, the build process no longer leaves behind 'helm_home-*' temp directories. da989dc275a92fd48343263baf99231b310ce9ac (Arash Deshmeh)
update the documentation to refere to GnuPG v2 c6f7e54267c6509c62d0e01b2fc8a0b004b305a3 (Evans Castonguay)
fix(helm): Don't crash in search if upper case chars are encountered. d8489901224c8279b724c84c0f17df67a9d5aaf2 (Morgan Parry)
Change helm update to helm upgrade 363e5bcdf8e486dda871f19e3fc0c24f27762d25 (Chen Zhiwei)
Add --replicas option for HA fixes #2334 2f252e95242849123fa7826748cbfd050fde870c (Yaroslav Molochko)
added Codefresh f78aaa8715f916de4c09f3796b8b414b836323bd (Itay Shakury)
Add instruction to support new GnuGP version 8a7390342bd17a577cfed1fc66c73610447200e3 (Evans Castonguay)
pass home down through createLink dc7e465705c6b5a7f387b4833a86e5459bd6a8cd (Christopher A. Stelma)
updating DownloadIndexFile function call to pass in HELM_HOME 81e09ff14c0b45c1c9cbe9a72a0a61156d5a7981 (Ryan Payton)
adding Helmsman in docs/related.md df61fb84d8db9a3be6b76f461c32c6fb6680e368 (Sami Alajrami)
Add helm-hashtag plugin e4305233e441e0601ae80cc985052ad30eb2590d (Johnny Bergström)
Add link to securing helm docs in 'helm init' text 829fe51f1ecfe3bacdd4670b3c09f10335ad82e2 (James Munnelly)
remove deprecated -e flag to docker login cc7ee84998b746e14ec0e24570c8eede26d2901b (Matthew Fisher)
fix(circle): fix download link to download.docker.com 286c902572a209d1a827b32ce794c721fcf21e44 (Matthew Fisher)
fix(tiller): Supersede multiple deployments (#3539) 5f1a21bc321b326f3fab87b71bdc12bcd7125441 (Johnny Bergström)
docs(helm): Added kubeVersion to documentation. docs(helm): Added kubeVersion to documentation and examples. Adjusted wording for the Chart.kubeVersion description Removing redundant wording for Chart.kubeVersion description a78336ad355515f3142a06f3cc18acf46faf924f (Lukas Eichler)
fix(plugins): support installing plugins by relative path (#3568) fa611fe2853f3393c7c2d902b8dabc72c88d63df (Adam Reese)
fix(plugins): support newer git (#3571) c314e2e2f1a3ef1d54daea24c66bed215c9be152 (Adam Reese)
Create missing directories when saving files in chartutil.SaveDir 5b77335415dc98c087a63bcd36c1d2db5ebf7dba (Jean-Philippe Courson)
Fix link to Slack 64b7d060baa92150f8a45cdff644a6cadc34ddb5 (Mauricio Scheffer)
docs(related): add helm-local plugin (#3547) d0883dd8138947772239c25e212926d1afb1fcef (Adam Reese)
Fix minor typo df041c4b19d4007256123bfba57c56355086c934 (Radu Matei)
Added ReactiveOps Autohelm to the related tools list ed0a7462d8ca3a40659f1ccf6462929b5313545d (EJ Etherington)
fix(helm): fix the bug in tests under cmd/helm that leaves behind temporary directories named "repo-test-*" during build. 55cc23cb0168d527ba60de359e38c5717cf2577d (Arash Deshmeh)
fix(helm): fix the bug in test code under pkg/tiller that leaks output to stdout during build 5b25eef9e260f2658914c5b9de27d8f69efcc2a3 (Arash Deshmeh)
Update deprecated grpc dial timeout 9bac0a4c30d1eb879acdd68617336834b48937c0 (Johnny Bergström)
Bump client side grpc max msg size 98e5006ecfefe7c1b1ab10c9e9e906407101ded1 (Johnny Bergström)
Mute upgrade --install default namespace warning 0d758cfd410f66c8ae60049ee7ead6a910a42f43 (Johnny Bergström)
update docs to demonstrate best practices in regards to named templates 4cc95d2c2f8ecfa08d252b8ecc499ad05df63579 (Mueed Chaudhry)
fix(helm): fix the output leak to stdout during build by tests under pkg/releasetesting, by redirecting output from mock clients. 4fcf69bc5287f6ca6090655ef8b8bb8087d6fa8a (Arash Deshmeh)
Update download links to 2.8.1 binaries c1020106d722704b3360444646d874e4128312fb (Stevo Slavić)
Add a reference to Helm.NET 8530f1bc22cdd06c73c8f84a1c8652be49b1b5fd (Frederik Carlier)
Fix typo fbe17d277e5e4260edea47c9ede97dadab78be7c (Frederik Carlier)
Fix linting bug with charts containing more than one hyphen abd33764e8738e9d46b6ec9dc5d7f73f1eeee675 (Liam White)
chore(README): add ref to helm mailing list d216fd0d7d272aab95767d9ecec25755a60d4f9e (Michelle Noorali)
fix(helm): fix the implicit dependency of TestSetAppVersion test on previous tests, due to helm home, by explicitly creating a temporary helm directory for the test. c78af5483c895fc4ccc204c350ed47b5da48fc17 (Arash Deshmeh)
Typo once/one d65f8b532fd0c9bf622ff1ecb3f1aba4d43d8b7d (Jason Murray)
fix(helm): fix the bug in test code 'cmd/helm/create_test.go' that leaves behind temp directories during build a9ba3aa89777d651b4515b53f7cae98637447503 (Arash Deshmeh)
fix occurences typo in charts.md 50cba63c5c3054f10d09b493b010ac4ee82441ae (Yann Coleu)
fix a typo in client 76a40fc573120cca95042a0385dc97701b98c228 (yank1)
docs: Fix FromJson comment a59d2125123d9d829e99823e1f969309841fefd8 (Thibaut Rousseau)
feat(helm): add --template flag to helm version cff4ea416ebe54542c26ec9ac6c4ac659c97d887 (Sunny)
Fix bash example ffc76861fe2e97ec63f36575bb2b3898a8b3a11d (Jonathan Hall)
Grammar fixes and clarifications 0d12288e46fb21f57cf8974c8b9df0c80a4c529a (Jonathan Hall)
defer in loop may cause resource leak 757db3a062fa3554daa8b53f28580817d75061fe (oilbeater)
bump docker to 17.11.0-ce f7e078ca29d4b063f49e9dffda8412a2a3de1085 (Matthew Fisher)
fix(helm): update helm reset --force tip for clarity 084a2bb945ef2c6fcb3a97cb3ee00210a2f0fe5d (Justin Scott)
Keepalive config should be independent of TLS 3b22ecd53b2df89e1d0dc625c7fd569450ef13d8 (Ben Langfeld)
Tiller should only enforce what we expect from Helm 588f7a8443384dc7c83d8d2d802c970af3314f02 (Ben Langfeld)
defer in loop may cause resource leak 0764d95a03df6801f38e2b625f9b69b5313d1c73 (oilbeater)
fix(helm): fix the build-time golint warning on 'cmd/helm/install.go' 244b1b152865c3f7d86f38a16d4dc9ce2a574bd2 (Arash Deshmeh)
use an underscore for release_checklist.md b02c6ffb910601dcf8f79d3af3d5c025b0380db4 (Matthew Fisher)
fix(grpc): Fixes issue where message sending limited to 4mb 614cd9dfe7413a3b8624311bebaf8e8229b05e3f (Matt Farina)
Update tiller_ssl.md bf8bc42cfc6bfe78d62a070c093e040c9bbe7338 (lihuang)
fix(api-machinery): Fixes patching for unstructured objects e6137ff05fd6d6e736a108cf91f5752e8669b268 (Matt Farina)
remove references to the term "master" c316193a624e98c1ef4bba575088de0404989d92 (Matthew Fisher)
Fix subchart2 example tag 782b394e9799e875649219295e6ace6bd54ec39a (Jonas Fonseca)
Update charts_tips_and_tricks.md db31b7a9daa02c0daa3e656e4e62eda5308057f9 (liaoj)
Update developers.md dddce02b942d13479afe44adebaa3aa992f75d0b (lihuang)
ref(glide): remove need for scripts/setup-apimachinery.sh (#3446) 31e6446b8e16e45a22084a5b54cd78646804b322 (Adam Reese)
fix doc spell check f953b2be2d4440228056af93912d91897f528faf (lihuangzym)
the spell check b9bd81dc7f2231157153c321487d099f4b662e17 (lihuangzym)
doc(tips): Add an exception to tip about quoting integers 67c190af28a2ae5b530969b3a0319d648887b78d (Arnaud Rinquin)
Update Makefile d1b3523b2ba399f004571b60100e7fcb4611aa61 (Oilbeater)
adding other missing apiVersions b065ffe1fc20da906275784873d3d4b635615462 (Paolo Mainardi)
Update RBAC best practices cbea403d04414848332f0cd4fd27abc5c177094e (Reinhard Nägele)
add appsv1beta1 and appsv1beta2 apiVersion 2cee4c68fa77e8c149b639be4f1502ffaad74bf9 (Paolo Mainardi)
Fix 'getSelectorFromObject' ea520afd3e4d0eb3637a10b7443ca83bcaf340e8 (Reinhard Nägele)
Disambiguate encoding from secrets 2a0090c8c74da3ffd64b1c3f9675754e701611f0 (Daniel Barker)
Fix typo 3c66183cb51eea000ad7120ba68b9b7e4fef26f8 (Bin Liu)
Fix type 1e0906ed67c08f754cc28c7047eea228cb76e373 (Bin Liu)
exit zero on non-master branch d28d1756f80785a43ed3838d7a6a155149f5164c (Matthew Fisher)
Revert "feat(helm): adding kubeconfig flag" f13c4d28b5d4b93e2b9f2586d78657e43b192311 (Matthew Fisher)
fix helm init --upgrade logic 4947e5aaf8a5354cfada9816e837420ff7a75ca7 (Matthew Fisher)
fix RELEASE_BRANCH_NAME 4763cca8cb49e6166475d19442ad379067531bdf (Matthew Fisher)
change child-parent title & links to fix links d77a60a4621479b0d8c42cdafebfdcf69b1b10e0 (jonathan.striebel)
docs: fixed incorrect clone path in developer docs 03f35cdd32fbfc41ab49a0c1106ee0e9cbf6d520 (scriptonist)
refactor prettyError, closes #3381 0ddfbaafb6e686f1a4c9490dfb66df8b29ccb592 (Pure White)
fix link to image 9fcd6be4ffbc032396d7cb0d71c8f551a51aa277 (Matthew Fisher)
Fix pod recreation 3d05da010980fd93258d4f10ff4d0dbabe53dba2 (Reinhard Nägele)