jboss/jbpm-workbench-showcase

jBPM Workbench Showcase Docker镜像

镜像概述

本镜像继承自jboss/jbpm-workbench:latest，包含以下组件：

• JBoss Wildfly 14.0.1.Final服务器
• jBPM Workbench 7.17.0.Final工作流工具
• 默认用户角色配置
• 若干示例项目

这是一个可直接运行的jBPM Workbench镜像，无需额外配置即可体验工作流设计与管理功能。

核心功能

1. 工作流设计与管理：通过Business Central界面创建、编辑和部署工作流
2. 多用户角色支持：预设不同权限的用户账号，满足团队协作需求
3. Git仓库访问：支持通过SSH协议访问内部Git仓库，管理项目 artifacts
4. 示例项目：内置IT订单等示例，快速了解jBPM使用场景
5. 持久化配置：支持通过Docker卷挂载保存Git仓库数据，避免容器删除后数据丢失

使用场景

• 开发者学习jBPM工作流引擎的基本使用
• 团队演示工作流解决方案的功能与效果
• 快速搭建jBPM测试环境，验证工作流逻辑
• 教学场景中展示工作流管理工具的操作流程

配置说明

基本部署

运行容器命令：

bash
docker run -p 8080:8080 -p 8001:8001 -d --name jbpm-workbench jboss/jbpm-workbench-showcase:latest

容器启动后，通过以下URL访问Business Central界面： http://localhost:8080/business-central

用户角色

镜像预设以下用户及角色：

日志查看

• 查看容器运行日志：

  bash
  docker logs [-f] <容器ID>
  

• 进入容器查看应用日志：

  bash
  docker attach <容器ID>
  # 或通过nsenter访问日志文件
  sudo nsenter -t $(docker inspect --format '{{ .State.Pid }}' $(docker ps -lq)) -m -u -i -n -p -w
  tail -f /opt/jboss/wildfly/standalone/log/server.log
  

Git仓库访问

内部Git仓库默认通过SSH端口8001访问，示例克隆命令：

bash
git clone ssh://admin@localhost:8001/MySpace/IT_Orders

持久化配置

方式1：挂载默认Git目录

默认Git仓库路径为/opt/jboss/wildfly/bin/.niogit，通过卷挂载保存数据：

bash
docker run -p 8080:8080 -p 8001:8001 -v /home/myuser/wb_git:/opt/jboss/wildfly/bin/.niogit:Z -d --name jbpm-workbench jboss/jbpm-workbench-showcase:latest

（需提前创建/home/myuser/wb_git目录并设置正确权限）

方式2：自定义Git目录

1. 编辑jbpm-custom.cli文件，取消注释自定义Git路径配置：

   cli
   # 配置Git目录为/opt/jboss/wildfly/mygit
   if (outcome != success) of /system-property=org.uberfire.nio.git.dir:read-resource
       /system-property=org.uberfire.nio.git.dir:add(value="/opt/jboss/wildfly/mygit")
   else
       /system-property=org.uberfire.nio.git.dir:write-attribute(name=value,value="/opt/jboss/wildfly/mygit")
   end-if
   

2. 修改Dockerfile添加目录创建命令：

   dockerfile
   USER root
   RUN mkdir -p $JBOSS_HOME/mygit
   RUN chown jboss:jboss $JBOSS_HOME/mygit
   USER jboss
   

3. 构建自定义镜像：

   bash
   docker build --rm -t jboss/jbpm-workbench-showcase:MY_TAG .
   

4. 运行容器时挂载自定义目录：

   bash
   docker run -p 8080:8080 -p 8001:8001 -v /home/myuser/wb_git:/opt/jboss/wildfly/mygit:Z -d --name jbpm-workbench jboss/jbpm-workbench-showcase:MY_TAG
   

注意事项

• 应用上下文路径为business-central
• 默认使用嵌入式H2数据库
• 不支持集群和Wildfly域模式
• 不适用于云环境（如OpenShift、EC2）
• 反馈或问题可提交至jBPM Setup或jBPM Usage谷歌群组
• 版本信息：jBPM Workbench 7.17.0.Final，Wildfly 14.0.1.Final