jboss/business-central-workbench-showcase

Business-Central Workbench Showcase Docker镜像

从7.61.0.Final版本开始，我们将Docker镜像的托管位置从Docker迁移至RedHat Quay。

7.61.0.Final版本的镜像将同时存在于Docker和Quay两个位置。

版本号大于7.61.0.Final的镜像将仅在Quay上提供。

目录

• 简介
• 使用方法
• 用户与角色
• 日志
• GIT内部仓库访问
• 持久化配置
• 实验操作
• 故障排除
• 注意事项
• 发布说明

简介

该镜像包含：

• JBoss Wildfly 23.0.2.Final
• KIE Business-Central Workbench 7.61.0.Final

此镜像继承自quay.io/kiegroup/business-central-workbench:latest，并提供以下额外配置：

• 默认用户和角色
• 部分示例

这是一个可直接运行的JBoss Business-Central Workbench Docker镜像。只需运行它即可体验JBoss Business-Central Workbench！

使用方法

运行容器：

bash
docker run -p 8080:8080 -p 8001:8001 -d --name jbpm-workbench quay.io/kiegroup/business-central-workbench-showcase:latest

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

http://localhost:8080/business-central

用户与角色

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

日志

可通过以下命令查看standalone二进制文件生成的所有日志：

bash
docker logs [-f] <container_id>

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

bash
docker attach <container_id>

JBoss Business-Central Workbench 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内部仓库访问

工作台将所有项目工件存储在内部GIT仓库中。默认情况下，用于访问GIT仓库的协议是SSH，端口为8001。

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

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

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

可通过设置以下Java系统属性指定自定义仓库位置（目标文件系统目录）：

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

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

如需使GIT仓库可从外部localhost访问，可使用以下Java系统属性：

-org.uberfire.nio.git.ssh.host=0.0.0.0

可通过在standalone-full.xml文件中添加以下行，永久设置这些Java系统属性：

xml
<system-properties>
  <!-- 自定义仓库位置 -->
  <property name="org.uberfire.nio.git.dir" value="/home/youruser/some/path"/>
  <!-- 使GIT仓库可从外部localhost访问 -->
  <property name="org.uberfire.nio.git.ssh.host" value="0.0.0.0"/>
</system-properties>

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

持久化配置

默认情况下，Docker容器被移除后，容器内的数据也会被删除。

乍一看，只要不删除容器，工作台容器中创建的资产就不会丢失，可随时停止和重启容器，且不同的KIE执行服务器容器可使用这些资产。但如果需要删除并创建新的工作台容器，问题就会出现。

如需创建持久化环境，可基于Docker卷实现。以下是两种方法：

使用默认GIT根目录

默认情况下，工作台容器的内部GIT根目录位于/opt/jboss/wildfly/bin/.niogit，可通过使用Docker共享卷运行容器，将此目录持久化到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-workbench jboss/jbpm-workbench-showcase:latest

运行Docker容器前，请创建/home/myuser/wb_git并确保设置了正确的权限。通过上述命令，工作台GIT仓库将持久化到主机文件系统的/home/myuser/wb_git路径。因此，即使删除此容器并使用相同的共享卷启动新容器，新工作台容器中也会保留所有资产。

使用自定义GIT根目录

以本展示模块为基础，按以下步骤操作：

1. 编辑jbpm-custom.cli，取消注释默认GIT仓库位置并修改为自定义路径：

# 将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. 创建Docker镜像：

bash
docker build --rm -t quay.io/kiegroup/business-central-workbench-showcase:MY_TAG

此时，工作台的默认GIT根目录将位于Docker容器内的/opt/jboss/wildfly/mygit/路径。所有资产将存储在此路径下的GIT结构中。

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

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

通过上述命令，工作台GIT仓库将持久化到本地文件系统的/home/myuser/wb_git路径。因此，即使删除此容器并使用相同的共享卷启动新容器，新工作台容器中也会保留所有资产。

实验操作

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

bash
docker run -t -i -p 8080:8080 -p 8001:8001 quay.io/kiegroup/business-central-workbench-showcase:latest /bin/bash

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

故障排除

如果无法通过浏览器访问应用（http://localhost:8080/business-central），请使用主机网络模式运行容器。最新的Docker版本似乎在网络方面有一些限制，使用旧版本的daemon则不会出现此问题。尝试：

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

注意事项

• KIE Business-Central Workbench Web应用的上下文路径为business-central
• KIE Business-Central Workbench版本为7.61.0.Final
• 示例和演示始终可用，即使未连接互联网
• 不支持集群
• 默认使用嵌入式H2数据库服务器
• 不支持Wildfly域模式，仅支持独立模式
• 此镜像不适用于RedHat OpenShift或Amazon EC2等云环境，因为它不符合所有要求
• 如有反馈或问题，请在jBPM Setup或jBPM Usage Google群组中报告
• WildFly已升级至23.0.2.Final版本

发布说明

7.61.0.Final

• 参见KIE Business-Central发布说明