arm64v8/bonita

Bonita Docker镜像文档

镜像概述

注意：这是https://hub.docker.com/_/bonita%E7%9A%84%60arm64v8%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%22%E6%AF%8F%E6%9E%B6%E6%9E%84%22%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

• 维护者：
  https://github.com/bonitasoft/bonita-distrib

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

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

警告：此镜像在arm64v8架构上不受支持

快速参考（续）

• 问题提交地址：
  Jira

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/bonita/

• 已发布镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/bonita%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/bonita%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fbonita
  https://github.com/docker-library/official-images/blob/master/library/bonita%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/bonita%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/bonita%EF%BC%88https://github.com/docker-library/docs/commits/master/bonita%EF%BC%89

什么是Bonita？

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

***.org/wiki/Bonita_BPM

!https://raw.githubusercontent.com/docker-library/docs/2a1bd671d71a525b06dacfa8be39ce9656814c40/bonita/logo.png

如何使用此镜像

快速启动

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

这将启动一个运行Bonita运行时的容器：一个包含Bonita引擎和Bonita门户的Tomcat bundle。如果未指定任何环境变量，其效果相当于在主机上使用startup.{sh|bat}启动bundle（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配合使用。Bonita数据库配置的详细说明参见数据库配置页面。或者，Bonita在Docker Hub上提供了预配置的https://hub.docker.com/r/bonitasoft/bonita-postgres%E3%80%82

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

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

此镜像基于https://github.com/Bonitasoft-Community/bonita-database-docker/tree/main/postgres/16%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%8F%AF%E6%A0%B9%E6%8D%AE%E9%9C%80%E8%A6%81%E8%BF%9B%E4%B8%80%E6%AD%A5%E8%B0%83%E6%95%B4/%E8%87%AA%E5%AE%9A%E4%B9%89%E3%80%82

使用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或http://host-ip: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 arm64v8/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 arm64v8/bonita

现在可以通过localhost:8080/bonita访问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受基本身份验证保护。参见以下两个参数配置基本身份验证。

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个文件：https://raw.githubusercontent.com/bonitasoft/bonita-distrib/10.3.0/tomcat-resources/tomcat-distrib-for-bonita/src/main/resources/tomcat/server/conf/log4j2-loggers.xml%E5%92%8Chttps://raw.githubusercontent.com/bonitasoft/bonita-distrib/10.3.0/docker/files/log4j2/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 arm64v8/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.properties
  

  例如：

  properties
  db.vendor=postgres
  db.url=jdbc:postgresql://172