This is the final Helm alpha release for the 2.0.0 development cycle.
WARNING: This release is not backward compatible. We try hard to avoid compatibility breaks because we know it is an inconvenience to you. But we made a tough call: It is better to correct some of our design flaws now than force everyone to "live with them" for the entirety of the 2.0.0 lifecycle. We apologize for the inconvenience, and we don't plan on any other compatibility breaks between now and 2.0.0.
As always, we want to give a big ❤️ to the community, which has continued to find bugs, submit issues, fix things, and participate in conversations. If you'd like to be a part of the community, we invite you to join the Kubernetes Helm Slack channel, drop in on a Thursday Developer Call, and jump in on the GitHub issue queues.
- Kubernetes Slack: #helm
- Developer Call: Thursday, 9:30 Pacific via Zoom
- Chart Development: GitHub/kubernetes/charts
Binary downloads of the Alpha.5 Helm client can be found at the following links:
The big changes
helm rollback: A command for reverting a release to a previous version. It can even undelete releases that were deleted.
Helm and Tiller now are version-aware. They can better indicate whether they are compatible. You will get compatibility errors running
helm alpha.4 and
tiller alpha.5, for example.
Chart developers, we added a tool to help you manage chart dependencies. Check out
helm dependency install and the new
Repositories have been overhauled. To make it easier to find, install, and manage charts, we changed the format of
index.yaml. If you run a chart repo, you should re-generate the index file!
Finally, we have worked hard to make some UX improvements:
kubernetes-chartsdirectory was renamed
stable. Hooray for brevity.
helm updatewas changed to
helm repo update
helm historyis a new command to make it easy to see the history of a release.
helm searchwas rewritten to make it more usable
helm searchwith no term will return all charts
helm search stable/will return all charts in the repository named stable
- We dropped the requirement that you install with an explicit version number.
helm install stable/mariadbnow installs the latest
mariadbchart from the stable repository.
helm install stable/mariadb --version 0.1.0now installs version
0.1.0(rather than the latest)
- The same syntax is true for
helm upgrade, and
- Commands that generate listing (
list, etc.) now use the table layout by default.
Changes for chart developers
In addition to the new
helm dependency * tools, we have made a few small changes in the templates. Two new functions were added:
uuidv4generates a random UUIDv4
toYamlencodes a value into YAML
Getting Started with 2.0.0-Alpha.5
Please let us know if you find any issues with those guides. We want Helm installation to be an easy and reliable process.
When upgrading to a new version of Tiller, we recommend using
kubectl to delete the old one:
kubectl delete deployment --namespace kube-system tiller-deploy. This will not delete your releases. From there, running
helm init will update you to the latest.
For Mac OSX
We consider Alpha.5 to be feature complete. The developers are now working on fixing bugs, improving stability, and building some great docs. This is a great time to jump in.
Our next release will be v2.0.0-beta.1. And we will be rolling out betas until we feel like the tool is ready for production use.