intel/oact-mpsrouter

Open AMT Cloud Toolkit - Management Presence Server Router 镜像文档

1. 镜像概述和主要用途

Management Presence Server Router（MPS Router）是 Open AMT Cloud Toolkit 的核心组件之一，主要用于在大规模设备管理场景中实现请求路由与扩展。其核心功能是将 MPS（Management Presence Server）的 API 调用路由至设备当前连接的特定 MPS 实例，解决多 MPS 实例部署时的请求分发问题，支持系统横向扩展。

2. 核心功能和特性

2.1 核心功能

• API 请求路由：接收并解析 MPS API 请求，根据设备连接状态将请求路由至对应 MPS 实例，确保设备与 MPS 实例的正确通信。
• 扩展支持：通过路由机制支持多 MPS 实例部署，提升系统对大规模设备的管理能力，满足高并发场景需求。

2.2 关键特性

• 动态路由：基于设备连接信息动态匹配目标 MPS 实例，无需静态配置。
• 组件集成：与 Open AMT Cloud Toolkit 其他组件（如 MPS、RPS 等）无缝集成，形成完整的设备管理链路。
• 轻量级部署：基于 Docker 容器化部署，简化环境配置与运维流程。

3. 使用场景和适用范围

3.1 典型使用场景

• 大规模设备管理：当管理设备数量超过单 MPS 实例承载能力时，通过部署多个 MPS 实例+MPS Router 实现负载分担。
• 高可用架构：结合多 MPS 实例部署，避免单点故障，提升系统整体可用性。
• 分布式部署：跨地域或跨网络环境下，通过 MPS Router 统一入口，分发请求至不同区域的 MPS 实例。

3.2 适用范围

• 企业级设备管理平台（如 IoT 设备、边缘计算设备、远程办公设备等）。
• 需要支持 1000+ 设备并发管理的场景。
• 对系统可扩展性、可用性有较高要求的生产环境。

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker 或 Docker Compose。
• 已部署至少一个 MPS 实例（参考 https://open-amt-cloud-toolkit.github.io/docs%EF%BC%89%E3%80%82

4.2 Docker 快速部署

4.2.1 基本运行命令

bash
docker run -d \
  -p 3000:3000 \  # 映射容器端口到主机（默认端口 3000，可自定义）
  --name mps-router \
  -e MPS_INSTANCES="http://mps-instance-1:3000,http://mps-instance-2:3000" \  # MPS 实例列表（逗号分隔）
  -e LOG_LEVEL="info" \  # 日志级别（可选：debug, info, warn, error）
  openamt/mps-router:latest

4.2.2 Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  mps-router:
    image: openamt/mps-router:latest
    container_name: mps-router
    ports:
      - "3000:3000"  # 宿主端口:容器端口
    environment:
      - MPS_INSTANCES="http://mps-1:3000,http://mps-2:3000"  # 部署的 MPS 实例地址列表
      - PORT=3000  # 容器内服务端口（默认 3000）
      - LOG_LEVEL="info"  # 日志级别
    restart: unless-stopped
    networks:
      - amt-network  # 与 MPS 实例共享网络（确保路由可达）

networks:
  amt-network:
    driver: bridge  # 或使用已有的自定义网络（如与 MPS 实例相同）

启动服务：

bash
docker-compose up -d

4.3 核心配置参数

4.3.1 环境变量说明

注意：MPS_INSTANCES 为必填项，需确保所有 MPS 实例与 MPS Router 在同一网络中，或可通过网络互通。

4.4 验证部署

部署后，可通过以下方式验证服务可用性：

bash
# 检查容器状态
docker ps | grep mps-router

# 查看日志
docker logs -f mps-router

# 访问健康检查接口（返回 HTTP 200 表示正常）
curl http://localhost:3000/health

5. 参考文档

• https://open-amt-cloud-toolkit.github.io/docs
• https://github.com/open-amt-cloud-toolkit/mps-router