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

  1. You can create a broker in current namespace by entering the following command:

    1. 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.

  2. Optional: Verify that the broker was created by listing existing brokers. Enter the following command:

    1. kn broker list

  3. Optional: You can also verify the broker exists by describing the broker you have created. Enter the following command:

    1. 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.

  1. Create a broker in the current namespace:

    1. kubectl apply -f - <<EOF
    2. apiVersion: eventing.knative.dev/v1
    3. kind: Broker
    4. metadata:
    5.  name: <broker-name>
    6. EOF

  2. Optional: Verify that the broker is working correctly, by entering the following command:

    1. kubectl -n <namespace> get broker <broker-name>

    This shows information about your broker. If the broker is working correctly, it shows a READY status of True:

    1. NAME      READY   REASON   URL                                                                                 AGE
    2. default   True             http://broker-ingress.knative-eventing.svc.cluster.local/event-example/default      1m

    If the READY status is False, wait a few moments and then run the command again.