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

Update documentation to clean up Docker for Mac and remove some old Istio-1.0-isms. (#2082)

This commit is contained in:
Evan Anderson 2020-01-06 09:45:49 -08:00 committed by Knative Prow Robot
parent 4abb2f9d5a
commit f57f42545e
2 changed files with 23 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -25,43 +25,37 @@ continuing.
1. After Docker for Mac is installed, configure it with sufficient resources. 1. After Docker for Mac is installed, configure it with sufficient resources.
You can do that via the You can do that via the
[_Advanced_ menu](https://docs.docker.com/docker-for-mac/#advanced) in Docker [_Advanced_ menu](https://docs.docker.com/docker-for-mac/#advanced) in Docker
for Mac's preferences. Set **CPUs** to at least **6** and **Memory** to at for Mac's preferences. Set **CPUs** to at least **2** and **Memory** to at
least **8.0 GiB**. least **6.0 GiB**.
1. Now enable Docker for Mac's 1. Now enable Docker for Mac's
[Kubernetes capabilities](https://docs.docker.com/docker-for-mac/#kubernetes) [Kubernetes capabilities](https://docs.docker.com/docker-for-mac/#kubernetes)
and wait for the cluster to start up. and wait for the cluster to start up.
## Installing Istio ## Installing Istio
Knative depends on [Istio](https://istio.io/docs/concepts/what-is-istio/) for Knative depends on [Istio](https://istio.io/docs/concepts/what-is-istio/) or
traffic routing and ingress. You have the option of injecting Istio sidecars and other HTTP loadbalancers for traffic routing and ingress. See the
enabling the Istio service mesh, but it's not required for all Knative [installing Istio for Knative guide](./installing-istio.md), and
components. [select the minimal install without sidecar injection or SSL](./installing-istio.md#installing-istio-without-sidecar-injection).
If your cloud platform offers a managed Istio installation, we recommend
installing Istio that way, unless you need the ability to customize your
installation.
If you prefer to install Istio manually, if your cloud provider doesn't offer a
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 ## 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). 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).
Because you have limited resources available, use the Because you have limited resources available, use the
`https://github.com/knative/serving/releases/download/{{< version >}}/serving.yaml` file, `https://github.com/knative/serving/releases/download/{{< version >}}/serving.yaml`
which installs only Knative Serving: file, which installs only Knative Serving:
```shell ```shell
curl -L https://github.com/knative/serving/releases/download/{{< version >}}/serving.yaml \ curl -L https://github.com/knative/serving/releases/download/{{< version >}}/serving.yaml \
| sed 's/LoadBalancer/NodePort/' \
| kubectl apply --filename - | kubectl apply --filename -
``` ```
@ -93,7 +87,8 @@ Now that your cluster has Knative installed, you're ready to deploy an app.
If you'd like to follow a step-by-step guide for deploying your first app on If you'd like to follow a step-by-step guide for deploying your first app on
Knative, check out the Knative, check out the
[Getting Started with Knative App Deployment](../serving/getting-started-knative-app.md) [Getting Started with Knative App Deployment](../serving/getting-started-knative-app.md)
guide. guide. Note that (as of 1.11) you'll need to push your docker images to
DockerHub rather than only building them locally.
If you'd like to view the available sample apps and deploy one of your choosing, If you'd like to view the available sample apps and deploy one of your choosing,
head to the [sample apps](../serving/samples/README.md) repo. head to the [sample apps](../serving/samples/README.md) repo.
@ -104,8 +99,8 @@ head to the [sample apps](../serving/samples/README.md) repo.
Get started with Knative Eventing by walking through one of the Get started with Knative Eventing by walking through one of the
[Eventing Samples](../eventing/samples/). [Eventing Samples](../eventing/samples/).
[Install Cert-Manager](../serving/installing-cert-manager.md) if you want to use the [Install Cert-Manager](../serving/installing-cert-manager.md) if you want to use
[automatic TLS cert provisioning feature](../serving/using-auto-tls.md). the [automatic TLS cert provisioning feature](../serving/using-auto-tls.md).
## Cleaning up ## Cleaning up
@ -115,5 +110,3 @@ up.
To reset only the Kubernetes cluster to a fresh one, click "Reset Kubernetes To reset only the Kubernetes cluster to a fresh one, click "Reset Kubernetes
cluster" in the cluster" in the
[_Reset_ preferences](https://docs.docker.com/docker-for-mac/#reset). [_Reset_ preferences](https://docs.docker.com/docker-for-mac/#reset).

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

@ -57,7 +57,7 @@ without automatic sidecar injection.
```shell ```shell
# Download and unpack Istio # Download and unpack Istio
export ISTIO_VERSION=1.3.5 export ISTIO_VERSION=1.3.6
curl -L https://git.io/getLatestIstio | sh - curl -L https://git.io/getLatestIstio | sh -
cd istio-${ISTIO_VERSION} cd istio-${ISTIO_VERSION}
``` ```
@ -220,9 +220,9 @@ helm template --namespace=istio-system \
### Updating your install to use cluster local gateway ### Updating your install to use cluster local gateway
If you want your Routes to be visible only inside the cluster, you may want to If you want your Routes to be visible only inside the cluster, you may want to
enable [cluster local routes](../serving/cluster-local-route.md). To use enable [cluster local routes](../serving/cluster-local-route.md). To use this
this feature, add an extra Istio cluster local gateway to your cluster. Enter feature, add an extra Istio cluster local gateway to your cluster. Enter the
the following command to add the cluster local gateway to an existing Istio following command to add the cluster local gateway to an existing Istio
installation: installation:
```shell ```shell
@ -274,12 +274,12 @@ kubectl get pods --namespace istio-system
> Tip: You can append the `--watch` flag to the `kubectl get` commands to view > Tip: You can append the `--watch` flag to the `kubectl get` commands to view
> the pod status in realtime. You use `CTRL + C` to exit watch mode. > the pod status in realtime. You use `CTRL + C` to exit watch mode.
### Configuring DNS ### Configuring DNS
Knative dispatches to different services based on their hostname, so it greatly Knative dispatches to different services based on their hostname, so it greatly
simplifies things to have DNS properly configured. For this, we must look up the simplifies things to have DNS properly configured. For this, we must look up the
external IP address that Gloo received. This can be done with the following command: external IP address that Istio received. This can be done with the following
command:
``` ```
$ kubectl get svc -nistio-system $ kubectl get svc -nistio-system