openltablets/ws

OpenL RuleServices WS Docker镜像

镜像概述和主要用途

OpenL RuleServices WS Docker镜像是一个用于执行OpenL Tablets规则的Web服务应用，支持通过规则仓库在运行时热更新规则。该镜像提供不同版本，适用于从简单规则发布到复杂系统集成的多种场景。

支持的标签

• 5.27.12 5.27.x latest
• 5.27.12-all
• 5.26.17 5.26.x
• 5.26.17-all

标签后缀含义

• 不带all：基础镜像，仅支持发布OpenL规则，通常满足基本需求。

• jre21：5.27.x版本镜像的变体，运行于JRE 21。

• jakarta：5.27.x版本镜像的变体，运行于JRE 21并包含Jakarta EE 10 API。

• all：包含额外功能和集成模块的扩展镜像，支持与其他子系统集成：

  • Cassandra日志存储
  • ElasticSearch日志存储
  • 数据库日志存储
  • Git规则仓库
  • AWS S3规则仓库
  • Azure BLOB存储规则仓库

该镜像体积较大，因为包含更多依赖，运行时也需要更多CPU和RAM资源。

什么是OpenL Tablets？

OpenL Tablets旨在弥合业务需求（规则和策略）与软件实现之间的鸿沟。其设计对业务人员直观易懂，规则表示形式接近业务文档（如业务需求说明等），使业务人员可直接聚焦于逻辑编写，同时实时检查数据、语法和类型错误。支持一键部署规则为高效、可扩展的标准化服务，Java开发者可通过反射式API或Java类包装使用规则。OpenL Tablets基于LGPL许可证开源。

使用方法

基础运行

运行最新版镜像：

console
$ docker run -d --rm -p 9080:8080 openltablets/ws

应用启动后，可通过访问http://localhost:9080测试。

指定版本运行

使用特定版本标签：

console
$ docker run -d --rm -p 9080:8080 openltablets/ws:[TAG]

（将[TAG]替换为具体标签，如5.27.12）

配置说明

通过环境变量配置镜像，常用参数如下：

• ruleservice.logging.enabled=true：启用请求/响应日志（注意：会降低性能）
• ruleservice.instantiation.strategy.lazy=false：禁用延迟初始化（生产环境推荐，启动时间较长但首次调用更快，内存消耗更高）
• JAVA_OPTS="-XX:MaxRAMPercentage=50.0"：设置JVM内存占可用内存比例（默认90%）
• ruleservice.isProvideRuntimeContext=false：禁用运行时上下文支持

更多配置详见OpenL Tablets文档。

使用文件系统规则仓库

挂载本地文件夹作为规则仓库：

console
$ docker run -d --rm -p 9080:8080 \
-v ./openl-repository-folder:/tmp/openl \
-e production-repository.factory=repo-file \
-e production-repository.uri=/tmp/openl \
openltablets/ws

使用数据库规则仓库

挂载JDBC驱动并配置数据库连接：

console
$ docker run --rm -d -p 9080:8080 \
-v ./mysql-connector-j-8.3.0.jar:/opt/openl/lib/jdbc.jar \
-e production-repository.factory=repo-jdbc \
-e production-repository.uri=jdbc:mysql://mysql-db-server/test \
-e production-repository.login=mysql \
-e production-repository.password=mysql \
openltablets/ws

若使用Docker Toolbox，需确保JDBC驱动所在文件夹已在VM中共享。更多配置详见OpenL Tablets文档。