Yep, you read that right! Helm v3.0.0-beta.1 is now available! This is the first beta release for Helm 3. This release was focused on finishing the last breaking changes and refactors as well as porting over other Helm 2 features. We also focused on cleaning up some of the last rough edges around our publicly exported Helm libraries. We plan for this beta to be relatively stable; however, please be advised it is still a beta and breaking changes could occur.
More importantly, we want to thank everyone that has been participating in finding issues, triaging, testing, and contributing fixes to the second alpha release.
The community keeps growing, and we'd love to see you there!
- Join the discussion in Kubernetes Slack:
#helm-usersfor questions and just to hang out
#helm-devfor discussing PRs, code, and bugs
- Hang out at the Public Developer Call: Thursday, 9:30 Pacific via Zoom
- Test, debug, and contribute charts: GitHub/helm/charts
Notable Features and Fixes
- Experimental feature gate support has been added. We hope this will indicate to users when certain features of Helm are not backed by the same backwards-compatibility guarantees. Commands like
helm chart(i.e. commands for OCI registry support) are now backed by a feature gate. You must set the environment variable
HELM_EXPERIMENTAL_OCI=1to enable this feature.
helm searchnow supports both local repository searches (Helm 2's behavior) and making search queries against Helm Hub. We hope this will increase visibilty of available options for users.
- Several of the exported packages have undergone major refactors or have been moved to
internal. If you are using Helm 3 as a library, you may have to change some of your code. Please note that any packages in
internalmay eventually be refactored and exported based on the needs of the community.
- Upgrades are now done using a three-way merge patch, taking into account the current state of the object according to Kubernetes. Upgrades will no longer overwrite additional state added after install (though it will still overwrite any state set in the chart). For more details, see the FAQ on the new merge behavior.
- A home directory is no longer needed for Helm. It now follows the XDG directory spec for storing files. Because of this,
helm homehave been removed.
- With the removal of
helm init, we also no longer add the
stablerepo by default. We are looking for feedback on how to improve the repository workflow and what, if any, should the default(s) be.
helm testreceived some major refactors, bringing the
test-successhook's behaviour in line with other Helm hooks. Due to lack of use, the
test-failurehook was removed. Users should migrate their tests to use the
- Support for the
crd-installhook has been removed. In its place, we have added support for a
crddirectory that all CRDs should be placed in. All CRDs in the directory will be installed before any rendering of the rest of the chart is done. As the community decides how to best handle CRDs, we will add additional support for that workflow. Before 3.0.0 is released, we will be releasing a "legacy" plugin that will allow older v1 charts with the
crd-installhook to work with Helm 3.
- Due to some of the refactors and the removal of Tiller, Kubernetes object validation is currently missing. This will be fixed in the next beta release, but should not cause any issues with installing charts in the meantime.
Please feel free to reach out on
#helm-dev if you have any questions about the beta release, and if you find any missing information in the docs, we'd highly appreciate a pull request!
Depending on whether or not there are any major changes to be made, the next release will either be a 3.0.0-beta.2 or a 3.0.0-rc.1. The maintainers will be focusing on fixing any bugs and porting over any missing features from Helm 2. You can find a list of those missing features here.
As this is a beta, we don't expect there to be any more breaking changes, but there is still a small chance that porting a feature from Helm 2 or other bugs could cause a breaking change. In that case, these changes will be clearly called out in the release notes.
Installation and Upgrading
Download Helm 3.0.0-beta.1. The common platform binaries are here: