scrumteamzgw/bptl

Business Process Task Library Docker镜像文档

1. 镜像概述

本镜像提供了一个业务流程任务库，专门用于运行来自Camunda和Activiti等主流业务流程引擎的（异步）任务。它作为流程引擎的扩展组件，负责处理流程中定义的各类任务，实现任务的异步执行与管理，提升业务流程的灵活性和执行效率。

2. 核心功能与特性

• 多引擎支持：无缝集成Camunda和Activiti主流业务流程引擎
• 异步任务处理：支持任务的异步执行，避免阻塞主流程引擎
• 任务生命周期管理：包含任务的接收、执行、重试、完成及失败处理等完整生命周期管理
• 可配置执行参数：支持任务执行线程数、超时时间、重试策略等参数自定义
• 轻量级设计：基于Java构建，资源占用低，部署便捷
• 日志与监控：提供详细的任务执行日志，支持与监控系统集成

3. 使用场景与适用范围

• 企业级业务流程自动化：在基于Camunda/Activiti构建的业务流程中处理异步任务
• 耗时任务执行：适用于流程中需要长时间运行的任务（如数据处理、文件生成等）
• 分布式任务协调：在多实例部署环境下，实现任务的分布式执行与负载均衡
• 流程引擎扩展：为Camunda/Activiti提供任务执行层，分离流程定义与任务执行逻辑

4. 详细使用方法

4.1 前提条件

• 已安装Docker Engine（20.10+版本）
• 已部署Camunda或Activiti流程引擎实例，且网络可互通
• 流程引擎中已定义需要异步执行的任务

4.2 基本使用命令

4.2.1 快速启动（Docker Run）

bash
docker run -d \
  --name bpm-task-library \
  -e BPM_ENGINE_TYPE=camunda \
  -e BPM_ENGINE_URL=http://camunda-instance:8080/engine-rest \
  -e TASK_THREAD_COUNT=5 \
  -e TASK_TIMEOUT=300000 \
  business-process-task-library:latest

4.2.2 Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  bpm-task-library:
    image: business-process-task-library:latest
    container_name: bpm-task-library
    restart: always
    environment:
      - BPM_ENGINE_TYPE=camunda  # 流程引擎类型，支持camunda/activiti
      - BPM_ENGINE_URL=http://camunda:8080/engine-rest  # 流程引擎REST API地址
      - BPM_ENGINE_USERNAME=demo  # 流程引擎认证用户名
      - BPM_ENGINE_PASSWORD=demo  # 流程引擎认证密码
      - TASK_THREAD_COUNT=5  # 任务执行线程数
      - TASK_TIMEOUT=300000  # 任务超时时间（毫秒）
      - TASK_RETRY_MAX=3  # 任务最大重试次数
      - TASK_RETRY_DELAY=5000  # 任务重试间隔（毫秒）
    networks:
      - bpm-network

networks:
  bpm-network:
    external: true  # 假设已存在与流程引擎共享的网络

启动服务：

bash
docker-compose up -d

4.3 环境变量配置说明

4.4 任务执行监控

查看容器日志：

bash
docker logs -f bpm-task-library

任务执行状态可通过流程引擎原生界面（如Camunda Cockpit）查看，或集成Prometheus监控指标（需额外配置监控端口）。

5. 注意事项

• 确保容器与Camunda/Activiti实例网络互通，可通过Docker网络或主机网络模式实现
• 生产环境建议配置持久化日志，可通过挂载日志目录实现：-v /host/logs:/app/logs
• 根据任务负载调整TASK_THREAD_COUNT参数，避免资源竞争
• 敏感信息（如认证密码）建议使用Docker Secrets或环境变量加密管理

6. 版本与更新

• 镜像标签格式：business-process-task-library:<version>
• 版本更新日志请参考项目官方仓库（如GitHub Releases）
• 建议定期更新镜像以获取最新功能与安全修复