注意： 这是bonita镜像的ppc64le架构构建的“每架构”仓库——更多信息，请参见镜像文档中的“除amd64之外的架构？”和***镜像FAQ中的“镜像的源代码在Git中已更改，现在该怎么办？”。

快速参考

• 维护者：
  Bonitasoft社区

• 获取帮助：
  Bonita***文档、StackOverflow、Bonitasoft社区论坛

支持的标签及对应的Dockerfile链接

警告： 此镜像在ppc64le架构上不被支持

快速参考（续）

• 问题反馈地址：
  Jira

• 支持的架构： (更多信息)
  amd64

• 已发布镜像制品详情：
  repo-info仓库的repos/bonita/目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images仓库的library/bonita标签
  official-images仓库的library/bonita文件（历史记录）

• 此描述的来源：
  docs仓库的bonita/目录（历史记录）

什么是Bonita？

Bonita是一个开源的业务流程管理和工作流套件，创建于2001年。它最初由法国国家计算机科学研究所启动，随后在法国计算机科学公司Groupe Bull内部孵化多年。自2009年起，Bonita的开发由一家专门从事该领域的公司Bonitasoft支持。

***.org/wiki/Bonita_BPM

!logo

如何使用此镜像

快速启动

console
$ docker run --name bonita -d -p 8080:8080 ppc64le/bonita

这将启动一个运行Bonita运行时的容器：包含Bonita引擎和Bonita门户的Tomcat捆绑包。未指定环境变量时，相当于使用startup.{sh|bat}在主机上启动捆绑包（REST和HTTP API有安全强化，参见安全部分）。此处Bonita使用H2数据库。

您可以通过http://localhost:8080/bonita访问Bonita门户，使用默认凭据登录：install/install

链接Bonita到数据库

H2数据库允许Bonita容器开箱即用，但不推荐在开发环境之外使用。

PostgreSQL是推荐用于验证和生产环境的数据库，请按照以下部分之一配置Bonita容器以运行在PostgreSQL数据库上。您可以使用PostgreSQL容器或已安装的PostgreSQL服务。

PostgreSQL容器

从Bonita 2022.1版本开始，Bonita Docker镜像不再包含自动创建数据库和用户的配置脚本。

因此，在启动Bonita容器之前，需要配置PostgreSQL容器以与Bonita配合使用。数据库配置页面详细描述了配置PostgreSQL数据库以与Bonita配合使用的步骤。或者，Bonita在Docker Hub上提供了预配置的PostgreSQL镜像。

您可以使用以下命令运行该镜像：

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

此镜像基于以下GitHub仓库构建，可进一步调整/自定义以满足您的需求。

... 通过docker compose

bonita的compose.yaml示例：

yaml
services:
  db:
    image: bonitasoft/bonita-postgres:16.4
    ports:
      - 5432:5432
    environment:
      POSTGRES_PASSWORD: example
    restart: always
  bonita:
    image: bonita:2024.3
    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
    depends_on:
      db:
        condition: service_healthy

运行docker compose up，等待其完全初始化，然后访问http://localhost:8080或[***]（视情况而定）。

• 将<hostname>替换为许可证生成命令中使用的主机名
• 保留双$$不变

已安装的PostgreSQL服务

如果不想在Docker容器中运行数据库，需要配置以下env.txt文件并提供给docker run命令：

properties
DB_VENDOR=postgres
DB_HOST=172.17.0.2
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 <hostname> --env-file=env.txt -d -p 8080:8080 ppc64le/bonita

使用自定义安全凭证启动Bonita

bash
docker run --name=bonita -h <hostname> -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 ppc64le/bonita

现在您可以访问本地主机上的Bonita运行时：localhost:8080/bonita，使用凭据登录：tech_user/secret

数据存储位置

Bonita使用Tomcat，会将文件写入工作目录和临时目录。

将以下文件夹挂载到卷中是一个好***惯：

• /opt/bonita/server/temp
• /opt/bonita/server/work

环境变量

启动bonita镜像时，可以通过在docker run命令行上传递一个或多个环境变量来调整Bonita实例的配置。

PLATFORM_LOGIN

此可选环境变量与PLATFORM_PASSWORD一起用于定义平台管理员的用户名。如果未指定，默认用户名为platformAdmin。

PLATFORM_PASSWORD

建议使用此环境变量来配置Bonita镜像。它设置Bonita的平台管理员密码。如果未指定，默认密码为platform。

BONITA_RUNTIME_ADMIN_USERNAME

此可选环境变量与BONITA_RUNTIME_ADMIN_PASSWORD一起用于定义租户管理员的用户名。如果未指定，默认用户名为install。

BONITA_RUNTIME_ADMIN_PASSWORD

建议使用此环境变量来配置Bonita镜像。它设置Bonita的租户管理员密码。如果未指定，默认密码为install。

MONITORING_USERNAME

此可选环境变量与MONITORING_PASSWORD一起用于定义受基本身份验证保护的端点的访问权限：用于JMX远程访问。如果未指定，默认监控用户名为monitoring。

MONITORING_PASSWORD

此可选环境变量与MONITORING_USERNAME一起用于定义受基本身份验证保护的端点的访问权限：用于JMX远程访问。如果未指定，默认监控密码为mon1tor1ng_adm1n。

HTTP_API

此可选环境变量用于启用/禁用Bonita HTTP API。默认值为false，将停用HTTP API。从Bonita 2022.1版本开始，HTTP API受基本身份验证保护。参见以下2个参数配置基本身份验证。

