Install by using the Knative Operator CLI Plugin
Before installing Knative, you must meet the following prerequisites:
For prototyping purposes, Knative works on most local deployments of Kubernetes. For example, you can use a local, one-node cluster that has 3 CPUs and 4 GB of memory.
Tip
You can install a local distribution of Knative for development purposes using the
For production purposes, it is recommended that:
- If you have only one node in your cluster, you need at least 6 CPUs, 6 GB of memory, and 30 GB of disk storage.
- If you have multiple nodes in your cluster, for each node you need at least 2 CPUs, 4 GB of memory, and 20 GB of disk storage.
- You have a cluster that uses Kubernetes v1.23 or newer.
- You have installed the kubectl CLI.
- Your Kubernetes cluster must have access to the internet, because Kubernetes needs to be able to fetch images. To pull from a private registry, see .
Caution
The system requirements provided are recommendations only. The requirements for your installation might vary, depending on whether you use optional components, such as a networking layer.
Install the Knative Operator CLI Plugin
Before you install the Knative Operator CLI Plugin, first install the .
MacOSLinux
Download the binary for your system from the release page.
Download the binary
kn-operator-linux-amd64
for your system from the .Rename the binary to
kn-operator
:mv kn-operator-linux-amd64 kn-operator
Make the plugin executable by running the command:
chmod +x kn-operator
Create the directory for the kn
plugin:
mkdir -p ~/.config/kn/plugins
Move the file to a plugin directory for kn
:
cp kn-operator ~/.config/kn/plugins
You should see more information about how to use this CLI plugin.
Install the Knative Operator
You can install Knative Operator of any specific version under any specific namespace. By default, the namespace is default
, and the version is the latest.
To install the latest version of Knative Operator, run:
kn operator install
To install Knative Operator under a certain namespace, e.g. knative-operator, run:
kn operator install -n knative-operator
To install Knative Operator of a specific version, e.g. 1.7.1, run:
You can install Knative Serving of any specific version under any specific namespace. By default, the namespace is knative-serving
, and the version is the latest.
To install the latest version of Knative Serving, run:
kn operator install --component serving
To install Knative Serving under a certain namespace, e.g. knative-serving, run:
kn operator install --component serving -n knative-serving
To install Knative Operator of a specific version, e.g. 1.7, run:
kn operator install --component serving -n knative-serving -v "1.7"
To install the ingress plugin, e.g Kourier, together with the install command, run:
kn operator install --component serving -n knative-serving -v "1.7" --kourier
If you do not specify the ingress plugin, istio is used as the default. However, you need to make sure you install first.
You can configure the network layer option via the Operator CLI Plugin. Click on each of the following tabs to see how you can configure Knative Serving with different ingresses:
Kourier (Choose this if you are not sure)Istio (default)Contour
The following steps install Kourier and enable its Knative integration:
To configure Knative Serving to use Kourier, run the command as follows:
kn operator enable ingress --kourier -n knative-serving
The following steps install Istio to enable its Knative integration:
To configure Knative Serving to use Istio, run the command as follows:
The following steps install Contour and enable its Knative integration:
Install a properly configured Contour:
kubectl apply --filename https://github.com/knative/net-contour/releases/download/knative-v1.8.0/contour.yaml
To configure Knative Serving to use Contour, run the command as follows:
Installing the Knative Eventing component
You can install Knative Eventing of any specific version under any specific namespace. By default, the namespace is knative-eventing
, and the version is the latest.
To install the latest version of Knative Eventing, run:
kn operator install --component eventing
To install Knative Eventing under a certain namespace, e.g. knative-eventing, run:
kn operator install --component eventing -n knative-eventing
To install Knative Operator of a specific version, e.g. 1.7, run:
kn operator install --component eventing -n knative-eventing -v "1.7"
Installing Knative Eventing with event sources
Knative Operator can configure the Knative Eventing component with different event sources. Click on each of the following tabs to see how you can configure Knative Eventing with different event sources:
CephGitHubGitLabApache KafkaRabbitMQRedis
To install the eventing source Ceph, run the following command:
kn operator enable eventing-source --ceph --namespace knative-eventing
To install the eventing source Github, run the following command:
kn operator enable eventing-source --github --namespace knative-eventing
To install the eventing source Gitlab, run the following command:
kn operator enable eventing-source --gitlab --namespace knative-eventing
To install the eventing source Kafka, run the following command:
kn operator enable eventing-source --kafka --namespace knative-eventing
To install the eventing source RabbitMQ, run the following command:
To install the eventing source Redis, run the following command: