Add note about retrying install commands (#1051)

docs/install/Knative-custom-install.md

@@ -155,6 +155,12 @@ Each Knative component must be installed individually. You can decide which
 components and observability plugins to install based on what you plan to do
 with Knative.
 
+> **Note**: If your install fails on the first attempt, try rerunning the commands.
+  They will likely succeed on the second attempt. For background info and to
+  track the upcoming solution to this problem, see issues
+  [#968](https://github.com/knative/docs/issues/968) and
+  [#1036](https://github.com/knative/docs/issues/1036).
+
 ### Choosing Knative installation files
 
 The following Knative installation files are available:

docs/install/Knative-with-AKS.md

@@ -190,8 +190,15 @@ your Knative installation, see
    --filename https://github.com/knative/serving/releases/download/v0.4.0/monitoring.yaml \
    --filename https://raw.githubusercontent.com/knative/serving/v0.4.0/third_party/config/build/clusterrole.yaml
    ```
+   > **Note**: If your install fails on the first attempt, try rerunning the commands.
+     They will likely succeed on the second attempt. For background info and to
+     track the upcoming solution to this problem, see issues
+     [#968](https://github.com/knative/docs/issues/968) and
+     [#1036](https://github.com/knative/docs/issues/1036).
+
    > **Note**: For the v0.4.0 release and newer, the `clusterrole.yaml` file is
    > required to enable the Build and Serving components to interact with each other.
+
 1. Monitor the Knative components until all of the components show a `STATUS` of
    `Running`:
    ```bash

docs/install/Knative-with-GKE.md

@@ -191,6 +191,12 @@ see [Performing a Custom Knative Installation](./Knative-custom-install.md).
    --filename https://github.com/knative/serving/releases/download/v0.4.0/monitoring.yaml \
    --filename https://raw.githubusercontent.com/knative/serving/v0.4.0/third_party/config/build/clusterrole.yaml
    ```
+   > **Note**: If your install fails on the first attempt, try rerunning the commands.
+     They will likely succeed on the second attempt. For background info and to
+     track the upcoming solution to this problem, see issues
+     [#968](https://github.com/knative/docs/issues/968) and
+     [#1036](https://github.com/knative/docs/issues/1036).
+     
    > **Note**: For the v0.4.0 release and newer, the `clusterrole.yaml` file is
    > required to enable the Build and Serving components to interact with each other.
 1. Monitor the Knative components until all of the components show a `STATUS` of

docs/install/Knative-with-Gardener.md

@@ -126,6 +126,12 @@ see [Performing a Custom Knative Installation](./Knative-custom-install.md).
    --filename https://github.com/knative/serving/releases/download/v0.4.0/monitoring.yaml \
    --filename https://raw.githubusercontent.com/knative/serving/v0.4.0/third_party/config/build/clusterrole.yaml
    ```
+   > **Note**: If your install fails on the first attempt, try rerunning the commands.
+     They will likely succeed on the second attempt. For background info and to
+     track the upcoming solution to this problem, see issues
+     [#968](https://github.com/knative/docs/issues/968) and
+     [#1036](https://github.com/knative/docs/issues/1036).
+
    > **Note**: For the v0.4.0 release and newer, the `clusterrole.yaml` file is
    > required to enable the Build and Serving components to interact with each other.
 1. Monitor the Knative components until all of the components show a `STATUS` of

docs/install/Knative-with-ICP.md

@@ -176,6 +176,12 @@ see [Performing a Custom Knative Installation](./Knative-custom-install.md).
      | sed 's/LoadBalancer/NodePort/' \
      | kubectl apply --filename -
    ```
+   > **Note**: If your install fails on the first attempt, try rerunning the commands.
+     They will likely succeed on the second attempt. For background info and to
+     track the upcoming solution to this problem, see issues
+     [#968](https://github.com/knative/docs/issues/968) and
+     [#1036](https://github.com/knative/docs/issues/1036).
+        
    > **Note**: For the v0.4.0 release and newer, the `clusterrole.yaml` file is
    > required to enable the Build and Serving components to interact with each other.
    

docs/install/Knative-with-IKS.md

@@ -187,6 +187,12 @@ see [Performing a Custom Knative Installation](./Knative-custom-install.md).
    --filename https://github.com/knative/serving/releases/download/v0.4.0/monitoring.yaml \
    --filename https://raw.githubusercontent.com/knative/serving/v0.4.0/third_party/config/build/clusterrole.yaml
    ```
+   > **Note**: If your install fails on the first attempt, try rerunning the commands.
+     They will likely succeed on the second attempt. For background info and to
+     track the upcoming solution to this problem, see issues
+     [#968](https://github.com/knative/docs/issues/968) and
+     [#1036](https://github.com/knative/docs/issues/1036).
+        
    > **Note**: For the v0.4.0 release and newer, the `clusterrole.yaml` file is
    > required to enable the Build and Serving components to interact with each other.
 1. Monitor the Knative components until all of the components show a `STATUS` of

docs/install/Knative-with-PKS.md

@@ -100,6 +100,12 @@ see [Performing a Custom Knative Installation](./Knative-custom-install.md).
    --filename https://github.com/knative/serving/releases/download/v0.4.0/monitoring.yaml \
    --filename https://raw.githubusercontent.com/knative/serving/v0.4.0/third_party/config/build/clusterrole.yaml
    ```
+   > **Note**: If your install fails on the first attempt, try rerunning the commands.
+     They will likely succeed on the second attempt. For background info and to
+     track the upcoming solution to this problem, see issues
+     [#968](https://github.com/knative/docs/issues/968) and
+     [#1036](https://github.com/knative/docs/issues/1036).
+        
    > **Note**: For the v0.4.0 release and newer, the `clusterrole.yaml` file is
    > required to enable the Build and Serving components to interact with each other.
 1. Monitor the Knative components until all of the components show a `STATUS` of

docs/install/Knative-with-any-k8s.md

@@ -80,6 +80,11 @@ your Knative installation, see
    --filename https://github.com/knative/serving/releases/download/v0.4.0/monitoring.yaml \
    --filename https://raw.githubusercontent.com/knative/serving/v0.4.0/third_party/config/build/clusterrole.yaml
    ```
+   > **Note**: If your install fails on the first attempt, try rerunning the commands.
+     They will likely succeed on the second attempt. For background info and to
+     track the upcoming solution to this problem, see issues
+     [#968](https://github.com/knative/docs/issues/968) and
+     [#1036](https://github.com/knative/docs/issues/1036).
      
    > **Note**: For the v0.4.0 release and newer, the `clusterrole.yaml` file is
    > required to enable the Build and Serving components to interact with each other.