Bonita BPM Docker镜像文档

镜像概述

Bonita BPM Docker镜像是基于开源业务流程管理（BPM）和工作流套件的容器化部署方案。该镜像包含Tomcat Bundle，集成了Bonita BPM Engine（引擎）和Bonita BPM Portal（门户），支持通过简单配置快速启动BPM环境。默认使用H2嵌入式数据库，同时支持与PostgreSQL、MySQL等外部数据库集成，满足不同部署场景需求。

支持标签：7.4

核心功能与特性

• 完整BPM套件：包含Bonita BPM Engine（业务流程执行引擎）和Bonita BPM Portal（用户交互门户）
• 便捷部署：基于Tomcat Bundle，简化传统部署流程，通过Docker命令快速启动
• 数据库灵活性：默认使用H2嵌入式数据库（适合测试），支持与PostgreSQL（推荐）、MySQL等外部数据库集成
• 安全强化：内置REST和HTTP API安全加固，符合基础安全规范

使用场景

• 快速测试与评估：通过默认配置快速启动Bonita BPM环境，验证业务流程功能
• 开发环境搭建：为开发团队提供一致的BPM开发环境
• 生产环境部署：与外部数据库集成，满足高可用性和数据持久化需求

使用方法

1. 快速启动

通过以下命令快速启动Bonita BPM容器，默认使用H2数据库：

docker run --name bonita -d -p 8080:8080 bonita

访问门户

容器启动后，通过以下地址访问Bonita BPM Portal：
http://<localhost>:8080/bonita

默认凭据：
用户名：install
密码：install

说明

未指定环境变量时，容器行为等同于直接运行Tomcat Bundle的startup.{sh|bat}脚本，包含REST和HTTP API的安全强化配置。

2. 链接Bonita BPM到外部数据库

2.1 PostgreSQL（推荐）

PostgreSQL是推荐的生产环境数据库，以下为链接ppc64le架构PostgreSQL镜像的步骤（PostgreSQL镜像地址）。

步骤1：配置PostgreSQL参数

需将PostgreSQL的max_prepared_transactions参数设置为100：

1. 创建自定义配置目录及脚本：

   mkdir -p custom_postgres
   echo '#!/bin/bash' > custom_postgres/bonita.sh
   echo 'sed -i "s/^.*max_prepared_transactions\s*=\s*\(.*\)$/max_prepared_transactions = 100/" "$PGDATA"/postgresql.conf' >> custom_postgres/bonita.sh
   chmod +x custom_postgres/bonita.sh
   

2. 启动PostgreSQL容器，挂载自定义配置目录：

   docker run --name mydbpostgres -v "$PWD"/custom_postgres/:/docker-entrypoint-initdb.d -e POSTGRES_PASSWORD=mysecretpassword -d ppc64le/postgres:9.4
   

   更多配置细节参考PostgreSQL官方文档。

步骤2：启动Bonita并链接PostgreSQL

docker run --name bonita_postgres --link mydbpostgres:postgres -d -p 8080:8080 bonita

2.2 MySQL

链接MySQL数据库时，需调整MySQL的数据包大小参数（默认1M）：

步骤1：配置MySQL参数

1. 创建自定义配置目录及文件：

   mkdir -p custom_mysql
   echo "[mysqld]" > custom_mysql/bonita.cnf
   echo "max_allowed_packet=16M" >> custom_mysql/bonita.cnf
   

2. 启动MySQL容器，挂载自定义配置目录（以ppc64le/mariadb为例）：

   docker run --name mydbmysql -v "$PWD"/custom_mysql/:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=mysecretpassword -d ppc64le/mariadb:10.1
   

步骤2：启动Bonita并链接MySQL

docker run --name bonita_mysql --link mydbmysql:mysql -d -p 8080:8080 bonita