Skip to content

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.

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

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

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

    kn broker describe <broker-name>
    

The YAML in the following example creates a broker named default in the current namespace.

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

  3. 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 of True:

    NAME      READY   REASON   URL                                                                                 AGE
    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.

Back to top

We use analytics and cookies to understand site traffic. Information about your use of our site is shared with Google for that purpose. Learn more.

× OK