magentaaps/os2mo-sdtool-plus

SDTool+ Docker镜像文档

概述

SDTool+ Docker镜像是一款专注于同步SD和MO系统组织单元的容器化解决方案。该镜像提供自动化数据同步机制，确保两个系统中的组织架构信息（如部门、团队、层级关系等）保持一致，适用于需要跨系统维护统一组织信息的企业IT环境。

核心功能与特性

• 组织单元同步：支持SD与MO系统间组织单元数据的双向或单向同步，涵盖新增、更新、删除操作的同步处理。
• 数据一致性校验：内置校验机制，验证组织单元属性（名称、编码、父节点等）的完整性与准确性，避免脏数据同步。
• 自动化调度：支持自定义同步频率（如每小时、每日），通过定时任务减少人工干预。
• 轻量级部署：基于Docker容器化设计，无需复杂本地配置，通过简单命令即可快速部署运行。

使用场景

• 企业多系统集成：在采用SD和MO作为核心系统的企业中，确保组织架构信息在两系统间实时一致，避免管理混乱。
• 组织架构变更管理：当SD或MO系统组织单元发生变更（如部门调整）时，自动同步至另一系统，降低手动操作成本。
• 系统迁移过渡：在SD与MO系统迁移/升级过程中，作为临时同步工具保障组织信息连续性。

使用方法

前提条件

• 已安装Docker Engine（20.10+版本）或Docker Desktop。
• 具备SD和MO系统的API访问权限，可获取接口地址及认证凭证（如API密钥、令牌）。

快速启动

通过以下命令启动基础同步容器：

bash
docker run -d \
  --name sdtool-plus \
  -e SYNC_DIRECTION="bidirectional" \  # 同步方向：bidirectional/sd_to_mo/mo_to_sd
  -e SD_API_URL="https://sd.example.com/api" \  # SD系统API地址
  -e MO_API_URL="https://mo.example.com/api" \  # MO系统API地址
  -e AUTH_TOKEN="your-auth-token" \  # 访问SD/MO的认证令牌
  -e SYNC_INTERVAL="3600" \  # 同步间隔（秒），默认3600
  sdtool-plus:latest

配置说明

环境变量

数据同步规则

• 新增同步：任一系统新增组织单元时，自动在目标系统创建对应记录。
• 更新同步：组织单元属性变更时，同步更新目标系统对应记录。
• 删除同步：默认开启，可通过ENABLE_DELETE_SYNC控制是否同步删除操作。

部署示例（docker-compose）

配置文件（docker-compose.yml）

yaml
version: '3'
services:
  sdtool-plus:
    image: sdtool-plus:latest
    container_name: sdtool-plus
    restart: always
    environment:
      - SYNC_DIRECTION=sd_to_mo
      - SD_API_URL=https://internal-sd-api.example.com/v1
      - MO_API_URL=https://internal-mo-api.example.com/v1
      - AUTH_TOKEN=your-secure-auth-token
      - SYNC_INTERVAL=1800  # 每30分钟同步一次
      - LOG_LEVEL=debug
    volumes:
      - ./sync-logs:/app/logs  # 挂载日志目录持久化同步日志

启动命令

bash
docker-compose up -d

注意事项

• 确保SD和MO系统API版本与SDTool+兼容，具体兼容版本参考官方文档。
• 认证令牌需具备读取SD/MO组织单元、写入目标系统组织单元的权限，建议遵循最小权限原则。
• 首次同步前建议备份SD和MO系统组织单元数据，避免异常同步导致数据丢失。