add the instruction to install cluster local gateway (#1911)

* add the instruction to install cluster local gateway

* address coments

* update the link

* fix the test failure

* Update docs/install/installing-istio.md

Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com>

* Update docs/install/installing-istio.md

Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com>

* Update docs/install/installing-istio.md

Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com>

* Update docs/install/installing-istio.md

Co-Authored-By: Sam O'Dell <31352624+samodell@users.noreply.github.com>

Co-authored-by: Sam O'Dell <31352624+samodell@users.noreply.github.com>
This commit is contained in:
Zhimin Xiang 2019-12-20 16:54:35 -08:00 committed by Knative Prow Robot
parent 2562f43d54
commit 0b0babac77
11 changed files with 59 additions and 4 deletions

View File

@ -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

View File

@ -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

View File

@ -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).

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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