jboss/jbpm-server-full

jBPM Workbench Showcase Docker镜像

从7.61.0.Final版本开始，我们将Docker镜像的位置从Docker Hub迁移到了https://quay.io/repository/kiegroup/jbpm-server-full%E3%80%827.61.0.Final%E7%89%88%E6%9C%AC%E7%9A%84%E9%95%9C%E5%83%8F%E4%BC%9A%E5%90%8C%E6%97%B6%E5%AD%98%E5%9C%A8%E4%BA%8E%E4%B8%A4%E4%B8%AA%E4%BD%8D%E7%BD%AE%EF%BC%88Docker Hub和Quay），而>7.61.0.Final版本的镜像将仅在Quay上提供。

目录

• 简介
• 使用方法
• 用户和角色
• 数据库
• 日志
• GIT内部仓库访问
• 持久化配置
• 环境变量
• 实验操作
• 故障排除
• 注意事项
• 发行说明

简介

该镜像包含以下组件：

• JBoss Wildfly 23.0.2.Final应用服务器
• jBPM Workbench 7.61.0.Final
• KIE Server 7.61.0.Final
• jBPM Case Management Showcase 7.61.0.Final

这是一个即开即用的jBPM Workbench Docker镜像，只需运行即可试用jBPM Workbench！

使用方法

运行容器：

bash
docker run -p 8080:8080 -p 8001:8001 -d --name jbpm-server-full docker.xuanyuan.run/jboss/jbpm-server-full:latest

容器和Web应用启动后，可使用“用户和角色”部分中描述的任一用户，通过以下URL访问：

http://localhost:8080/business-central

用户和角色

此展示镜像包含默认用户和角色：

数据库

该镜像支持使用H2、MySQL、PostgreSQL作为数据库。默认使用带文件存储的H2数据库，位于<JBOSS_HOME>/standalone/data/jbpm-db目录下。容器配置允许通过一组环境变量切换到MySQL或PostgreSQL数据库，也可使用提供的Docker Compose示例快速启动替代数据库。

Docker Compose示例

MySQL示例

bash
docker-compose -f docker-compose-examples/jbpm-full-mysql.yml up

PostgreSQL示例

bash
docker-compose -f docker-compose-examples/jbpm-full-postgres.yml up

环境变量

• JBPM_DB_DRIVER：指定数据库驱动，可选值：'h2'、'mysql'或'postgres'，默认：'h2'
• JBPM_DB_HOST：指定数据库主机名，默认：'localhost'
• JBPM_DB_PORT：指定数据库端口，默认：使用'mysql'驱动时为'3306'，使用'postgres'时为'5432'
• JBPM_DB_NAME：指定数据库名称，默认：'jbpm'
• JBPM_DB_USER：指定数据库认证用户，默认：'jbpm'
• JBPM_DB_PASSWORD：指定数据库用户密码，默认：'jbpm'

MySQL示例

bash
docker run -p 8080:8080 -p 8001:8001 -d --name jbpm-server-full -e JBPM_DB_DRIVER=mysql -e JBPM_DB_HOST=172.17.0.1 docker.xuanyuan.run/jboss/jbpm-server-full:latest

PostgreSQL示例

bash
docker run -p 8080:8080 -p 8001:8001 -d --name jbpm-server-full -e JBPM_DB_DRIVER=postgres -e JBPM_DB_HOST=172.17.0.1 docker.xuanyuan.run/jboss/jbpm-server-full:latest

日志

可通过以下命令查看standalone进程生成的所有日志：

bash
docker logs [-f] <container_id>

可通过以下命令附加到容器：

bash
docker attach <container_id>

jBPM Workbench和Kie Server Web应用的日志位于容器内以下路径：

/opt/jboss/wildfly/standalone/log/server.log

示例：

bash
sudo nsenter -t $(docker inspect --format '{{ .State.Pid }}' $(docker ps -lq)) -m -u -i -n -p -w
-bash-4.2# tail -f /opt/jboss/wildfly/standalone/log/server.log

GIT内部仓库访问

Workbench将所有项目工件存储在内部GIT仓库中。默认情况下，可通过SSH协议在端口8001访问GIT仓库。

例如，导入IT_Orders示例项目后，可通过以下命令克隆：

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

注意：SSH访问的用户和密码与Web应用中领域文件定义的用户相同。

默认情况下，GIT仓库在应用首次启动时创建于$WORKING_DIR/.niogit（$WORKING_DIR为应用服务器启动的当前目录）。

可通过设置以下Java系统属性指定自定义仓库位置：

