openiamdocker/activiti

activiti-workflow-repo 镜像文档

1. 镜像概述和主要用途

activiti-workflow-repo 是一个 Activiti 工作流文件的私有仓库镜像，核心用途是为 Activiti 工作流引擎初始化持久化卷，提供预设的工作流定义文件存储基础。通过镜像内置的工作流文件，可快速完成卷的初始化，确保工作流文件在容器生命周期中保持一致性。

2. 核心功能和特性

• 内置工作流文件：包含特定业务所需的 Activiti 工作流定义文件（如 .bpmn、.bpmn20.xml 格式）。
• 卷初始化能力：设计用于初始化持久化卷，将内置工作流文件复制到目标卷，支持容器重启或迁移后的文件持久化。
• 私有仓库定位：仅包含内部项目所需的工作流文件，适用于企业或团队内部的工作流管理场景。

3. 使用场景和适用范围

• Activiti 引擎部署：在部署 Activiti 工作流引擎（如 Activiti Cloud、Spring Boot 集成 Activiti 等）时，作为工作流文件的初始数据源，通过卷挂载提供给引擎使用。
• 开发/测试环境快速搭建：在开发或测试环境中，无需手动创建工作流文件，通过该镜像快速初始化包含标准文件的卷，提升环境一致性。
• 工作流版本快照：作为特定版本工作流文件的快照，用于保障不同环境（如测试、预发）中工作流定义的一致性。

4. 使用方法和配置说明

4.1 基础使用（docker run 命令）

通过 docker run 命令挂载目标卷，执行镜像以完成卷初始化。示例：

bash
# 创建持久化卷（若未创建）
docker volume create activiti-workflow-volume

# 运行镜像初始化卷（--rm 表示任务完成后自动删除容器）
docker run --rm -v activiti-workflow-volume:/workflow-files docker.xuanyuan.run/activiti-workflow-repo

说明：

• -v activiti-workflow-volume:/workflow-files：将宿主机卷 activiti-workflow-volume 挂载到容器内的 /workflow-files 目录（镜像内置工作流文件存放路径）。
• 镜像启动后，会自动将 /workflow-files 目录下的工作流文件复制到挂载的卷中，完成初始化。

4.2 Docker Compose 配置示例

在多容器环境中，可通过 docker-compose.yml 定义卷初始化服务，示例：

yaml
version: '3.8'

volumes:
  # 定义持久化卷
  activiti-workflow-volume:
    driver: local

services:
  # 卷初始化服务（一次性任务）
  workflow-init:
    image: docker.xuanyuan.run/activiti-workflow-repo
    volumes:
      - activiti-workflow-volume:/workflow-files
    command: cp -r /workflow-files/* /workflow-files/  # 确保文件复制到卷（根据镜像内部结构调整）
    restart: "no"  # 任务完成后不再重启

  # 后续 Activiti 引擎服务可直接挂载该卷
  activiti-engine:
    image: docker.xuanyuan.run/activiti/activiti-cloud-engine:latest
    volumes:
      - activiti-workflow-volume:/app/workflow-files  # 挂载初始化后的卷
    depends_on:
      - workflow-init  # 确保初始化完成后启动引擎

5. 配置参数

当前镜像主要依赖卷挂载配置，核心参数如下：

6. 注意事项

• 一次性初始化：镜像设计为一次性任务，完成卷初始化后容器可删除（建议配合 --rm 参数）。
• 卷权限：确保挂载的卷具有读写权限（如宿主机卷路径权限、Docker 卷默认权限），避免文件复制失败。
• 文件覆盖风险：若目标卷已存在文件，镜像默认不会覆盖（具体行为取决于镜像内置脚本，建议初始化前确保卷为空）。
• 镜像版本：不同版本的镜像可能包含不同的工作流文件，部署时需指定明确版本号（如 activiti-workflow-repo:v1.0）以保障一致性。