Help Center/ FunctionGraph/ User Guide/ Creating Triggers/ Using an EG Trigger/ Creating an EG Trigger (RocketMQ Custom Event Source)
Updated on 2024-12-18 GMT+08:00

Creating an EG Trigger (RocketMQ Custom Event Source)

Prerequisites

Before creating a trigger, ensure that you have completed the following operations:

  • Currently, EG triggers are available only in AP-Bangkok, AP-Singapore, AF-Johannesburg, LA-Mexico City2, and LA-Santiago.
  • The VPC bound to the function must be the same as the VPC of the RocketMQ instance. After VPC access is enabled, you need to configure corresponding subnet permissions for the RocketMQ security group.

Creating an EG Trigger

  1. Log in to the FunctionGraph console. In the navigation pane, choose Functions > Function List.
  2. Click the function to be configured to go to the function details page.
  3. Choose Configuration > Triggers and click Create Trigger.

    Figure 1 Creating a trigger

  4. Set the following parameters:

    • Trigger Type: Select DMS (for HC.RocketMQ).
    • Trigger Name: Enter a trigger name.
    • Event Channel: Select an existing channel.
    • *Instance: Select a RocketMQ instance.
    • Topic: Select a RocketMQ topic.
    • Consumer Group: Select a RocketMQ consumer group.
    • Username: This parameter is mandatory when ACL is enabled for the RocketMQ instance. Username used for accessing the RocketMQ instance.
    • Password: This parameter is mandatory when ACL is enabled for the RocketMQ instance. Password for connecting to the RocketMQ instance.

  5. Click OK.

Configuring an EG Event to Trigger the Function

  1. Return to the FunctionGraph console. In the navigation pane, choose Functions > Function List.
  2. Click the function to be configured to go to the function details page.
  3. On the function details page, select a version.
  4. On the Code tab page, click Test. The Configure Test Event dialog box is displayed.
  5. Set the parameters described in Table 1 and click Save.

    Table 1 Test parameters

    Parameter

    Description

    Configure Test Event

    You can choose to create a test event or edit an existing one.

    Use the default option Create new test event.

    Event Template

    Select DMS (for HC.RocketMQ) and use the built-in HC.ROCKETMQ event template.

    Event Name

    The event name can contain 1 to 25 characters and must start with a letter and end with a letter or digit. Only letters, digits, underscores (_), and hyphens (-) are allowed. For example, rocketmq-123test.

    Event data

    The system automatically loads the built-in eg-RocketMQ event template, which is used in this example without modifications.

  6. Click Test. The function test result is displayed.