bonitasoft/bonita-postgres

Bonita专用预配置PostgreSQL数据库镜像

镜像概述

本镜像基于https://hub.docker.com/_/postgres%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%B8%93%E4%B8%BA%E4%B8%8EBonita%E9%9B%86%E6%88%90%E8%80%8C%E9%A2%84%E9%85%8D%E7%BD%AE%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%8D%B3%E5%BC%80%E5%8D%B3%E7%94%A8%E7%9A%84%E6%95%B0%E6%8D%AE%E5%BA%93%E7%8E%AF%E5%A2%83%EF%BC%8C%E6%97%A0%E9%9C%80%E6%89%8B%E5%8A%A8%E9%85%8D%E7%BD%AEBonita%E6%89%80%E9%9C%80%E7%9A%84%E6%95%B0%E6%8D%AE%E5%BA%93%E5%8F%82%E6%95%B0%E5%92%8C%E7%BB%93%E6%9E%84%E3%80%82

核心功能与特性

配置优化

• 设置Bonita必需的max_prepared_transactions参数为100，确保与Bonita平台兼容。

预配置数据库

包含Bonita运行所需的两个数据库：

• bonita：连接用户bonita，密码bpm
• business_data：连接用户business_data，密码bpm

使用场景

适用于需要快速部署Bonita平台的开发、测试或生产环境，简化数据库配置流程，确保Bonita与PostgreSQL的无缝集成。

使用方法

基本运行方式

shell
docker run -d --name bonita-postgres -p 5432:5432 bonitasoft/bonita-postgres:15.3

推荐运行方式（数据持久化）

通过挂载卷将数据文件存储在容器外部，避免数据丢失：

shell
docker run -d \
      --name bonita-postgres \
      -p 5432:5432 \
      -v /my/postgres/datadir:/var/lib/postgresql/data \
      bonitasoft/bonita-postgres:15.3

带备份/恢复和脚本交换卷的运行方式

添加本地卷用于备份/恢复操作和脚本交换：

shell
docker run -d \
      --name bonita-postgres \
      -p 5432:5432 \
      -v /my/postgres/datadir:/var/lib/postgresql/data \
      -v /my/sql/folder:/opt/bonita/sql \
      bonitasoft/bonita-postgres:15.3

容器管理

进入容器shell

shell
docker exec -it bonita-postgres bash

查看Postgres日志

shell
docker logs bonita-postgres

备份恢复

自动恢复机制

容器会自动恢复/opt/bonita/dump卷中存在的备份文件。

纯文本SQL格式

备份文件需命名为bonita.dump和business_data.dump，可通过以下命令生成：

shell
pg_dump -h localhost -p 5432 -Ubonita bonita > /opt/bonita/dump/bonita.dump
pg_dump -h localhost -p 5432 -Ubusiness_data business_data > /opt/bonita/dump/business_data.dump

压缩格式

备份文件需命名为bonita.pgdump和business_data.pgdump，生成命令：

shell
# 生成bonita数据库压缩备份
pg_dump -h localhost -p 5432 -U bonita --quote-all-identifiers --encoding=utf8 -F c bonita > /opt/bonita/dump/bonita.pgdump

# 生成恢复白名单文件（可编辑此文件注释不需要恢复的项）
pg_restore -l /opt/bonita/dump/bonita.pgdump > /opt/bonita/dump/bonita.list 

# 生成business_data数据库压缩备份
pg_dump -h localhost -p 5432 -U business_data --quote-all-identifiers --encoding=utf8 -F c business_data > /opt/bonita/dump/business_data.pgdump
pg_restore -l /opt/bonita/dump/business_data.pgdump > /opt/bonita/dump/business_data.list 

运行容器时挂载备份卷：

shell
docker run -d \
      --name bonita-postgres \
      -p 5432:5432 \
      -v /my/postgres/dump:/opt/bonita/dump \
      bonitasoft/bonita-postgres:15.3

注意：若容器已存在，需先使用docker rm <CONTAINER_ID>删除，否则恢复不会生效。

恢复非默认"bonita" schema的备份

1. 创建带管理员密码的容器：

   shell
   docker run -d --name postgres-from-dump -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword -v /my/postgres/dump:/opt/bonita/dump bonitasoft/bonita-postgres:15.3
   

2. 进入容器：

   shell
   docker exec -it postgres-from-dump
   

3. 执行恢复命令：

   shell
   psql -U postgres bonita < ./my_dump_file.sql
   

镜像测试

可通过Docker Compose测试本镜像与Bonita Docker镜像的集成，参考以下配置文件：

• https://github.com/Bonitasoft-Community/bonita-database-docker/blob/main/postgres/15/test/docker-compose.yml
• https://github.com/Bonitasoft-Community/bonita-database-docker/blob/main/postgres/15/test/docker-compose-community.yml

启动测试环境

shell
docker-compose up --build -d
# 或使用社区版配置
docker-compose -f docker-compose-community.yml up --build -d

清理测试环境

shell
docker-compose down -v --remove-orphans