amd64/bonita

Bonita Docker 镜像文档

镜像概述和主要用途

Bonita 是一个开源业务流程管理（BPM）和工作流套件，最初于2001年在法国国家计算机科学研究所启动，后由 Bonitasoft 公司主导开发。本 Docker 镜像包含 Bonita Runtime，即集成了 Bonita Engine 和 Bonita Portal 的 Tomcat 捆绑包，可快速部署和运行 Bonita 流程引擎及门户。

核心功能和特性

• 完整运行时环境：包含 Bonita Engine（流程执行核心）和 Bonita Portal（Web 管理界面），基于 Tomcat 服务器构建。
• 多数据库支持：默认使用 H2 数据库（适合开发环境），生产环境推荐 PostgreSQL。
• 安全加固：默认启用 REST API 静态授权检查，HTTP API 默认禁用并支持 Basic 认证保护。
• 灵活配置：通过环境变量自定义数据库连接、管理员凭证、JMX 监控、日志输出等。
• 可扩展性：支持挂载卷存储临时文件和工作目录，便于数据持久化和配置管理。

使用场景和适用范围

• 开发环境：快速启动 Bonita 实例，使用内置 H2 数据库进行流程设计和测试。
• 测试/生产环境：连接外部 PostgreSQL 数据库，配置自定义安全凭证和监控，满足企业级业务流程管理需求。
• 企业流程自动化：适用于需要可视化流程设计、任务分配、流程监控的团队或组织。

支持的标签及对应 Dockerfile 链接

• https://github.com/bonitasoft/bonita-distrib/blob/adca7d9251091cd02f3cde7c0a9cee0e1538c7a1/docker/Dockerfile

维护与支持

• 维护者：https://github.com/bonitasoft/bonita-distrib
• 获取帮助：Bonita 官方文档、StackOverflow、Bonitasoft 社区论坛
• 提交问题：Jira
• 支持架构：amd64（https://github.com/docker-library/official-images#architectures-other-than-amd64%EF%BC%89

详细使用方法和配置说明

快速启动

通过以下命令启动 Bonita 容器（默认使用 H2 数据库，适合开发环境）：

bash
docker run --name bonita -d -p 8080:8080 amd64/bonita

• 容器包含 Bonita Runtime（Tomcat + Bonita Engine + Bonita Portal），默认启用 REST 和 HTTP API 安全加固。
• 访问 Portal：http://localhost:8080/bonita，默认登录凭证：install/install。

连接外部数据库

H2 数据库仅适用于开发环境，生产/测试环境推荐使用 PostgreSQL。

方案 1：连接 PostgreSQL 容器

Bonita 提供预配置的 PostgreSQL 镜像，简化数据库部署：

1. 启动 PostgreSQL 容器：

   bash
   docker run --name mydbpostgres -h <主机名> -d bonitasoft/bonita-postgres:16.4
   

   （<主机名>需与许可证生成时使用的主机名一致）

2. 启动 Bonita 容器并连接数据库：

   bash
   docker run --name bonita -h <主机名> -e "DB_VENDOR=postgres" -e "DB_HOST=mydbpostgres" -e "DB_PORT=5432" -e "DB_NAME=bonita" -e "DB_USER=bonita" -e "DB_PASS=bpm" -e "BIZ_DB_NAME=business_data" -e "BIZ_DB_USER=business_data" -e "BIZ_DB_PASS=bpm" -d -p 8080:8080 --link mydbpostgres:postgres amd64/bonita
   

方案 2：连接外部 PostgreSQL 服务

若数据库为独立服务，创建环境变量配置文件 env.txt：

properties
DB_VENDOR=postgres
DB_HOST=172.17.0.2  # 数据库IP
DB_PORT=5432
DB_NAME=custombonitadb  # 自定义数据库名
DB_USER=custombonitauser  # 数据库用户
DB_PASS=custombonitapass  # 数据库密码
BIZ_DB_NAME=custombusinessdb  # 业务数据库名
BIZ_DB_USER=custombusinessuser  # 业务数据库用户
BIZ_DB_PASS=custombusinesspass  # 业务数据库密码

启动容器：

bash
docker run --name=bonita -h <主机名> --env-file=env.txt -d -p 8080:8080 amd64/bonita

Docker Compose 部署示例

创建 compose.yaml 文件，定义 Bonita 和 PostgreSQL 服务：