-Dorg.uberfire.nio.git.dir=/home/youruser/some/path

注意：如需，可在运行容器时使用共享卷将此目录与Docker主机或其他容器共享。

持久化配置

默认情况下，容器被删除后其内部数据（包括创建的资产和部署到Kie Server的项目）也会被删除。如需创建持久化环境，可基于https://docs.docker.com/engine/tutorials/dockervolumes/%E5%AE%9E%E7%8E%B0%EF%BC%8C%E4%BB%A5%E4%B8%8B%E6%98%AF%E4%B8%A4%E7%A7%8D%E6%96%B9%E6%B3%95%EF%BC%9A

使用默认GIT根目录

Workbench容器的内部GIT根目录默认位于/opt/jboss/wildfly/bin/.niogit，可通过以下命令使用Docker共享卷将此目录持久化到主机：

bash
# 使用 -v <主机文件系统路径>:<容器文件系统路径>
docker run -p 8080:8080 -p 8001:8001 -v /home/myuser/wb_git:/opt/jboss/wildfly/bin/.niogit:Z -d --name jbpm-server-full docker.xuanyuan.run/jboss/jbpm-server-full:latest

运行容器前请创建/home/myuser/wb_git并确保设置正确权限。通过上述命令，Workbench的GIT仓库将持久化到主机的/home/myuser/wb_git路径。删除容器后，使用相同共享卷启动新容器时，所有资产将保留。

如需在不同容器间保持GIT仓库，可通过配置新的主机卷启动容器：

bash
# 使用 -v <主机文件系统路径>:<容器文件系统路径>
docker run -p 8080:8080 -p 8001:8001 -v /home/myuser/wb_git:/opt/jboss/wildfly/.niogit:Z -d --name jbpm-workbench docker.xuanyuan.run/jboss/jbpm-workbench-showcase:MY_TAG

通过上述命令，Workbench的GIT仓库将持久化到本地文件系统的/home/myuser/wb_git路径。删除容器后，使用相同共享卷启动新容器时，所有资产将保留。

环境变量

• KIE_SERVER_ID：指定Kie Server配置使用的标识符，默认：'sample-server'
• KIE_SERVER_LOCATION：指定Kie Server的公共URL，默认：'http://localhost:8080/kie-server/services/rest/server'

实验操作

要在容器中启动shell，可尝试：

bash
docker run -t -i -p 8080:8080 -p 8001:8001 docker.xuanyuan.run/jboss/jbpm-server-full:latest /bin/bash

然后可在容器内浏览文件和运行命令。

故障排除

如果无法通过浏览器访问应用（http://localhost:8080/business-central%EF%BC%89%EF%BC%8C%E8%AF%B7%E4%BD%BF%E7%94%A8https://docs.docker.com/engine/reference/run/#network-settings%E8%BF%90%E8%A1%8C%E5%AE%B9%E5%99%A8%E3%80%82%E6%9C%80%E6%96%B0Docker%E7%89%88%E6%9C%AC%E5%8F%AF%E8%83%BD%E5%AD%98%E5%9C%A8%E7%BD%91%E7%BB%9C%E9%99%90%E5%88%B6%EF%BC%8C%E6%97%A7%E7%89%88%E6%9C%AC%E6%97%A0%E6%AD%A4%E9%97%AE%E9%A2%98%E3%80%82%E5%B0%9D%E8%AF%95%EF%BC%9A

bash
docker run ... --network="host" ...

注意事项

• jBPM Workbench版本：7.61.0.Final
• jBPM Workbench Web应用上下文路径：business-central
• KIE Server版本：7.61.0.Final
• KIE Server Web应用上下文路径：kie-server
• jBPM Case Management Showcase版本：7.61.0.Final
• jBPM Case Management Showcase Web应用上下文路径：jbpm-casemgmt
• 示例和演示始终可用，无需联网
• 不支持集群
• 默认使用嵌入式H2数据库服务器
• 不支持Wildfly域模式，仅支持独立模式
• 此镜像不适用于RedHat OpenShift或Amazon EC2等云环境，因其未满足所有要求
• 如有反馈或问题，请在https://groups.google.com/forum/#!forum/jbpm-setup%E6%88%96https://groups.google.com/forum/#!forum/jbpm-usage Google群组报告
• WildFly已升级至23.0.2.Final版本

发行说明

7.61.0.Final

• 详见http://docs.jboss.org/jbpm/release/7.61.0.Final/jbpm-docs/html_single/#_jbpmreleasenotes