Semarchy xDI Runtime Docker镜像文档

1. 镜像概述和主要用途

Semarchy xDI Runtime是Semarchy数据集成平台的核心运行引擎，用于执行由Semarchy xDI Designer设计的数据集成流程。作为高性能、敏捷且可扩展的数据集成平台组件，它能够连接各类包含待集成数据的系统和应用，支撑企业级数据集成场景的高效运行。Semarchy作为数据集成与主数据管理领域的领导者，通过其统一平台帮助各类规模的组织快速发现、治理、管理、集成和报告分散在应用系统中的关键信息。

2. 核心功能和特性

• 高性能数据处理：优化的数据流转引擎，支持大规模数据集成任务高效执行。
• 敏捷与可扩展性：适配各类集成风格（批处理、实时、ETL/ELT等）和使用场景，支持自定义扩展。
• 多系统连接能力：原生支持连接数据库、应用系统、文件系统等多种数据源。
• 设计-运行协同：无缝对接Semarchy xDI Designer，直接运行设计完成的数据流程。
• 调度与监控：内置任务调度功能，支持集成监控工具（如Semarchy xDI Analytics）跟踪任务状态。

3. 使用场景和适用范围

• 企业级数据集成：整合分散在CRM、ERP、数据库等系统中的业务数据，支撑报表与分析。
• 数据迁移与同步：在系统升级或架构调整时，实现跨平台数据迁移与实时同步。
• 主数据管理配套：作为Semarchy MDM平台的数据集成层，确保主数据一致性。
• 适用于各类组织：从小型企业到大型企业，满足不同规模的数据集成需求。

4. 基础信息

4.1 维护者

Semarchy

4.2 支持渠道

• Semarchy社区
• Semarchy支持库

4.3 基础镜像

基于OpenJDK官方镜像构建，包含：

• 底层系统：Debian
• JDK版本：符合Semarchy xDI Runtime系统要求的OpenJDK（如eclipse-temurin:11-jdk-jammy）

4.4 版本信息

• 镜像版本标签：参见Docker Hub仓库标签
• 版本支持政策：参见Semarchy全球支持政策

5. 使用方法

5.1 前提条件

• 安装Docker和Docker Compose
• 下载并解压Tutorial Resources，获取示例配置（路径：quick-install/docker/<version>/xdi-runtime/docker-compose/）

5.2 Docker Compose部署示例

推荐使用官方提供的Docker Compose模板，以下为简化配置示例：

version: '3.8'
services:
  xdi-runtime:
    image: semarchy/xdi-runtime:2023.1.4  # 使用特定完整版本标签
    container_name: xdi-runtime
    ports:
      - "8080:8080"  # 映射HTTP端口（客户端连接用）
    volumes:
      - ./shared-resources/modules:/opt/semarchy/xdi-runtime/modules  # 挂载集成模块
      - ./shared-resources/properties:/opt/semarchy/xdi-runtime/conf  # 挂载配置文件
    environment:
      - XDI_JAVA_OPTS=-Xmx1g  # JVM参数配置
      - XDI_HTTP_PORT=8080    # 运行时HTTP端口
    restart: unless-stopped

5.3 运行步骤

1. 准备模块文件
   将Semarchy xDI Runtime模块（如数据库驱动）放入shared-resources/modules目录（该目录通过Volume挂载至容器内/opt/semarchy/xdi-runtime/modules）。

   注意：若使用示例配置，需确保存在名为BACKEND-DATABASE的模块，并包含后端数据库（如PostgreSQL）的JDBC驱动。

2. 配置运行参数
   编辑shared-resources/properties目录下的配置文件：

   • engineParameters.xml：运行时核心配置（如连接池、超时时间）
   • engineScheduler.properties：调度器配置（如任务执行线程数）

3. 启动容器
   在Docker Compose文件所在目录执行：

   docker compose -f docker-compose.yml up -d
   

4. 客户端连接
   通过Semarchy xDI Designer、CLI或xDI Analytics连接运行时，使用配置的HTTP端口（如8080）及engineParameters.xml中定义的用户名/密码。

6. 配置说明

6.1 环境变量配置

通过environment字段设置基础运行参数，常用变量包括：

• XDI_JAVA_OPTS：JVM参数（如-Xmx2g设置堆内存）
• XDI_HTTP_PORT：运行时HTTP服务端口（默认8080）
• XDI_LOG_LEVEL：日志级别（如INFO、DEBUG，默认INFO）

6.2 配置文件详解

通过挂载shared-resources/properties目录自定义高级配置：

7. 日志管理

Semarchy xDI Runtime日志直接输出至容器日志，可通过Docker命令查看：

docker logs -f xdi-runtime  # 实时查看日志
docker logs --tail=100 xdi-runtime  # 查看最近100行日志

日志配置（如格式、轮转）可通过engineParameters.xml中的日志相关参数调整。

8. 镜像标签说明

xdi-runtime:latest

包含最新版本的Semarchy xDI Runtime。

注意：不推荐生产环境使用，可能自动升级至新版本导致兼容性问题。

xdi-runtime:<minor_version>

特定次要版本的最新补丁版本（如2023.3）。

注意：不推荐生产环境使用，可能自动升级至该次要版本下的最新补丁。

xdi-runtime:<full_version>

特定完整版本（如2023.1.4），版本固定。

推荐：生产环境使用，确保版本稳定性和可追溯性。

9. 许可证信息

镜像包含的软件许可证信息参见Semarchy xDI许可证文档。

10. 参考文档

• Semarchy xDI Runtime官方文档
• Semarchy xDI架构说明