Creating a broker
Once you have installed Knative Eventing, you can create an instance of the multi-tenant (MT) channel-based broker that is provided by default. The default backing channel type for an MT channel-based broker is InMemoryChannel.
You can create a broker by using the kn
CLI or by applying YAML files using kubectl
.
kn
You can create a broker in current namespace by entering the following command:
kn broker create <broker-name> -n <namespace>
NOTE: If you choose not to specify a namespace, the broker will be created in the current namespace.
Optional: Verify that the broker was created by listing existing brokers. Enter the following command:
kn broker list
Optional: You can also verify the broker exists by describing the broker you have created. Enter the following command:
kn broker describe <broker-name>
kubectl
The YAML in the following example creates a broker named default
in the current namespace. For more information about configuring broker options using YAML, see the full broker configuration example.
Create a broker in the current namespace by creating a YAML file using the following template:
apiVersion: eventing.knative.dev/v1
kind: Broker
metadata:
name: <broker-name>
Apply the YAML file by running the command:
kubectl apply -f <filename>.yaml
Where
<filename>
is the name of the file you created in the previous step.Optional: Verify that the broker is working correctly, by entering the following command:
kubectl -n <namespace> get broker <broker-name>
This shows information about your broker. If the broker is working correctly, it shows a
READY
status ofTrue
:NAME READY REASON URL AGE
default True http://broker-ingress.knative-eventing.svc.cluster.local/event-example/default 1m
If the
READY
status isFalse
, wait a few moments and then run the command again.