magentaaps/os2mo-amqp-trigger-organisation-gatekeeper

OS2mo AMQP触发器接收器（层级管理信息更新）

镜像概述

本镜像为OS2mo系统（Organisation og Medarbejderstyring，组织与人员管理系统）提供AMQP触发器接收功能，核心用途是接收AMQP协议消息并自动更新系统中的层级管理信息，实现组织结构与人员层级数据的实时同步。

核心功能与特性

核心功能

• AMQP消息接收：基于AMQP协议监听指定消息队列，接收层级管理相关事件通知
• 层级信息更新：根据接收的消息内容，自动更新OS2mo系统中的层级管理数据

主要特性

• OS2mo原生集成：与OS2mo系统API深度适配，确保数据更新兼容性
• 事件驱动架构：基于AMQP消息触发更新操作，支持实时数据同步
• 轻量化设计：专注于层级管理信息更新场景，资源占用低

使用场景与适用范围

适用场景

• 组织架构调整时自动更新层级关系
• 人员职位变动导致层级变化的实时同步
• 批量层级数据调整的自动化处理
• OS2mo系统与其他业务系统的层级数据联动更新

适用范围

• 使用OS2mo系统的公共或私营组织
• 需要自动化管理层级数据的HR或IT部门
• 采用AMQP协议进行消息通信的系统环境

使用方法与配置说明

环境变量配置

Docker运行示例

bash
docker run -d \
  --name os2mo-amqp-line-manager \
  -e AMQP_HOST=amqp.example.com \
  -e AMQP_PORT=5672 \
  -e AMQP_QUEUE=os2mo.line-management.updates \
  -e AMQP_USERNAME=os2mo-trigger \
  -e AMQP_PASSWORD=secure-token \
  -e OS2MO_API_URL=https://os2mo.example.com/api \
  -e OS2MO_API_TOKEN=os2mo-api-key-xxxx \
  -e LOG_LEVEL=INFO \
  docker.xuanyuan.run/os2mo/amqp-trigger-line-manager:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  os2mo-line-manager-trigger:
    image: docker.xuanyuan.run/os2mo/amqp-trigger-line-manager:latest
    container_name: os2mo-line-manager-trigger
    environment:
      - AMQP_HOST=rabbitmq
      - AMQP_PORT=5672
      - AMQP_QUEUE=os2mo.line-management.updates
      - AMQP_USERNAME=${AMQP_USERNAME}
      - AMQP_PASSWORD=${AMQP_PASSWORD}
      - OS2MO_API_URL=https://os2mo.internal/api
      - OS2MO_API_TOKEN=${OS2MO_API_TOKEN}
    restart: unless-stopped
    depends_on:
      - rabbitmq
    networks:
      - os2mo-network

networks:
  os2mo-network:
    external: true

注意事项

1. 确保AMQP服务器与OS2mo API服务之间网络通畅，且镜像容器具有访问权限
2. AMQP队列需提前在消息服务器中创建，且权限配置允许镜像所在角色进行消费
3. OS2MO_API_TOKEN需具备层级管理信息的写权限，建议遵循最小权限原则配置
4. 生产环境中建议通过容器编排工具（如Kubernetes）部署，配置健康检查与自动恢复机制