advantys/workflowgen-sql

WorkflowGen SQL Server 数据库 Docker 镜像

为WorkflowGen部署预配置的Microsoft SQL Server数据库，支持所有受支持版本。

⚠️ 平台支持与生产就绪状态

🚨 重要 - 生产就绪状态

• v9.3.1 Linux (SQL Server 2022) → ✅ 生产就绪
• v9.3.0 及更早版本、v8 Linux (SQL Server 2019) → ✅ 生产就绪
• v10 Linux (SQL Server 2025 预览版) → ⚠️ 仅开发/测试（SQL Server 2025 正式发布后将支持生产环境）
• Windows (SQL Server Express 2017) → ⚠️ 仅开发/测试 (v8, v9)
  • 最大数据库大小 10 GB
  • 限制为 1 个插槽或 4 个核心
  • 每个实例最大内存 1410 MB

对于 v10 生产部署，请使用 https://hub.docker.com/r/advantys/workflowgen-postgres%E3%80%82

v10 不提供 Windows 容器 - 微软已 暂停 Windows 容器上的 SQL Server。

---

⚠️ 版本匹配至关重要

重要：始终使用与WorkflowGen应用版本匹配的数据库镜像版本。

版本兼容性矩阵

⚠️ WorkflowGen v7.x 已弃用。尽管 v7.x 数据库镜像仍可在 Docker Hub 上获取，但不再积极支持。请升级到 v8.x 或 v9.x。

示例：

bash
# v10（开发/测试）
docker pull advantys/workflowgen-sql:10.0.3-ubuntu-24.04

# v9（生产就绪）
docker pull advantys/workflowgen-sql:9.3.1-ubuntu-22.04

# v8
docker pull advantys/workflowgen-sql:8.3.5-ubuntu-18.04

💡 提示：WorkflowGen 应用和数据库镜像使用相同的 major.minor.patch 版本。

---

要求

Linux 容器（推荐）

• 任何 Linux 发行版上的 Docker Engine
• 最低 2GB RAM（生产环境推荐 4GB+）
• Docker for Windows 或 Docker Desktop（Linux 容器模式）
• Docker for Mac

Windows 容器（v8、v9 - 仅开发/测试）

• Windows Server 2019 或 Windows 10 Pro（带 Hyper-V）
• Docker for Windows 或 Docker Enterprise Edition
• 必须使用 Windows Server ltsc2019 作为 Windows 镜像
• 注意：Windows 容器要求主机和容器的 OS 版本匹配
• v10 不可用

---

快速启动

v10 Linux（SQL Server 2025 - 仅开发/测试）

⚠️ 不用于生产 - SQL Server 2025 处于预览阶段。生产环境请使用 https://hub.docker.com/r/advantys/workflowgen-postgres%E3%80%82

bash
# 创建数据库持久化卷
docker volume create wfgen-sql-data

# 运行容器
docker run -d \
  --name wfgen-sql \
  --env-file ./database.env \
  -v wfgen-sql-data:/var/opt/mssql \
  -p 1433:1433 \
  advantys/workflowgen-sql:10.0.3-ubuntu-24.04

v9 Linux（SQL Server 2022 - 生产就绪）

bash
# 创建数据库持久化卷
docker volume create wfgen-sql-data

# 运行容器
docker run -d \
  --name wfgen-sql \
  --env-file ./database.env \
  -v wfgen-sql-data:/var/opt/mssql \
  -p 1433:1433 \
  advantys/workflowgen-sql:9.3.1-ubuntu-22.04

更多示例（v8、v9 - SQL Server 2019）：

bash
# 适用于 WorkflowGen 9.2.11（使用 Ubuntu 18.04）
advantys/workflowgen-sql:9.2.11-ubuntu-18.04

# 适用于 WorkflowGen 8.3.5（使用 Ubuntu 18.04）
advantys/workflowgen-sql:8.3.5-ubuntu-18.04

注意：

• v10.0.3 使用 Ubuntu 24.04 和 SQL Server 2025（预览版）
• v9.3.1 使用 Ubuntu 22.04 和 SQL Server 2022
• v9.3.0 及更早版本，以及所有 v8.x 使用 Ubuntu 18.04 和 SQL Server 2019
• 请查看 版本兼容性矩阵 获取特定版本信息。

v8、v9 Windows（开发/测试 - SQL Server Express 2017）

powershell
# 创建数据库持久化卷
docker volume create wfgen-sql-data