yaml
services:
  db:
    image: bonitasoft/bonita-postgres:16.4
    ports:
      - 5432:5432
    environment:
      POSTGRES_PASSWORD: example  # PostgreSQL密码
    restart: always
    healthcheck:  # 健康检查确保数据库就绪
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
      timeout: 5s
      retries: 5

  bonita:
    image: amd64/bonita:latest
    hostname: custom-hostname.example.com  # 与许可证主机名一致
    ports:
      - 8080:8080
    environment:
      - DB_VENDOR=postgres
      - DB_HOST=db
      - DB_PORT=5432
      - DB_NAME=bonita
      - DB_USER=bonita
      - DB_PASS=bpm
      - BIZ_DB_NAME=business_data
      - BIZ_DB_USER=business_data
      - BIZ_DB_PASS=bpm
      - BONITA_RUNTIME_ADMIN_USERNAME=tech_user  # 门户管理员用户名
      - BONITA_RUNTIME_ADMIN_PASSWORD=secret  # 门户管理员密码
      - PLATFORM_LOGIN=pfadmin  # 平台管理员用户名
      - PLATFORM_PASSWORD=pfsecret  # 平台管理员密码
    restart: on-failure:2  # 失败时重启（最多2次）
    depends_on:
      db:
        condition: service_healthy  # 等待数据库健康检查通过

启动服务：

bash
docker compose up -d

自定义安全凭证

通过环境变量修改默认管理员凭证：

bash
docker run --name=bonita -h <主机名> \
  -e "BONITA_RUNTIME_ADMIN_USERNAME=tech_user" \  # 门户管理员用户名
  -e "BONITA_RUNTIME_ADMIN_PASSWORD=secret" \    # 门户管理员密码
  -e "PLATFORM_LOGIN=pfadmin" \                  # 平台管理员用户名
  -e "PLATFORM_PASSWORD=pfsecret" \              # 平台管理员密码
  -d -p 8080:8080 amd64/bonita

登录 Portal 时使用自定义凭证 tech_user/secret。

数据持久化

Bonita 运行时会生成临时文件和工作目录，建议挂载以下路径到卷：

bash
docker run --name bonita -d -p 8080:8080 \
  -v bonita-temp:/opt/bonita/server/temp \  # 临时文件
  -v bonita-work:/opt/bonita/server/work \  # 工作目录
  amd64/bonita

环境变量配置

日志配置

自 Bonita 2022.1 起，可通过挂载卷自定义日志配置：

1. 准备日志配置文件 log4j2-loggers.xml 和 log4j2-appenders.xml（可从 https://github.com/bonitasoft/bonita-distrib/tree/10.3.0/tomcat-resources/tomcat-distrib-for-bonita/src/main/resources/tomcat/server/conf 获取模板）。

2. 挂载配置卷：

   bash
   docker run --name bonita -d -p 8080:8080 \
     -v /path/to/logs/config:/opt/bonita/conf/logs \
     amd64/bonita
   

   修改配置文件后会自动热加载生效。

安全配置

• REST API 授权：默认启用静态授权检查，限制未授权访问。
• HTTP API 保护：默认禁用，启用时需配置 HTTP_API=true 及 HTTP_API_PASSWORD。

  bash
  docker run -e "HTTP_API=true" -e "HTTP_API_PASSWORD=My-Cust0m_S3cR3T" --name bonita -d -p 8080:8080 amd64/bonita
  

版本更新

从旧版本（如 <7.10.0）更新步骤：

1. 停止当前容器并备份数据库：

   bash
   docker stop bonita
   pg_dump -O -x -h <数据库IP> -U <用户> <数据库名> > /tmp/bonitadb.sql  # PostgreSQL示例
   

2. 创建新数据库并恢复备份：

   bash
   psql -U postgres -h <数据库IP> -c "CREATE USER newuser WITH PASSWORD 'newpass';"
   psql -U postgres -h <数据库IP> -c "CREATE DATABASE newdb OWNER newuser;"
   psql -U newuser -h <数据库IP> -d newdb -f /tmp/bonitadb.sql
   

3. 使用 Bonita 更新工具 更新数据库结构。

4. 启动新版本容器：

   bash
   docker run --name bonita -e "DB_NAME=newdb" -e "DB_USER=newuser" -e "DB_PASS=newpass" -d -p 8080:8080 amd64/bonita:2025.1-u0
   

许可证

• Bonita Engine：基于 LGPL v2.1 许可。
• Bonita Portal：基于 GPL v2.0 许可。

镜像可能包含其他软件（如基础系统工具、依赖库等），其许可证需用户自行确认合规性。