Install on Docker for Mac OS

This guide walks you through the installation of the latest version of 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.

Before you begin

Knative requires a Kubernetes cluster v1.15 or newer. If you don't have one, you can create one using Docker for Mac. If you haven't already, install Docker for Mac 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 in Docker for Mac's preferences. Set CPUs to at least 2 and Memory to at least 6.0 GiB.
  2. Now enable Docker for Mac's Kubernetes capabilities and wait for the cluster to start up.

Installing Istio

Knative depends on Istio or other HTTP loadbalancers for traffic routing and ingress. See the installing Istio for Knative guide, and select the minimal install without sidecar injection or SSL.

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 Knative Serving

Next, install Knative Serving.

Because you have limited resources available, use the https://github.com/knative/serving/releases/download/v0.12.0/serving.yaml file, which installs only Knative Serving:

curl -L https://github.com/knative/serving/releases/download/v0.12.0/serving.yaml \
  | kubectl apply --filename -

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:

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 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, head to the sample apps repo.

Note: You can replace the {IP_ADDRESS} placeholder used in the samples with localhost as mentioned above.

Get started with Knative Eventing by walking through one of the Eventing Samples.

Install Cert-Manager if you want to use the automatic TLS cert provisioning feature.

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.