mirror of https://github.com/knative/docs.git
Add Docker for Mac setup instructions. (#627)
* Add Docker for Mac setup instructions. * Fix prose and typos. * Add Docker for Mac link to global README.
This commit is contained in:
Markus Thömmes
Knative Prow Robot
parent
ef7ef10833
commit
9530cae547
|
|
@ -0,0 +1,120 @@
|
|||
# Knative Install on Docker for Mac
|
||||
|
||||
This guide walks you through the installation of the latest version of
|
||||
[Knative Serving](https://github.com/knative/serving) using pre-built images and
|
||||
demonstrates creating and deploying an image of a sample "hello world" app onto
|
||||
the newly created Knative cluster.
|
||||
|
||||
You can find [guides for other platforms here](README.md).
|
||||
|
||||
## Before you begin
|
||||
|
||||
Knative requires a Kubernetes cluster v1.10 or newer. If you don't have one, you
|
||||
can create one using [Docker for Mac](https://docs.docker.com/docker-for-mac/).
|
||||
If you haven't already,
|
||||
[install Docker for Mac](https://docs.docker.com/docker-for-mac/install/) before
|
||||
continuing.
|
||||
|
||||
## Creating a Kubernetes cluster
|
||||
|
||||
1. After Docker for Mac is installed, configure it with sufficient resources.
|
||||
You can do that via the
|
||||
[_Advanced_ menu](https://docs.docker.com/docker-for-mac/#advanced) in Docker
|
||||
for Mac's preferences. Set **CPUs** to at least **4** and **Memory** to at
|
||||
least **8.0 GiB**.
|
||||
1. Now enable Docker for Mac's
|
||||
[Kubernetes capabilities](https://docs.docker.com/docker-for-mac/#kubernetes)
|
||||
and wait for the cluster to start up.
|
||||
|
||||
## Installing Istio
|
||||
|
||||
Knative depends on Istio. Run the following to install Istio. (This changes
|
||||
`LoadBalancer` to `NodePort` for the `istio-ingress` service).
|
||||
|
||||
```shell
|
||||
curl -L https://raw.githubusercontent.com/knative/serving/v0.2.1/third_party/istio-1.0.2/istio.yaml \
|
||||
| sed 's/LoadBalancer/NodePort/' \
|
||||
| kubectl apply --filename -
|
||||
|
||||
# Label the default namespace with istio-injection=enabled.
|
||||
kubectl label namespace default istio-injection=enabled
|
||||
```
|
||||
|
||||
Monitor the Istio components until all of the components show a `STATUS` of
|
||||
`Running` or `Completed`:
|
||||
|
||||
```shell
|
||||
kubectl get pods --namespace istio-system
|
||||
```
|
||||
|
||||
It will take a few minutes for all the components to be up and running; you can
|
||||
rerun the command to see the current status.
|
||||
|
||||
> Note: Instead of rerunning the command, you can add `--watch` to the above
|
||||
> command to view the component's status updates in real time. Use CTRL+C to
|
||||
> exit watch mode.
|
||||
|
||||
## Installing Knative Serving
|
||||
|
||||
Next, install [Knative Serving](https://github.com/knative/serving).
|
||||
|
||||
Because you have limited resources available, use the
|
||||
`https://github.com/knative/serving/releases/download/v0.2.1/release-lite.yaml`
|
||||
file, which omits some of the monitoring components to reduce the memory used by
|
||||
the Knative components. To use the provided `release-lite.yaml` release, run:
|
||||
|
||||
```shell
|
||||
curl -L https://github.com/knative/serving/releases/download/v0.2.1/release-lite.yaml
|
||||
```
|
||||
|
||||
> Note: Unlike minikube, we're not changing the LoadBalancer to a NodePort here.
|
||||
> Docker for Mac will assign `localhost` as the host for that LoadBalancer,
|
||||
> making the applications available easily.
|
||||
|
||||
Monitor the Knative components until all of the components show a `STATUS` of
|
||||
`Running`:
|
||||
|
||||
```shell
|
||||
kubectl get pods --namespace knative-serving
|
||||
```
|
||||
|
||||
Just as with the Istio components, it will take a few seconds for the Knative
|
||||
components to be up and running; you can rerun the command to see the current
|
||||
status.
|
||||
|
||||
> Note: Instead of rerunning the command, you can add `--watch` to the above
|
||||
> command to view the component's status updates in real time. Use CTRL+C to
|
||||
> exit watch mode.
|
||||
|
||||
Now you can deploy an app to your newly created Knative cluster.
|
||||
|
||||
## Deploying an app
|
||||
|
||||
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
|
||||
Knative, check out the
|
||||
[Getting Started with Knative App Deployment](getting-started-knative-app.md)
|
||||
guide.
|
||||
|
||||
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.
|
||||
|
||||
> Note: You can replace the {IP_ADDRESS} placeholder used in the samples with
|
||||
> `localhost` as mentioned above.
|
||||
|
||||
## Cleaning up
|
||||
|
||||
Docker for Mac supports several levels of resetting its state and thus cleaning
|
||||
up.
|
||||
|
||||
To reset only the Kubernetes cluster to a fresh one, click "Reset Kubernetes
|
||||
cluster" in the
|
||||
[_Reset_ preferences](https://docs.docker.com/docker-for-mac/#reset).
|
||||
|
||||
---
|
||||
|
||||
Except as otherwise noted, the content of this page is licensed under the
|
||||
[Creative Commons Attribution 4.0 License](https://creativecommons.org/licenses/by/4.0/),
|
||||
and code samples are licensed under the
|
||||
[Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0).
|
||||
|
|
@ -30,6 +30,7 @@ Knative components on the following platforms:
|
|||
- [Knative Install on OpenShift](Knative-with-OpenShift.md)
|
||||
- [Knative Install on Minishift](Knative-with-Minishift.md)
|
||||
- [Knative Install on Pivotal Container Service](Knative-with-PKS.md)
|
||||
- [Knative Install on Docker for Mac](Knative-with-Docker-for-Mac.md)
|
||||
|
||||
If you already have a Kubernetes cluster you're comfortable installing _alpha_
|
||||
software on, use the following instructions:
|
||||
|
|
|
|||
Loading…
Reference in New Issue