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 Importantly, even when running locally, Tiller will store release
configuration in ConfigMaps inside of Kubernetes. configuration in ConfigMaps inside of Kubernetes.
## Deleting or Reinstalling Tiller ## Upgrading Tiller
Because Tiller stores its data in Kubernetes ConfigMaps, you can safely As of Helm 2.2.0, Tiller can be upgraded using `helm init --upgrade`.
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`
To simply update Tiller to run the latest image, you can run this For older versions of Helm, or for manual upgrades, you can use `kubectl` to modify
command: the Tiller image:
```console ```console
$ export TILLER_TAG=v2.0.0-beta.1 # Or whatever version you want $ 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. 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 ## Conclusion
In most cases, installation is as simple as getting a pre-built `helm` binary 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 **TIP:** Want to install into a different cluster? Use the
`--kube-context` flag. `--kube-context` flag.
**TIP:** When you want to upgrade Tiller, just run `helm init --upgrade`.
## Install an Example Chart ## Install an Example Chart
To install a chart, you can run the `helm install` command. Helm has To install a chart, you can run the `helm install` command. Helm has

Loading…
Cancel
Save