HTTP_API_USERNAME

此可选环境变量用于配置HTTP API基本身份验证的用户名。默认值为http-api。

HTTP_API_PASSWORD

此可选环境变量用于配置HTTP API基本身份验证的密码。没有默认值，如果HTTP_API=true，则必须提供此值。

JMX_REMOTE_ACCESS

此可选环境变量用于启用/禁用从远程机器访问JMX控制台。默认值为false。连接的主机是Bonita服务器的名称/IP地址，连接端口是9000。连接凭据是环境变量MONITORING_USERNAME和MONITORING_PASSWORD。

REMOTE_IP_VALVE_ENABLED

此可选环境变量允许激活/停用反向代理重定向。默认值为false。

ACCESSLOGS_STDOUT_ENABLED

此可选环境变量允许激活/停用将Tomcat访问日志写入标准输出。默认值为false。

ACCESSLOGS_FILES_ENABLED

此可选环境变量允许激活/停用将Tomcat访问日志写入特定文件。激活后，将日志写入Docker容器内的/opt/bonita/logs/目录。实际上，只有将卷挂载到上述目录时才有用。默认值为false。

ACCESSLOGS_PATH

如果ACCESSLOGS_FILES_ENABLED=true，此可选环境变量覆盖访问日志文件的默认路径。默认值为/opt/bonita/logs。

ACCESSLOGS_PATH_APPEND_HOSTNAME

如果ACCESSLOGS_FILES_ENABLED=true，此可选环境变量允许在访问日志文件目录的完整路径后附加一个带有主机名的子目录。默认值为false。

ACCESSLOGS_MAX_DAYS

如果ACCESSLOGS_FILES_ENABLED=true，此可选环境变量允许自动删除超过指定天数的访问日志文件。默认值为30。

HTTP_MAX_THREADS

此可选环境变量允许指定Tomcat用于处理HTTP/1.1请求的最大Http线程数。直接修改Docker容器内Tomcat的server.xml文件中的maxThreads参数。有关此参数用途的更多信息，请参见此处。默认值为20。

JAVA_OPTS

此可选环境变量用于自定义JAVA_OPTS。默认值为-Xms1024m -Xmx1024m -XX:MaxPermSize=256m。使用语法：-e JAVA_OPTS="-Xms2048m -Xmx2048m -XX:MaxPermSize=1024m"

DB_VENDOR

如果使用--link将Bonita容器链接到PostgreSQL或MySQL数据库，此环境变量会自动设置为postgres或mysql。默认值为h2。如果不使用--link功能，可以覆盖此值。

DB_HOST, DB_PORT

这些变量是可选的，用于配置Bonita镜像以连接数据库实例。如果使用--link运行容器，这些变量会自动设置。

DB_NAME, DB_USER, DB_PASS

这些变量一起用于定义Bonita应如何访问其内部功能的数据库。

DB_NAME默认值为bonitadb。

DB_USER默认值为bonitauser。

DB_PASS默认值为bonitapass。

BIZ_DB_NAME, BIZ_DB_USER, BIZ_DB_PASS

这些变量一起用于定义Bonita应如何访问业务数据数据库。

BIZ_DB_NAME默认值为businessdb。

BIZ_DB_USER默认值为businessuser。

BIZ_DB_PASS默认值为businesspass。

日志配置

自2022.1版本起

可以通过将包含配置文件的卷挂载到/opt/bonita/conf/logs目录来配置日志。

该卷必须包含2个文件：log4j2-loggers.xml和log4j2-appenders.xml

对这两个文件中的任何更改都会自动热加载并立即生效。

安全

此Docker镜像默认在REST API上激活静态和动态授权检查。为保持一致，它还停用了HTTP API。

• REST API授权

  • 静态授权检查

• HTTP API

对于特定需求，可以通过将HTTP_API设置为true来覆盖此行为：

console
$ docker run  -e HTTP_API=true -e HTTP_API_PASSWORD="My-Cust0m_S3cR3T" --name bonita -d -p 8080:8080 ppc64le/bonita

从早期版本的Bonita更新

要从7.10.0之前的版本更新，请参考文档

• 停止容器以执行数据库备份

  console
  $ docker stop bonita
  

• 获取DB容器IP

  console
  $ docker inspect --format '{{ .NetworkSettings.IPAddress }}' mydbpostgres
  172.17.0.26
  

• 转储数据库

  console
  $ export PGPASSWORD=mysecretpassword
  $ pg_dump -O -x -h 172.17.0.26 -U postgres bonitadb > /tmp/bonitadb.sql
  

注意，businessdb不会被更新工具更新，但您可能也需要备份/迁移它。

• 加载转储

  console
  $ export PGPASSWORD=mysecretpassword
  $ psql -U postgres -h 172.17.0.26 -d postgres -c "CREATE USER newbonitauser WITH PASSWORD 'newbonitapass';"
  $ psql -U postgres -h 172.17.0.26 -d postgres -c "CREATE DATABASE newbonitadb OWNER newbonitauser;"
  $ export PGPASSWORD=newbonitapass
  $ cat /tmp/bonitadb.sql | psql -U newbonitauser -h 172.17.0.26 newbonitadb
  

• 从[***]

  console
  unzip bonita-update-tool-3.7.0.zip
  

• 配置更新工具

  console
  $ cd bonita-update-tool-3.7.0
  

编辑更新工具配置文件Config.properties以指向数据库。

console
$ vim Config