Skip to content

@thomastaylor312 thomastaylor312 released this Aug 26, 2019 · 913 commits to master since this release

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-users for questions and just to hang out
    • #helm-dev for 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 registry and 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=1 to enable this feature.
  • helm search now 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 internal may 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 init and helm home have been removed.
  • With the removal of helm init, we also no longer add the stable repo by default. We are looking for feedback on how to improve the repository workflow and what, if any, should the default(s) be.
  • Internally, helm test received some major refactors, bringing the test-success hook's behaviour in line with other Helm hooks. Due to lack of use, the test-failure hook was removed. Users should migrate their tests to use the test-success hook instead.
  • Support for the crd-install hook has been removed. In its place, we have added support for a crd directory 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-install hook to work with Helm 3.

Known Issues

  • 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.

Getting Started

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! ❤️

What's Next

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:

Assets 18
You can’t perform that action at this time.