knative
/
docs
mirror of https://github.com/knative/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/install/Knative-custom-install.md
View File

@ -41,6 +41,10 @@ If you prefer to install Istio manually, see the
> Note: [Ambassador](./Knative-with-Ambassador.md) and > Note: [Ambassador](./Knative-with-Ambassador.md) and
> [Gloo](./Knative-with-Gloo.md) are available as an alternative to Istio. > [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 ## Installing Knative components
Each Knative component must be installed individually. You can decide which Each Knative component must be installed individually. You can decide which

6
docs/install/Knative-with-AKS.md
View File

@ -146,10 +146,14 @@ You must install Istio on your Kubernetes cluster before continuing with these
instructions to install Knative. instructions to install Knative.
> Note: [Ambassador](https://www.getambassador.io/) and > 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-Ambassador.md) to install Knative with Ambassador.
> [Click here](./Knative-with-Gloo.md) to install Knative with Gloo. > [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 ## Installing Knative
The following commands install all available Knative components. To customize The following commands install all available Knative components. To customize

4
docs/install/Knative-with-Docker-for-Mac.md
View File

@ -47,6 +47,10 @@ managed Istio installation, or if you're installing Knative locally using
Minkube or similar, see the Minkube or similar, see the
[Installing Istio for Knative guide](./installing-istio.md). [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 ## Installing Knative Serving
Next, install [Knative Serving](https://github.com/knative/serving). Next, install [Knative Serving](https://github.com/knative/serving).

4
docs/install/Knative-with-GKE.md
View File

@ -148,6 +148,10 @@ gcloud beta container clusters create $CLUSTER_NAME \
Admin permissions are required to create the necessary Admin permissions are required to create the necessary
[RBAC rules for Knative](https://istio.io/docs/concepts/security/rbac/). [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 ## Installing Knative
The following commands install all available Knative components as well as the The following commands install all available Knative components as well as the

4
docs/install/Knative-with-Gardener.md
View File

@ -82,6 +82,10 @@ to install Istio.
You must install Istio on your Kubernetes cluster before continuing with these You must install Istio on your Kubernetes cluster before continuing with these
instructions to install Knative. 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 ## Installing Knative
The following commands install all available Knative components as well as the The following commands install all available Knative components as well as the

4
docs/install/Knative-with-ICP.md
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 You must install Istio on your Kubernetes cluster before continuing with these
instructions to install Knative. 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 ## Installing Knative
The following commands install all available Knative components as well as the The following commands install all available Knative components as well as the

4
docs/install/Knative-with-IKS.md
View File

@ -166,6 +166,10 @@ Minkube or similar, see the
You must install Istio on your Kubernetes cluster before continuing with these You must install Istio on your Kubernetes cluster before continuing with these
instructions to install Knative. 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 ### Installing Knative
The following commands install all available Knative components as well as the The following commands install all available Knative components as well as the

6
docs/install/Knative-with-Minikube.md
View File

@ -71,10 +71,14 @@ Minkube or similar, see the
[Installing Istio for Knative guide](./installing-istio.md). [Installing Istio for Knative guide](./installing-istio.md).
> Note: [Ambassador](https://www.getambassador.io/) and > 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-Ambassador.md) to install Knative with Ambassador.
> [Click here](./Knative-with-Gloo.md) to install Knative with Gloo. > [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 ## Installing Knative
The following commands install all available Knative components as well as the The following commands install all available Knative components as well as the

6
docs/install/Knative-with-PKS.md
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 Knative depends on Istio. If your cloud platform offers a managed Istio
installation, we recommend installing Istio that way, unless you need the installation, we recommend installing Istio that way, unless you need the
ability to customize your installation. For example, 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`. installing Istio on your cluster using `gcloud`.
If you prefer to install Istio manually, if your cloud provider doesn't offer a 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 You must install Istio on your Kubernetes cluster before continuing with these
instructions to install Knative. 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 ## Installing Knative
The following commands install all available Knative components as well as the The following commands install all available Knative components as well as the

6
docs/install/Knative-with-any-k8s.md
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 Knative depends on Istio. If your cloud platform offers a managed Istio
installation, we recommend installing Istio that way, unless you need the installation, we recommend installing Istio that way, unless you need the
ability to customize your installation. For example, 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`. installing Istio on your cluster using `gcloud`.
If you prefer to install Istio manually, if your cloud provider doesn't offer a 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 You must install Istio on your Kubernetes cluster before continuing with these
instructions to install Knative. 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 ## Installing Knative
The following commands install all available Knative components. To customize The following commands install all available Knative components. To customize

15
docs/install/installing-istio.md
View File

@ -244,6 +244,21 @@ helm template --namespace=istio-system \
kubectl apply -f istio-local-gateway.yaml 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 ### Verifying your Istio install
View the status of your Istio installation to make sure the install was View the status of your Istio installation to make sure the install was