From c2cdad93bb11c07164a1457a218cff4a3ae37392 Mon Sep 17 00:00:00 2001 From: Doug Davis Date: Tue, 8 Jan 2019 17:26:28 -0800 Subject: [PATCH] Tweaks docs to create Istio CRDs first - part 2 Continuation of #717 - get the rest of the install docs Signed-off-by: Doug Davis --- install/Knative-with-AKS.md | 7 +++++++ install/Knative-with-GKE.md | 7 +++++++ install/Knative-with-Gardener.md | 7 +++++++ install/Knative-with-Minishift.md | 11 ++++++----- install/Knative-with-PKS.md | 7 +++++++ install/Knative-with-any-k8s.md | 7 +++++++ 6 files changed, 41 insertions(+), 5 deletions(-) diff --git a/install/Knative-with-AKS.md b/install/Knative-with-AKS.md index e32770b2ed8..28d1ef688c3 100644 --- a/install/Knative-with-AKS.md +++ b/install/Knative-with-AKS.md @@ -132,8 +132,15 @@ Knative depends on Istio. 1. Install Istio: ```bash + kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio-crds.yaml && \ kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio.yaml ``` + Note: the resources (CRDs) defined in the `istio-crds.yaml`file are + also included in the `istio.yaml` file, but they are pulled out so that + the CRD definitions are created first. If you see an error when creating + resources about an unknown type, run the second `kubectl apply` command + again. + 1. Label the default namespace with `istio-injection=enabled`: ```bash diff --git a/install/Knative-with-GKE.md b/install/Knative-with-GKE.md index 6316e901522..fac845db5cc 100644 --- a/install/Knative-with-GKE.md +++ b/install/Knative-with-GKE.md @@ -132,8 +132,15 @@ Knative depends on Istio. 1. Install Istio: ```bash + kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio-crds.yaml && \ kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio.yaml ``` + Note: the resources (CRDs) defined in the `istio-crds.yaml`file are + also included in the `istio.yaml` file, but they are pulled out so that + the CRD definitions are created first. If you see an error when creating + resources about an unknown type, run the second `kubectl apply` command + again. + 1. Label the default namespace with `istio-injection=enabled`: ```bash kubectl label namespace default istio-injection=enabled diff --git a/install/Knative-with-Gardener.md b/install/Knative-with-Gardener.md index 6b79d64af00..4e675ced2a0 100644 --- a/install/Knative-with-Gardener.md +++ b/install/Knative-with-Gardener.md @@ -71,8 +71,15 @@ Knative depends on Istio. 1. Install Istio: ```bash + kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio-crds.yaml && \ kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio.yaml ``` + Note: the resources (CRDs) defined in the `istio-crds.yaml`file are + also included in the `istio.yaml` file, but they are pulled out so that + the CRD definitions are created first. If you see an error when creating + resources about an unknown type, run the second `kubectl apply` command + again. + 2. Label the default namespace with `istio-injection=enabled`: ```bash kubectl label namespace default istio-injection=enabled diff --git a/install/Knative-with-Minishift.md b/install/Knative-with-Minishift.md index 78703cdc5d1..5e1ee0963d2 100644 --- a/install/Knative-with-Minishift.md +++ b/install/Knative-with-Minishift.md @@ -164,13 +164,14 @@ curl -s https://raw.githubusercontent.com/knative/docs/master/install/scripts/is 1. Run the following to install Istio: ```shell + kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio-crds.yaml && \ oc apply -f https://storage.googleapis.com/knative-releases/serving/latest/istio.yaml ``` - - > **NOTE:** If you get a lot of errors after running the above command like: - > **unable to recognize "STDIN": no matches for kind "Gateway" in version - > "networking.istio.io/v1alpha3"**, just run the command above again, it's - > idempotent and hence objects will be created only once. + Note: the resources (CRDs) defined in the `istio-crds.yaml`file are + also included in the `istio.yaml` file, but they are pulled out so that + the CRD definitions are created first. If you see an error when creating + resources about an unknown type, run the second `kubectl apply` command + again. 2. Ensure the istio-sidecar-injector pods runs as provileged: ```shell diff --git a/install/Knative-with-PKS.md b/install/Knative-with-PKS.md index d1361ed569e..a38fe305caf 100644 --- a/install/Knative-with-PKS.md +++ b/install/Knative-with-PKS.md @@ -48,8 +48,15 @@ Containers 1. Install Istio: ```bash + kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio-crds.yaml && \ kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio.yaml ``` + Note: the resources (CRDs) defined in the `istio-crds.yaml`file are + also included in the `istio.yaml` file, but they are pulled out so that + the CRD definitions are created first. If you see an error when creating + resources about an unknown type, run the second `kubectl apply` command + again. + 1. Label the default namespace with `istio-injection=enabled`: ```bash kubectl label namespace default istio-injection=enabled diff --git a/install/Knative-with-any-k8s.md b/install/Knative-with-any-k8s.md index a8922cf711d..3d1fe203b3e 100644 --- a/install/Knative-with-any-k8s.md +++ b/install/Knative-with-any-k8s.md @@ -21,8 +21,15 @@ Containers. 1. Install Istio: ```bash + kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio-crds.yaml && \ kubectl apply --filename https://raw.githubusercontent.com/knative/serving/v0.2.2/third_party/istio-1.0.2/istio.yaml ``` + Note: the resources (CRDs) defined in the `istio-crds.yaml`file are + also included in the `istio.yaml` file, but they are pulled out so that + the CRD definitions are created first. If you see an error when creating + resources about an unknown type, run the second `kubectl apply` command + again. + 1. Label the default namespace with `istio-injection=enabled`: ```bash kubectl label namespace default istio-injection=enabled