别再手动拷贝war包了！用Docker Compose 5分钟搞定Flowable 6.6.0开发环境-开发者社区

5分钟容器化部署Flowable 6.6.0：告别传统安装的繁琐操作

在传统Java应用部署中，手动配置Tomcat、拷贝WAR包、调整环境变量的过程堪称开发者的"仪式感必修课"。但当我们需要快速验证Flowable工作流框架时，这种耗时的手动操作反而成了效率瓶颈。想象一下这样的场景：新同事入职需要配置开发环境，团队需要统一测试环境，或是临时需要搭建演示环境——每次重复这些步骤不仅浪费时间，还可能因配置差异导致"在我机器上能跑"的经典问题。

容器化技术正是解决这些痛点的利器。通过Docker Compose，我们可以将Flowable的数据库、REST服务和管理界面打包成标准化环境，实现一键启动、版本可控、隔离运行。下面就以Flowable 6.6.0为例，演示如何用5分钟搭建完整的开发环境。

1. 环境准备与Docker配置

1.1 为什么选择容器化部署

传统部署方式面临几个核心挑战：

环境差异：不同开发者机器上的JDK版本、Tomcat配置可能导致运行结果不一致
依赖管理：需要手动下载WAR包、配置数据库连接，步骤繁琐易错
数据持久化：默认H2内存数据库在容器重启后数据丢失

而Docker方案的优势在于：

标准化环境：所有依赖打包成镜像，确保环境一致性
快速启动：docker-compose up命令即可启动全套服务
资源隔离：与宿主机环境隔离，避免端口冲突等问题

1.2 基础环境检查

确保系统已安装以下组件：

# 检查Docker版本（需18.06+） docker --version # 检查Docker Compose版本（需1.25.0+） docker-compose --version

若未安装，可参考官方文档快速安装：

Docker Desktop（Mac/Windows）：https://www.docker.com/products/docker-desktop

Linux系统：

curl -fsSL https://get.docker.com | sh sudo systemctl enable --now docker sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose

2. 编写Docker Compose文件

2.1 完整配置方案

创建docker-compose.yml文件，内容如下：

version: '3.8' services: flowable-db: image: postgres:13 environment: POSTGRES_PASSWORD: flowable POSTGRES_USER: flowable POSTGRES_DB: flowable volumes: - flowable_db_data:/var/lib/postgresql/data ports: - "5432:5432" flowable-rest: image: flowable/flowable-rest:6.6.0 environment: SPRING_DATASOURCE_URL: jdbc:postgresql://flowable-db:5432/flowable SPRING_DATASOURCE_USERNAME: flowable SPRING_DATASOURCE_PASSWORD: flowable depends_on: - flowable-db ports: - "8080:8080" flowable-ui: image: flowable/flowable-ui:6.6.0 environment: SPRING_DATASOURCE_URL: jdbc:postgresql://flowable-db:5432/flowable SPRING_DATASOURCE_USERNAME: flowable SPRING_DATASOURCE_PASSWORD: flowable depends_on: - flowable-db ports: - "8081:8080" volumes: flowable_db_data:

关键配置说明：

PostgreSQL容器：替代默认的H2数据库，通过卷挂载实现数据持久化
REST服务：使用官方flowable-rest镜像，自动连接数据库
管理界面：独立服务，与REST API分离部署

2.2 配置项自定义技巧

根据实际需求可调整以下参数：

environment: # 修改JVM参数（示例） JAVA_OPTS: "-Xmx1024m -Xms512m" # 启用调试模式 FLOWABLE_COMMON_APP_DISABLE_IDM: "false" # 修改时区（Asia/Shanghai） TZ: "Asia/Shanghai"

提示：生产环境建议配置.env文件管理敏感信息，不要将密码直接写在compose文件中

3. 启动与验证服务

3.1 一键启动命令

在docker-compose.yml所在目录执行：

# 后台启动服务 docker-compose up -d # 查看日志（组合键Ctrl+C退出） docker-compose logs -f

正常启动后，终端会显示类似输出：

