jboss/kie-server

KIE Server Docker镜像

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

目录

• 简介
• 用法
• 用户和角色
• 日志
• 扩展此镜像
• 实验
• 注意事项
• 发布说明

简介

该镜像包含：

• JBoss Wildfly 23.0.2.Final
• KIE Server 7.61.0.Final

此镜像提供Drools KIE Server，旨在被扩展以添加自定义配置。如果不想扩展此镜像而只是尝试Drools KIE Server，可查看quay.io/kiegroup/kie-server:latest Docker镜像，其包含一些默认配置。

用法

JBoss KIE执行服务器旨在作为独立运行时执行环境使用，由KIE Drools Workbench或jBPM Workbench应用程序作为控制器进行管理。此镜像不提供任何默认配置，因此使用执行服务器前建议阅读文档安装KIE Server。也可查看https://registry.hub.docker.com/u/jboss/kie-server-showcase/ Docker镜像中的配置示例。

运行容器

bash
docker run -p 8080:8080 -d --name kie-server quay.io/kiegroup/kie-server:latest

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

http://localhost:8080/kie-server

REST API服务位于：

http://localhost:8080/kie-server/services/rest/server/

用户和角色

应用默认未配置用户或角色，因此无法直接访问。要使用它，至少需在JBoss Wildfly中创建具有kie-server角色的应用用户。

如果需要无需添加自定义配置的KIE Server镜像，可尝试quay.io/kiegroup/kie-server-showcase:latest Docker镜像。若要创建自定义配置、用户、角色等，可查看“扩展此镜像”部分。

日志

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

bash
docker logs [-f] <container_id>

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

bash
docker attach <container_id>

Drools 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

扩展此镜像

可扩展此镜像并添加自定义层，以添加自定义配置、用户、角色等。扩展镜像时，Dockerfile必须继承自：

dockerfile
FROM jboss/kie-server:latest

配置Wildfly

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

用户和角色

• 默认情况下，此镜像不提供Drools KIE Server的用户和角色
• 要使用它，必须创建具有kie-server角色的用户

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

1. 创建用户领域属性文件并部署到/opt/jboss/wildfly/standalone/configuration：

   kie-server-users.properties
   ---------------------
   kieserver=kieserver1!
   

2. 创建角色领域属性文件并部署到/opt/jboss/wildfly/standalone/configuration：

   kie-server-roles.properties
   ---------------------
   kieserver=kie-server
   

3. 修改standalone.xml：

3.1 在management部分，将默认ApplicationRealm安全域修改为：

xml
<security-realm name="ApplicationRealm">
      <authentication>
        <local default-user="$local" allowed-users="*" skip-group-loading="true"/>
        <properties path="kie-server-users.properties" relative-to="jboss.server.config.dir"/>
      </authentication>
      <authorization>
        <properties path="kie-server-roles.properties" relative-to="jboss.server.config.dir"/>
      </authorization>
  </security-realm>

3.2 在security子系统中，将默认other安全域修改为：

xml
<security-domain name="other" cache-type="default">
  <authentication>
    <login-module code="UsersRoles" flag="required">
      <module-option name="usersProperties" value="${jboss.server.config.dir}/kie-server-users.properties"/>
      <module-option name="rolesProperties" value="${jboss.server.config.dir}/kie-server-roles.properties"/>
    </login-module>
  </authentication>
</security-domain>

可查看quay.io/kiegroup/kie-server-showcase:latest镜像的Dockerfile获取示例。

实验

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

bash
docker run -t -i -P 8080:8080 quay.io/kiegroup/kie-server:latest /bin/bash

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

注意事项

• KIE Server应用服务的上下文路径为kie-server
• Drools KIE Server版本为7.61.0.Final
• 默认未配置用户或角色
• 不支持集群
• 此镜像不适用于RedHat OpenShift或Amazon EC2等云环境，因为它未满足所有要求
• 反馈或问题可在Drools Setup或Drools Usage Google群组提交
• WildFly已升级至23.0.2.Final版本

发布说明

7.61.0.Final

• 查看KIE-server的发布说明