Tweaks docs to create Istio CRDs first - part 2 (#731)

Continuation of #717 - get the rest of the install docs

Signed-off-by: Doug Davis <[email protected]>

Author: Doug Davis

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

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

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

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

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

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