Setup SAP Event Mesh as your eventing backend for Kyma Runtime

June 14, 2022 ยท View on GitHub

Setup steps

1. Add the required entitlements to your SAP BTP subaccount

  1. In your BTP subaccount, select Entitlements -> Configure Entitlements.

    Configure Entitlements

  2. Select Add Service Plans.

    Add Service Plans

  3. Search for Event Mesh. Then, select its default and standard (Application) plans and select Add 2 Service Plans.

    Add Service Plans

  4. Save your changes by selecting Save.

    Save your changes

2. Create an instance of SAP Event Mesh service in your Kyma Runtime (default plan)

  1. Go to your Kyma workspace and select Namespaces. Then, select your namespace. For example, select the cdc namespace.

    Select your namespace

  2. Select Service Management -> BTP Service Instances and select Create Service Instance +.

    Create service instance

  3. Enter the name of the instance as enterprise-messaging-client-1, the Offering Name as enterprise-messaging, the Plan Name as default. Then, select the YAML tab.

    Create service instance

  4. Within the YAML tab, add the parameters listed in the next step.

    Create service instance

  5. Copy and paste the following JSON code snippet into the parameters field.

    {
   "options": {
      "management": true,
      "messagingrest": true,
      "messaging": true
   },
   "rules": {
      "topicRules": {
            "publishFilter": [
               "${namespace}/*"
            ],
            "subscribeFilter": [
               "${namespace}/*"
            ]
      },
      "queueRules": {
            "publishFilter": [
               "${namespace}/*"
            ],
            "subscribeFilter": [
               "${namespace}/*"
            ]
      }
   },
   "version": "1.1.0",
   "emname": "enterprise-messaging-client-1",
   "namespace": "default/sap.kyma.custom/cdc.1"
}

  6. Review the JSON code snippet to ensure that the value of emname is the same as the instance name. Then, select Create.

    Create service instance

  7. Wait for the status of the service instance to change to PROVISIONED. Then, select Service Management -> BTP Service Bindings and select Create Service Binding +.

    Create binding

  8. For Name enter enterprise-messaging-client-1-binding and for Service Instance Name, select enterprise-messaging-client-1. Then, select Create.

    Create binding

3. Switch the default eventing of Kyma Runtime from NATS to SAP Event Mesh

  1. After the previous step, wait for the status of the service instance binding to change to PROVISIONED. Then, select the service binding. For example, enterprise-messaging-client-1-binding.

    Create binding

  2. Select the secret.

    Create binding

  3. Select Edit to edit the secret.

    Create binding

  4. Select the YAML tab.

    Create binding

  5. Enter the following YAML code snippet to add the kyma-project.io/eventing-backend: beb label to the Secret. Then, select Update.

    labels:
  kyma-project.io/eventing-backend: beb

    Create binding

Optional steps to setup SAP Event Mesh Enterprise Messaging application in your SAP BTP cockpit

Note: The following steps are optional and allow you to view, manage and monitor the SAP Event Mesh Enterprise Messaging application within your SAP BTP cockpit.

1. Create a subscription for SAP Event Mesh service in your SAP BTP account (standard plan)

  1. Within your BTP subaccount, go to Services > Service Marketplace, search for Event Mesh and click Create.

    Create Event Mesh instance

  2. Select the standard plan and click create.

    Create Event Mesh instance

2. Assign the required Role Collections to the admin user

  1. Assign the required Role Collections to the admin user. In your BTP subaccount, select Security -> Users. Search for your user. Then, select the right arrow below the `Actions' column.

    Select Actions

  2. Scroll down and click on the three dots below Role Collections. Then select Assign Role Collection.

    Select Actions

  3. Select all the following options and select Assign Role Collection.

    • Enterprise Messaging Administrator
    • Enterprise Messaging Developer
    • Enterprise Messaging Display
    • Enterprise Messaging Subscription Administrator
    • Event Mesh Integration Administrator

    Select Actions

3. Navigate to the SAP Event Mesh Enterprise Messaging application

  1. Go to Services -> Instances and Subscriptions and select the Event Mesh application.

    Select Actions

  2. Select kyma-enterprise-messaging-client.

    Select Actions

  3. Navigate through the various tabs and explore the user interface of the SAP Event Mesh Enterprise Messaging application.

    Select Actions

Refer to the following documentation page for more information :arrow_lower_right:

Use Kyma Eventing with SAP Event Mesh

:house::arrow_backward: Setup : Step 6 - Apply the Webhook Event Subscription:arrow_forward: Verification : Step 1 - Verify that all the resources of the app are running