Welcome to the Knative Quickstart tutorial¶
Deploy an HTTP Service, watch it scale to zero, split traffic between two Revisions, and send an event back to its source. This is the first hands-on path for newcomers to Knative.
Your learning route¶
Use a local kind cluster created by the quickstart plugin and the Knative CLI (kn). You will also use kubectl, curl, and a browser. No existing Knative installation or container registry account is required for this route. The examples use published container images.
- Install the local Quickstart environment.
- Deploy and request your first Service.
- Observe scale-to-zero and scale-up.
- Split traffic between two Revisions.
- Try Eventing, then inspect the Broker.
- Send an event with the CloudEvents Player.
- Route the event back with a Trigger.
- Choose a next step and clean up the cluster.
Stay on the same cluster in the default namespace. Each lesson builds on the preceding lesson. Supporting YAML examples are available for comparison, not a second required route.
The installation snippets retain other platform options. For this exercise, choose kind when you reach the cluster installation step. Functions is a separate follow-on exercise that requires additional tooling and, for deployment, a container registry.
Before you begin¶
Warning
Knative quickstart environments are for experimentation only.
To administer Knative on an existing cluster, start with Installing Knative.
Installing components alone does not establish production readiness; review your security, availability, observability, and upgrade requirements.
Before you can get started with a Knative quickstart deployment you must install:
-
kind (Kubernetes in Docker) or minikube to enable you to run a local Kubernetes cluster with Docker container nodes.
-
The Kubernetes CLI (
kubectl) to run commands against Kubernetes clusters. You can usekubectlto deploy applications, inspect and manage cluster resources, and view logs. -
The Knative CLI (
kn). For instructions, see the next section. -
You need to have a minimum of 3 CPUs and 3 GB of RAM available for the cluster to be created.
Install and start Docker before beginning, and have curl available. See kind's requirements for supported container runtimes and host setup.
Next: Install Quickstart