more update to helm instruction (#1314)

* more update to helm instruction

* Update helm-install.md

* correct typo

* add a link for tiller

* update tiller's link

* will fix option 2 in a seperate pr as it breaks link

* revert back

* format changes mostly

* use the old way for 2 options 

since we are looking at breaking into 2 pages

* fix multiple blank line issue

* fix trailing space
This commit is contained in:
Lin Sun 2018-05-18 16:36:00 -04:00 committed by istio-bot
parent 51446b02e9
commit ee4590d448
1 changed files with 21 additions and 19 deletions

View File

@ -10,36 +10,38 @@ redirect_from: /docs/setup/kubernetes/helm.html
{% include home.html %}
Quick start instructions for the setup and configuration of Istio using the Helm package manager.
Quick start instructions for the setup and configuration of Istio using the Helm package manager. This is the recommended install method for installing Istio to your production environment as it offers rich customization to the Istio control plane and the side cars for the Istio data plane.
<img src="{{home}}/img/exclamation-mark.svg" alt="Warning" title="Warning" style="width: 32px; display:inline" />
Installation of Istio prior to version 0.8.0 with Helm is unstable and not recommended.
## Deploy Istio using Helm
There are two options for using Helm to deploy Istio.
1. Use `helm template` to render a manifest and use `kubectl`
to create it.
1. Use Helm's [Tiller](https://github.com/kubernetes/helm/blob/master/docs/architecture.md#components) service to manage the lifecycle
of Istio this requires tiller to be installed in your Kubernetes cluster.
## Prerequisites
* Kubernetes **1.9 or newer** is recommended.
* Helm **2.7.2 or newer** is required. Follow the [instruction](https://docs.helm.sh/using_helm/#installing-helm) to install Helm.
* If you want to manage Istio releases with [Tiller](https://github.com/kubernetes/helm#helm-in-a-handbasket), Helm tiller must be installed in your Kubernetes cluster.
* If you are interested in option 2, Helm [Tiller](https://github.com/kubernetes/helm#helm-in-a-handbasket) must be installed in your Kubernetes cluster.
## Deploy Istio using Helm
There are two techniques for using Helm to deploy Istio. The first
technique is to use `helm template` to render a manifest and use `kubectl`
to create it.
The second technique uses Helm's Tiller service to manage the lifecycle
of Istio this requires tiller to be installed in your Kubernetes cluster.
### Download and prepare for Istio install
## Download and prepare for Istio install
Follow the [instruction]({{home}}/docs/setup/kubernetes/quick-start.html#download-and-prepare-for-the-installation) to download the Istio release binary and install `istioctl`.
## Install Istio with Helm
Choose one of the options below to install Istio with Helm.
### Render Kubernetes manifest with Helm and deploy with kubectl
This is the most heavily tested method of deploying Istio. During the
continuous integration testing and release process, the
`helm` binary in `template` mode is used to render the various manifests
produced for Istio.
This is the most heavily tested method of deploying Istio. During the continuous integration testing and release process, the `helm` binary in `template` mode is used to render the various manifests produced for Istio.
1. Create an `istio.yaml` Kubernetes manifest:
@ -47,7 +49,7 @@ produced for Istio.
$ helm template install/kubernetes/helm/istio --name istio --namespace istio-system --set global.proxy.image=proxyv2 > $HOME/istio.yaml
```
1. Create the Istio control plane from `istio.yaml` manifest:
1. Install Istio's core components from `istio.yaml` manifest:
```command
$ kubectl create ns istio-system
@ -117,13 +119,13 @@ the [`values.yaml`](https://raw.githubusercontent.com/istio/istio/master/install
## Uninstall Istio
* Uninstall using kubectl:
* For option 1, uninstall using kubectl:
```command
$ kubectl delete -f $HOME/istio.yaml
```
* Uninstall using Helm:
* For option 2, uninstall using Helm:
```command
$ helm delete --purge istio