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.14 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 6 and Memory to at least 8.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 for traffic routing and ingress. You have the option of injecting Istio sidecars and enabling the Istio service mesh, but it’s not required for all Knative components.

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

Next, install Knative Serving.

Because you have limited resources available, use the file, which installs only Knative Serving:

curl -L \
  | sed 's/LoadBalancer/NodePort/' \
  | 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.

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.