SymmetricDS Pro Docker镜像文档

镜像概述和主要用途

SymmetricDS Pro是一款高度可扩展且可配置的开源数据库复制工具，支持MySQL、Microsoft SQL Server、PostgreSQL、SQLite、Oracle SQL等多种数据库平台。本Docker镜像是JumpMind Inc.***发布，基于openjdk:alpine构建，包含SymmetricDS Pro的默认Web服务器配置，适用于数据库数据同步、复制场景。

注意：SymmetricDS Pro需许可证密钥访问Web控制台，可通过试用许可证获取链接获取试用密钥。

核心功能和特性

• 多数据库支持：兼容MySQL、SQL Server、PostgreSQL等主流数据库平台
• 高扩展性与可配置性：支持复杂的复制拓扑和自定义配置
• 轻量级基础：基于openjdk:alpine镜像，资源占用低
• Web控制台管理：提供Web界面进行配置与监控
• 网络协议支持：同时支持HTTP和HTTPS访问模式
• 数据持久化：通过卷挂载实现配置和数据的持久化存储
• 集群兼容：支持集群配置，确保容器重启后的状态一致性

使用场景和适用范围

适用于需要在分布式环境中实现数据库数据同步的场景，如：

• 多站点数据备份与同步
• 读写分离架构中的数据复制
• 分布式系统间的数据一致性维护
• 开发/测试环境的数据库快速部署与复制

使用方法和配置说明

运行SymmetricDS Pro容器

1. 使用HTTP启动

docker run -p 31415:31415 --name sym jumpmind/symmetricds-pro

启动后可通过以下URL访问Web控制台：
http://localhost:31415/app

注意：SymmetricDS Pro演示配置仅支持HTTP协议。

2. 使用HTTPS启动

docker run -p 31417:31417 --name sym jumpmind/symmetricds-pro

启动后可通过以下URL访问Web控制台：
https://localhost:31417/app

注意：需在数据库设置中允许Docker容器的IP地址连接。本地运行时，仅允许localhost访问是不够的，因为Docker容器位于独立子网。

连接到运行中的容器

如需通过命令行工具手动配置文件系统，可执行以下命令进入容器shell：

docker exec -it sym /bin/sh

（使用Alpine Linux默认shell，支持容器内文件系统的手动修改）

卷配置

通过卷挂载可实现engines、tmp、conf和security目录的数据持久化，避免容器停止或删除后配置丢失。

支持的卷挂载目录

• /opt/symmetric-ds/engines：引擎配置
• /opt/symmetric-ds/tmp：临时文件
• /opt/symmetric-ds/conf：应用配置
• /opt/symmetric-ds/security：安全相关配置

卷挂载示例

docker run -p 31415:31415 --name sym \
  -v sym-engines:/opt/symmetric-ds/engines \
  -v sym-conf:/opt/symmetric-ds/conf \
  -v sym-security:/opt/symmetric-ds/security \
  jumpmind/symmetricds-pro

上述命令将engines、conf和security目录分别持久化到sym-engines、sym-conf和sym-security卷中。即使容器停止或删除，重新创建容器时使用相同命令即可保留原有配置。

集群配置

为确保Docker容器重启时的状态一致性，需启用集群配置。在创建的任何引擎中添加以下属性：

cluster.lock.enabled=true

构建SymmetricDS Pro镜像

如需自定义构建镜像，执行以下命令（需指定SymmetricDS安装JAR路径）：

docker build -t symmetricds-pro --build-arg SETUP_JAR=PATH_TO_SYMMETRIC_SETUP_JAR .

（将PATH_TO_SYMMETRIC_SETUP_JAR替换为实际的安装JAR文件路径）