octoblu/command-and-control-service

command-and-control-service

![Dependency status]([] ![devDependency Status]([] ![Build Status]([***]

![NPM]([***]

镜像概述

command-and-control-service是针对Meshblu设备生态的命令与控制服务，允许对设备的消息或配置变更应用规则，并对其他Meshblu设备执行自动化更新操作，核心基于JSON Rules Engine实现规则处理。

核心功能

1. 规则处理：支持if/else结构的条件规则，对设备消息或配置变更触发响应
2. 设备联动：通过规则集设备管理多规则URL，实现跨设备自动化联动
3. 事件转发：通过Webhook将设备事件转发至服务进行规则校验
4. 错误通知：可配置错误设备接收规则执行的错误/信息日志（支持error/info级别）

使用场景

• Meshblu设备间的自动化规则执行（如智能空间设备联动）
• 设备配置变更的实时响应处理
• 多设备协同控制的场景化规则落地

配置说明

1. 创建规则文件

基于JSON Rules Engine格式，包含条件与事件定义：

json
{
  "if": {...规则条件...},
  "else": {...规则条件...}
}

事件支持message或update操作：

json
{
  "type": "meshblu",
  "params": {
    "operation": "message",
    "as": "可选",
    "message": {
      "devices": [...目标设备UUID...],
      ...其他内容...
    }
  }
}

2. 创建规则集设备

包含规则URL列表的Meshblu设备：

json
{
  "name": "Ruleset",
  "type": "meshblu:ruleset",
  "rules": [
    {
      "url": "https://raw.githubusercontent.com/octoblu/smartspaces-core-rules/master/hue-button-start-meeting-or-skype/action.json"
    }
  ]
}

3. 配置Webhook与属性

为目标设备配置Webhook转发事件，并关联规则集：

• Webhook配置：

json
{
  "name": "My Device",
  "meshblu": {
    "forwarders": {
      "version": "2.0.0",
      "broadcast": {"sent": [{"type":"webhook","url":"https://command-and-control.octoblu.com/v1/messages","method":"POST","generateAndForwardMeshbluCredentials":true}]},
      "configure": {"sent": [{"type":"webhook","url":"https://command-and-control.octoblu.com/v1/messages","method":"POST","generateAndForwardMeshbluCredentials":true}]}
    }
  }
}

• commandAndControl属性：

json
{
  "commandAndControl": {
    "rulesets": [{"uuid": "规则集设备UUID"}],
    "errorDevice": {"uuid": "错误通知设备UUID","logLevel":"error"}
  }
}

Docker部署示例

开发环境

bash
# 构建本地镜像
docker build -t local/command-and-control-service .
# 运行容器（映射8888端口）
docker run --rm -it --name command-and-control-service-local -p 8888:80 local/command-and-control-service

生产环境

bash
# 拉取官方镜像
docker pull quay.io/octoblu/command-and-control-service
# 运行容器
docker run --rm -p 8888:80 quay.io/octoblu/command-and-control-service

调试与测试

• 调试命令：

bash
env DEBUG='command-and-control-service*' node command.js

• 测试命令：

bash
npm test

许可证

MIT许可证（MIT）
版权所有 (c) 2016 Octoblu
允许自由使用、复制、修改、分发本软件，需保留版权声明与许可声明。软件按"原样"提供，不承担任何担保责任。