jboss/business-central-workbench

Business-Central Workbench Docker镜像

从7.61.0.Final版本开始，我们将Docker镜像位置从Docker Hub迁移至RedHat Quay。7.61.0.Final版本的镜像将同时存在于两个位置，而>7.61.0.Final版本的镜像仅在Quay上提供。

目录

• 简介
• 使用方法
• 用户与角色
• 日志
• 内部GIT仓库
• 实验操作
• 扩展此镜像
• 故障排除
• 注意事项
• 发布说明

简介

该镜像包含：

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

本镜像提供KIE Business-Central Workbench，旨在通过扩展添加自定义配置。若不想扩展镜像而仅需试用Business-Central Workbench，可查看quay.io/kiegroup/business-central-workbench:latest Docker镜像，该镜像包含默认配置。

使用方法

运行容器：

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

容器和Web应用启动后，可通过以下地址访问Business-Central Workbench：

http://localhost:8080/business-central

用户与角色

应用默认未配置用户或角色，因此无法直接访问。

使用前，至少需在JBoss Wildfly中创建具有admin角色的应用用户。

若需要无需自定义配置的KIE Business-Central Workbench镜像，可尝试quay.io/kiegroup/business-central-workbench:latest Docker镜像。

如需创建自定义配置、用户、角色等，可参考扩展此镜像部分。

日志

查看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仓库

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

克隆GIT仓库：

bash
git clone ssh://admin@localhost:8001/system

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

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

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

注意：若需要，此目录可通过共享卷与Docker主机及其他容器共享。

如需从外部访问GIT仓库，可设置以下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仓库 -->
  <property name="org.uberfire.nio.git.ssh.host" value="0.0.0.0"/>
</system-properties>

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

实验操作

进入容器shell：

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

之后可在容器内浏览文件和执行操作。

扩展此镜像

可扩展此镜像并添加自定义层，以添加自定义配置、用户、角色等。

扩展镜像时，Dockerfile必须继承自：

dockerfile
FROM quay.io/kiegroup/business-central-workbench:latest

配置Wildfly

• Wildfly配置文件位于/opt/jboss/wildfly/standalone/configuration
• 可在此目录修改所有Wildfly子系统配置
• 自定义修改应在standalone.xml配置文件中进行

用户与角色

• 默认情况下，此镜像未为JBoss Business-Central Workbench提供用户和角色

• KIE Business-Central Workbench示例的可用角色：

通过Wildfly领域文件创建自定义用户和角色的步骤：

1. 将目录https://github.com/kiegroup/business-central/tree/7.61.0.Final/showcase/etc/kie-fs-realm-users%E5%A4%8D%E5%88%B6%E5%88%B0%60$JBOSS_HOME/standalone/configuration/%60

   确保kie-fs-realm-users目录归jboss用户所有：chown jboss:jboss -R $JBOSS_HOME/standalone/configuration/kie-fs-realm-users

2. 将文件https://github.com/mbiarnes/business-central/blob/7.61.0.Final/showcase/etc/jbpm-custom.cli%E5%A4%8D%E5%88%B6%E5%88%B0%60$JBOSS_HOME/bin/%60

   完成后将创建以下用户：

   用户	角色
   admin	admin, analyst, kiemgmt, rest-all
   jack	analyst, HR
   john	analys, Accounting, PM
   katy	analyst, IT
   krisv	admin, analyst
   sales-rep	analyst, sales

3. jbpm-custom.cli将修改standalone.xml文件

可参考quay.io/kiegroup/business-central-workbench:latest镜像的Dockerfile获取示例。

故障排除

若无法通过浏览器访问应用（http://localhost:8080/business-central），请使用主机网络模式运行容器。最新Docker版本在网络方面可能存在限制，旧版本无此问题。尝试：

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

注意事项

• KIE Business-Central Workbench Web应用的上下文路径为business-central
• KIE Business-Central Workbench版本为7.61.0.Final
• 默认未配置用户或角色
• 不支持集群
• 默认使用嵌入式H2数据库服务器
• 仅支持Wildfly standalone模式，不支持domain模式
• 此镜像不适合在RedHat OpenShift或Amazon EC2等云环境中运行，因未满足所有要求
• 反馈或问题报告请发送至Drools Setup或Drools Usage Google群组
• WildFly已升级至23.0.2.Final版本

发布说明

7.61.0.Final

• 参见KIE Business-Central发布说明