# 运行容器（示例：9.3.1 或 8.3.5）
docker run -d `
  --name wfgen-sql `
  --env-file .\database.env `
  -v wfgen-sql-data:C:\wfgen\sql `
  -p 1433:1433 `
  advantys/workflowgen-sql:9.3.1-express-win-ltsc2019
  
# 对于 v8：
# advantys/workflowgen-sql:8.3.5-express-win-ltsc2019

---

配置

必填环境变量

所有镜像都需要以下环境变量：

可选环境变量

---

连接字符串

用于 WorkflowGen 应用

在 WorkflowGen 容器中使用以下连接字符串（适用于 Linux 和 Windows）：

推荐（WFGEN_USER 账户）：

ini
WFGEN_DATABASE_CONNECTION_STRING=Data Source=wfgen-sql;Initial Catalog=WFGEN;User ID=WFGEN_USER;Password=<your-password>;TrustServerCertificate=True

使用 SA 账户（生产环境不推荐）：

ini
WFGEN_DATABASE_CONNECTION_STRING=Data Source=wfgen-sql;Initial Catalog=WFGEN;User ID=sa;Password=<SA-password>;TrustServerCertificate=True

注意：TrustServerCertificate=True 对于 Linux（自签名证书）是必需的，对于 Windows 是可选但无害的。使用此参数可确保连接字符串在两个平台上都能工作。

用于外部数据库工具

要使用 SQL Server Management Studio、Azure Data Studio 或其他工具连接：

• 服务器：localhost,1433 或 127.0.0.1,1433
• 认证：SQL Server 认证
• 用户名：sa（或 WFGEN_USER）
• 密码：(你的 SA_PASSWORD 或 WFGEN_DATABASE_USER_PASSWORD 值)
• 数据库：WFGEN

---

密钥管理

对于生产部署，使用 Docker Secrets 或 Kubernetes Secrets 保护敏感信息。

Docker Secrets 示例（Linux）

bash
# 创建密钥
echo "yourStrong(!)Password" | docker secret create SA_PASSWORD -
echo "myStrong(?)Password" | docker secret create WFGEN_DATABASE_USER_PASSWORD -

# 使用密钥创建服务
docker service create \
  --name wfgen-sql \
  --secret SA_PASSWORD \
  --secret WFGEN_DATABASE_USER_PASSWORD \
  -e SA_PASSWORD_FILE=/run/secrets/SA_PASSWORD \
  -e WFGEN_DATABASE_USER_PASSWORD_FILE=/run/secrets/WFGEN_DATABASE_USER_PASSWORD \
  -e ACCEPT_EULA=Y \
  advantys/workflowgen-sql:9.3.1-ubuntu-22.04

Docker Secrets 示例（Windows - v8, v9）

powershell
# 创建密钥
docker secret create SA_PASSWORD "yourStrong(!)Password"
docker secret create WFGEN_DATABASE_USER_PASSWORD "myStrong(?)Password"

# 使用密钥创建服务
docker service create `
  --name wfgen-sql `
  --secret SA_PASSWORD `
  --secret WFGEN_DATABASE_USER_PASSWORD `
  -e SA_PASSWORD_FILE=C:\ProgramData\Docker\secrets\SA_PASSWORD `
  -e WFGEN_DATABASE_USER_PASSWORD_FILE=C:\ProgramData\Docker\secrets\WFGEN_DATABASE_USER_PASSWORD `
  -e ACCEPT_EULA=Y `
  advantys/workflowgen-sql:9.3.1-express-win-ltsc2019

重要：以 _FILE 结尾的环境变量和非 _FILE 变量是互斥的。如果同时定义，容器将无法启动。

---

环境文件示例

创建包含配置的 database.env 文件：

ini
# 必填
ACCEPT_EULA=Y
SA_PASSWORD=yourStrong(!)Password
WFGEN_DATABASE_USER_PASSWORD=myStrong(?)Password

# 可选
WFGEN_DATABASE_CONTAINMENT=Y
WFGEN_DATABASE_USER_USERNAME=WFGEN_USER
WFGEN_ADMIN_USERNAME=wfgen_admin
WFGEN_ADMIN_PASSWORD=admin123
WFGEN_AUTH_APPLICATION=Y

然后使用 --env-file：

bash
# v10 Linux
docker run -d --env-file ./database.env advantys/workflowgen-sql:10.0.3-ubuntu-24.04

# v9 Linux
docker run -d --env-file ./database.env advantys/workflowgen-sql:9.3.1-ubuntu-22.04

# v8/v9 Windows
docker run -d --env-file .\database.env advantys/workflowgen-sql:9.3.1-express-win-ltsc2019

---

数据持久化

Linux 容器卷

示例：

bash
# 使用命名卷（推荐）
docker volume create wfgen-sql-data
docker run -d -v wfgen-sql-data:/var/opt/mssql advantys/workflowgen-sql:10.0.3-ubuntu-24.04

# 使用绑定挂载
docker run -d -v /host/path/to/mssql:/var/opt/mssql advantys/workflowgen-sql:9.3.1-ubuntu-22.04

Windows 容器卷（v8, v9）

示例：

powershell
# 使用命名卷（推荐）
docker volume create wfgen-sql-data
docker run -d -v wfgen-sql-data:C:\wfgen\sql advantys/workflowgen-sql:9.3.1-express-win-ltsc2019

# 使用绑定挂载
docker run -d -v C:\host\path:C:\wfgen\sql advantys/workflowgen-sql:9.3.1-express-win-ltsc2019

⚠️ 重要：始终映射卷以持久化数据。不映射卷时，容器删除后所有数据将丢失。

---

访问容器

PowerShell 访问

Linux 容器

bash
# 交互式 PowerShell 会话
docker exec -it wfgen-sql pwsh

# 执行单个命令
docker exec wfgen-sql pwsh -Command "Get-Date"

Windows 容器（v8, v9）

powershell
# 交互式 PowerShell 会话
docker exec -it wfgen-sql powershell

# 执行单个命令
docker exec wfgen-sql powershell -Command "Get-Date"

Bash 访问（仅限 Linux）

bash
# 交互式 bash 会话
docker exec -it wfgen-sql bash

# 执行单个命令
docker exec wfgen-sql bash -c "ls -la /var/opt/mssql"

---

暴露端口 1433

bash
# v10 Linux
docker run -d -p 1433:1433 --env-file ./database.env advantys/workflowgen-sql:10.0.3-ubuntu-24.04

# v9 Linux
docker run -d -p 1433:1433 --env-file ./database.env advantys/workflowgen-sql:9.3.1-ubuntu-22.04

# v8/v9 Windows
docker run -d -p 1433:1433 --env-file .\database.env advantys/workflowgen-sql:9.3.1-express-win