flowable-db | PostgreSQL init process complete flowable-rest | Started Application in 12.345 seconds flowable-ui | Started Application in 15.678 seconds

3.2 服务访问验证

管理界面访问：

地址：http://localhost:8081/flowable-ui
默认账号：admin/test

REST API测试：

# 获取引擎信息 curl -u rest-admin:test \ http://localhost:8080/flowable-rest/service/management/engines

响应示例：

{ "version": "6.6.0", "databaseSchemaVersion": "6.6.0.0" }

3.3 常见问题排查

若服务启动失败，可参考以下诊断步骤：

检查容器状态：
```
docker-compose ps
```
确认所有服务状态为Up
查看特定容器日志：
```
docker logs <container_name>
```
数据库连接问题：
- 确保flowable-db容器完全启动后再启动应用服务
- 检查数据库连接字符串是否正确
端口冲突处理：
- 修改ports映射（如8082:8080）
- 或停止占用端口的本地服务

4. 进阶配置与优化

4.1 数据持久化方案

默认配置已通过Docker卷实现数据库持久化。如需备份数据，可执行：

# 导出数据库 docker exec -t flowable-db pg_dump -U flowable flowable > flowable_backup.sql # 恢复数据 cat flowable_backup.sql | docker exec -i flowable-db psql -U flowable flowable

4.2 性能调优建议

对于开发环境，建议调整以下参数：

参数	开发环境值	生产环境建议
JAVA_OPTS	-Xmx1G	-Xmx4G
POSTGRES_SHARED_BUFFERS	128MB	2GB
POSTGRES_EFFECTIVE_CACHE_SIZE	1GB	8GB

配置示例：

flowable-db: environment: POSTGRES_SHARED_BUFFERS: 256MB POSTGRES_EFFECTIVE_CACHE_SIZE: 2GB flowable-rest: environment: JAVA_OPTS: "-Xmx2g -Xms1g"

4.3 多环境配置管理

通过扩展compose文件实现环境差异化配置：

# docker-compose.prod.yml services: flowable-rest: environment: SPRING_PROFILES_ACTIVE: "prod"

启动时指定配置文件：

docker-compose -f docker-compose.yml -f docker-compose.prod.yml up

4.4 监控与运维

集成Prometheus监控：

flowable-rest: environment: MANAGEMENT_ENDPOINTS_WEB_EXPOSURE_INCLUDE: "health,info,prometheus" MANAGEMENT_METRICS_EXPORT_PROMETHEUS_ENABLED: "true"

访问监控端点：

http://localhost:8080/flowable-rest/actuator/prometheus

5. 开发工作流实践

5.1 本地开发调试配置

在IDE中配置远程调试：

flowable-rest: environment: JAVA_OPTS: "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005" ports: - "5005:5005"

然后通过IDE连接localhost:5005即可调试。

5.2 数据库迁移策略

从H2迁移到PostgreSQL的步骤：

启动临时H2容器：

docker run -d -p 9092:8080 -p 1521:1521 oscarfonts/h2

导出H2数据为SQL文件

使用pgloader工具转换：

pgloader h2://sa:@localhost/testdb postgresql://flowable:flowable@localhost/flowable

5.3 CI/CD集成示例

GitLab CI配置片段：

deploy: stage: deploy script: - docker-compose down - docker-compose pull - docker-compose up -d only: - master

6. 安全加固建议

6.1 基础安全措施

必须修改的默认配置：

修改管理员密码（通过IDM界面或数据库直接更新）

禁用测试账号：

UPDATE ACT_ID_USER SET PASSWORD_ = '$2a$10$newhash' WHERE ID_ = 'rest-admin';

6.2 网络隔离方案

创建自定义网络提高安全性：

networks: flowable-net: driver: bridge internal: true

然后为每个服务添加：

services: flowable-db: networks: - flowable-net

6.3 镜像安全实践

定期扫描镜像漏洞：

docker scan flowable/flowable-ui:6.6.0

建议使用固定版本标签而非latest，并定期更新到安全版本。

别再手动拷贝war包了！用Docker Compose 5分钟搞定Flowable 6.6.0开发环境