docs(install): document new upgrade process

This documents the new 'helm init --upgrade' flag.

Closes #1704
Closes #1755
pull/1861/head
Matt Butcher 8 years ago
parent 4a69e0c776
commit 70f4f702e3
No known key found for this signature in database
GPG Key ID: DCD5F5E5EF32C345

@ -169,15 +169,12 @@ Server: &version.Version{SemVer:"v2.0.0-alpha.4", GitCommit:"a5...", GitTreeStat
Importantly, even when running locally, Tiller will store release
configuration in ConfigMaps inside of Kubernetes.
## Deleting or Reinstalling Tiller
## Upgrading Tiller
Because Tiller stores its data in Kubernetes ConfigMaps, you can safely
delete and re-install Tiller without worrying about losing any data. The
recommended way of deleting Tiller is with `kubectl delete deployment
tiller-deploy --namespace kube-system`
As of Helm 2.2.0, Tiller can be upgraded using `helm init --upgrade`.
To simply update Tiller to run the latest image, you can run this
command:
For older versions of Helm, or for manual upgrades, you can use `kubectl` to modify
the Tiller image:
```console
$ export TILLER_TAG=v2.0.0-beta.1 # Or whatever version you want
@ -187,6 +184,19 @@ deployment "tiller-deploy" image updated
Setting `TILLER_TAG=canary` will get the latest snapshot of master.
## Deleting or Reinstalling Tiller
Because Tiller stores its data in Kubernetes ConfigMaps, you can safely
delete and re-install Tiller without worrying about losing any data. The
recommended way of deleting Tiller is with `kubectl delete deployment
tiller-deploy --namespace kube-system`
Tiller can then be re-installed from the client with:
```console
$ helm init
```
## Conclusion
In most cases, installation is as simple as getting a pre-built `helm` binary

@ -43,6 +43,8 @@ This will install Tiller into the Kubernetes cluster you saw with
**TIP:** Want to install into a different cluster? Use the
`--kube-context` flag.
**TIP:** When you want to upgrade Tiller, just run `helm init --upgrade`.
## Install an Example Chart
To install a chart, you can run the `helm install` command. Helm has

Loading…
Cancel
Save