magentaaps/os2mo-http-trigger-sdtool

OS2mo HTTP Trigger Receiver for SDTool 镜像文档

概述

本镜像为OS2mo提供HTTP触发器接收器功能，专门用于与SDTool集成。它能够接收外部系统发送的HTTP触发事件，对事件进行解析和处理，并与SDTool进行通信，实现OS2mo与SDTool之间的事件驱动型集成。

核心功能

• HTTP事件接收：监听指定端口，接收来自外部系统的HTTP POST/GET触发事件
• SDTool集成：与SDTool建立通信连接，支持事件数据的传递与同步
• 事件处理：对接收的HTTP事件进行格式解析、验证和处理，执行预设业务逻辑
• 可配置性：支持通过环境变量自定义配置参数，适配不同部署环境

使用场景

• 在基于OS2mo和SDTool的IT系统环境中，需要通过HTTP触发器实现自动化流程（如用户账户创建、权限变更通知）
• 外部系统需向OS2mo/SDTool推送事件以触发后续操作（如数据同步、流程启动）
• 需要构建OS2mo与SDTool之间的事件驱动型集成架构

使用方法

基本运行命令

docker
docker run -d \
  --name os2mo-sdtool-http-trigger \
  -p 8080:8080 \
  -e SDTOOL_URL="http://sdtool:3000" \
  -e LISTEN_PORT=8080 \
  os2mo-http-trigger-receiver-sdtool:latest

环境变量配置

Docker Compose示例

yaml
version: '3'
services:
  os2mo-sdtool-trigger:
    image: os2mo-http-trigger-receiver-sdtool:latest
    ports:
      - "8080:8080"
    environment:
      - SDTOOL_URL="http://sdtool-service:3000"
      - SDTOOL_API_KEY="your-secure-api-key"
      - LOG_LEVEL="INFO"
    restart: unless-stopped

事件接收端点

服务启动后，默认通过以下端点接收HTTP事件：

• POST http://<container-ip>:<LISTEN_PORT>/trigger：接收触发事件，事件数据通过请求体传递（支持JSON格式）

注意事项

• 确保SDTOOL_URL配置正确，且容器能够访问SDTool服务
• 生产环境中建议配置SDTOOL_API_KEY以增强安全性
• 根据实际需求调整日志级别，调试时可设置为DEBUG获取详细日志