diff --git a/docs/install/Knative-custom-install.md b/docs/install/Knative-custom-install.md index 201f9aea0..3bad8cffd 100644 --- a/docs/install/Knative-custom-install.md +++ b/docs/install/Knative-custom-install.md @@ -41,6 +41,10 @@ If you prefer to install Istio manually, see the > Note: [Ambassador](./Knative-with-Ambassador.md) and > [Gloo](./Knative-with-Gloo.md) are available as an alternative to Istio. +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ## Installing Knative components Each Knative component must be installed individually. You can decide which diff --git a/docs/install/Knative-with-AKS.md b/docs/install/Knative-with-AKS.md index 662d607a7..af4470661 100644 --- a/docs/install/Knative-with-AKS.md +++ b/docs/install/Knative-with-AKS.md @@ -146,10 +146,14 @@ You must install Istio on your Kubernetes cluster before continuing with these instructions to install Knative. > Note: [Ambassador](https://www.getambassador.io/) and -> [Gloo](https://gloo.solo.io/) are available as an alternative to Istio. +> [Gloo](https://docs.solo.io/gloo/latest/) are available as an alternative to Istio. > [Click here](./Knative-with-Ambassador.md) to install Knative with Ambassador. > [Click here](./Knative-with-Gloo.md) to install Knative with Gloo. +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ## Installing Knative The following commands install all available Knative components. To customize diff --git a/docs/install/Knative-with-Docker-for-Mac.md b/docs/install/Knative-with-Docker-for-Mac.md index c88b1299b..73c48277f 100644 --- a/docs/install/Knative-with-Docker-for-Mac.md +++ b/docs/install/Knative-with-Docker-for-Mac.md @@ -47,6 +47,10 @@ managed Istio installation, or if you're installing Knative locally using Minkube or similar, see the [Installing Istio for Knative guide](./installing-istio.md). +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ## Installing Knative Serving Next, install [Knative Serving](https://github.com/knative/serving). diff --git a/docs/install/Knative-with-GKE.md b/docs/install/Knative-with-GKE.md index 6dd0a89a7..9f20cd244 100644 --- a/docs/install/Knative-with-GKE.md +++ b/docs/install/Knative-with-GKE.md @@ -148,6 +148,10 @@ gcloud beta container clusters create $CLUSTER_NAME \ Admin permissions are required to create the necessary [RBAC rules for Knative](https://istio.io/docs/concepts/security/rbac/). +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ## Installing Knative The following commands install all available Knative components as well as the diff --git a/docs/install/Knative-with-Gardener.md b/docs/install/Knative-with-Gardener.md index f3b1dc908..98eb2698f 100644 --- a/docs/install/Knative-with-Gardener.md +++ b/docs/install/Knative-with-Gardener.md @@ -82,6 +82,10 @@ to install Istio. You must install Istio on your Kubernetes cluster before continuing with these instructions to install Knative. +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ## Installing Knative The following commands install all available Knative components as well as the diff --git a/docs/install/Knative-with-ICP.md b/docs/install/Knative-with-ICP.md index e2e2dcd6b..b5df64f68 100644 --- a/docs/install/Knative-with-ICP.md +++ b/docs/install/Knative-with-ICP.md @@ -130,6 +130,10 @@ If you prefer to install Istio manually, see the You must install Istio on your Kubernetes cluster before continuing with these instructions to install Knative. +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ## Installing Knative The following commands install all available Knative components as well as the diff --git a/docs/install/Knative-with-IKS.md b/docs/install/Knative-with-IKS.md index 0d5f05366..a873e84e9 100644 --- a/docs/install/Knative-with-IKS.md +++ b/docs/install/Knative-with-IKS.md @@ -166,6 +166,10 @@ Minkube or similar, see the You must install Istio on your Kubernetes cluster before continuing with these instructions to install Knative. +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ### Installing Knative The following commands install all available Knative components as well as the diff --git a/docs/install/Knative-with-Minikube.md b/docs/install/Knative-with-Minikube.md index b5937e780..c8b5f1154 100644 --- a/docs/install/Knative-with-Minikube.md +++ b/docs/install/Knative-with-Minikube.md @@ -71,10 +71,14 @@ Minkube or similar, see the [Installing Istio for Knative guide](./installing-istio.md). > Note: [Ambassador](https://www.getambassador.io/) and -> [Gloo](https://gloo.solo.io/) are available as an alternative to Istio. +> [Gloo](https://docs.solo.io/gloo/latest/) are available as an alternative to Istio. > [Click here](./Knative-with-Ambassador.md) to install Knative with Ambassador. > [Click here](./Knative-with-Gloo.md) to install Knative with Gloo. +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ## Installing Knative The following commands install all available Knative components as well as the diff --git a/docs/install/Knative-with-PKS.md b/docs/install/Knative-with-PKS.md index eae21259a..c72583291 100644 --- a/docs/install/Knative-with-PKS.md +++ b/docs/install/Knative-with-PKS.md @@ -51,7 +51,7 @@ https://docs.pivotal.io/runtimes/pks/1-1/cluster-credentials.html. Knative depends on Istio. If your cloud platform offers a managed Istio installation, we recommend installing Istio that way, unless you need the ability to customize your installation. For example, the -[GKE Install Guide](./knative-with-gke.md) includes the instructions for +[GKE Install Guide](./Knative-with-GKE.md) includes the instructions for installing Istio on your cluster using `gcloud`. If you prefer to install Istio manually, if your cloud provider doesn't offer a @@ -62,6 +62,10 @@ Minkube or similar, see the You must install Istio on your Kubernetes cluster before continuing with these instructions to install Knative. +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ## Installing Knative The following commands install all available Knative components as well as the diff --git a/docs/install/Knative-with-any-k8s.md b/docs/install/Knative-with-any-k8s.md index 0f0b5ff4a..0e5b568ae 100644 --- a/docs/install/Knative-with-any-k8s.md +++ b/docs/install/Knative-with-any-k8s.md @@ -22,7 +22,7 @@ commands will need to be adjusted for use in a Windows environment. Knative depends on Istio. If your cloud platform offers a managed Istio installation, we recommend installing Istio that way, unless you need the ability to customize your installation. For example, the -[GKE Install Guide](./knative-with-gke.md) includes the instructions for +[GKE Install Guide](./Knative-with-GKE.md) includes the instructions for installing Istio on your cluster using `gcloud`. If you prefer to install Istio manually, if your cloud provider doesn't offer a @@ -33,6 +33,10 @@ Minkube or similar, see the You must install Istio on your Kubernetes cluster before continuing with these instructions to install Knative. +## Installing `cluster-local-gateway` for serving cluster-internal traffic + +If you installed Istio, you can install a `cluster-local-gateway` within your Knative cluster so that you can serve cluster-internal traffic. If you want to configure your revisions to use routes that are visible only within your cluster, [install and use the `cluster-local-gateway`](./installing-istio.md#updating-your-install-to-use-cluster-local-gateway). + ## Installing Knative The following commands install all available Knative components. To customize diff --git a/docs/install/installing-istio.md b/docs/install/installing-istio.md index 870d6fa35..70e9a16e8 100644 --- a/docs/install/installing-istio.md +++ b/docs/install/installing-istio.md @@ -244,6 +244,21 @@ helm template --namespace=istio-system \ kubectl apply -f istio-local-gateway.yaml ``` +Alternatively, if you want to install the cluster local gateway for **development purposes**, enter the following command +without `helm` for an easy installation: + +```shell +# Istio minor version should be 1.2 or 1.3 +export ISTIO_MINOR_VERSION=1.2 + +export VERSION=$(curl https://raw.githubusercontent.com/knative/serving/master/third_party/istio-${ISTIO_MINOR_VERSION}-latest) + +kubectl apply -f https://raw.githubusercontent.com/knative/serving/master/third_party/${VERSION}/istio-knative-extras.yaml +``` + +**Note:** This method is only for development purposes. The production readiness of the above +installation method is not ensured. For a production-ready installation, see the `helm` installation method above. + ### Verifying your Istio install View the status of your Istio installation to make sure the install was