update helm installation doc to separate the CRDs deployment step. (#3110)

This commit is contained in:
Morven Cao 2019-01-22 00:33:52 +08:00 committed by Lin Sun
parent 004c301160
commit 12730e09d2
1 changed files with 14 additions and 4 deletions

View File

@ -40,18 +40,22 @@ The following commands have relative references in the Istio directory. You must
$ helm dep update install/kubernetes/helm/istio
{{< /text >}}
1. Choose one of the following two
**mutually exclusive** options described below.
1. Choose one of the following two **mutually exclusive** options described below.
> To customize Istio and install add-ons, use the `--set <key>=<value>` option in the helm template or install command. [Installation Options](/docs/reference/config/installation-options/) references supported installation key and value pairs.
### Option 1: Install with Helm via `helm template`
1. Install all the Istio's [Custom Resource Definitions or CRDs for short](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/#customresourcedefinitions) via `kubectl apply`, and wait a few seconds for the CRDs to be committed in the kube-apiserver:
{{< text bash >}}
$ for i in install install/kubernetes/helm/istio-init/files/crd*yaml; do kubectl apply -f $i; done
{{< /text >}}
1. Render Istio's core components to a Kubernetes manifest called `istio.yaml`:
{{< text bash >}}
$ cat @install/kubernetes/namespace.yaml@ > $HOME/istio.yaml
$ cat install/kubernetes/helm/istio-init/files/crd-* >> $HOME/istio.yaml
$ helm template install/kubernetes/helm/istio --name istio --namespace istio-system >> $HOME/istio.yaml
{{< /text >}}
@ -91,6 +95,12 @@ to manage the lifecycle of Istio.
$ helm install install/kubernetes/helm/istio-init --name istio-init --namespace istio-system
{{< /text >}}
1. Verify all the Istio's CRDs have been committed in the kube-apiserver by checking all the CRD creation jobs complete with success:
{{< text bash >}}
$ kubectl get job --namespace istio-system | grep istio-crd
{{< /text >}}
1. Install the `istio` chart:
{{< text bash >}}
@ -128,5 +138,5 @@ to manage the lifecycle of Istio.
> {{< warning_icon >}} Deleting CRDs will delete any configuration changes that you have made to Istio.
{{< text bash >}}
$ for i in install install/kubernetes/helm/istio-init/files/*crd*yaml; do kubectl delete -f $i; done
$ for i in install install/kubernetes/helm/istio-init/files/crd*yaml; do kubectl delete -f $i; done
{{< /text >}}