rule 模块

简介

Baetyl-Rule 可以实现 Baetyl 框架端侧的消息流转,在 Baetyl-Broker(端侧消息中心)、函数服务、Iot Hub(云端 Mqtt Broker) 进行消息交换。

支持以下的消息流转方式:

  • 订阅 Baetyl-Broker 的消息主题,发送到自身的其他消息主题,支持函数处理
  • 订阅 Baetyl-Broker 的消息主题,发送到其他消息节点(比如Iot Hub)的消息主题,支持函数处理
  • 订阅其他消息节点的消息主题,发送到 Baetyl-Broker 的消息主题,支持函数处理

其中 Baetyl 支持 Python、Node、Sql 等多种运行时,可以配置相关的脚本函数对消息进行过滤、处理、转换以及丰富等,具体可以参考 Baetyl-Function 模块。

配置

Baetyl-Rule 的全量配置文件如下,并对配置字段做了相应解释:

clients: # 消息节点,可以从节点订阅消息,也可以发送消息节点
  - name: iothub # 名称
    kind: mqtt # mqtt 类型
    address: 'ssl://u7isgiz.mqtt.iot.bj.baidubce.com:1884' # 地址
    username: client.example.org # 用户名
    ca: ../example/var/lib/baetyl/testcert/ca.pem # 连接节点的 CA
    key: ../example/var/lib/baetyl/testcert/client.key # 连接节点的私钥
    cert: ../example/var/lib/baetyl/testcert/client.pem # 连接节点的公钥
    insecureSkipVerify: true # 是否跳过服务端证书校验
rules: # 消息规则
  - name: rule1 # 规则名称,必须保持唯一
    source: # 消息源
      topic: broker/topic1 # 消息主题
      qos: 1 # 消息质量
    target: # 消息目的地
      client: iotcore # 消息节点,如果不设置,默认为 baetyl-broker
      topic: iotcore/topic2 # 消息主题
      qos: 0 # 消息质量
  - name: rule2 # 规则名称,必须保持唯一
    source: # 消息源
      topic: broker/topic5 # 消息主题
      qos: 0 # 消息质量
    target: # 消息目的地
      topic: broker/topic6 # 消息主题
      qos: 1 # 消息质量
    function: # 处理函数
      name: node85 # 函数名称

其中,Baetyl-Rule 会自动在节点信息列表中添加 Baetyl-Broker 的节点信息。当一条规则的的 client 字段未配置时,会默认设置为 Baetyl-Broker,从 Baetyl-Broker 订阅消息或者转发消息到 Baetyl-Broker。