Camunda Docker 镜像文档

镜像概述和主要用途

Camunda 是一个开源的工作流和业务流程管理(BPM)平台，提供了流程自动化、决策自动化和流程监控等功能。Camunda Docker 镜像封装了 Camunda BPM 平台，方便用户快速部署和运行 Camunda 环境，无需手动配置复杂的依赖关系。

该镜像主要用于在容器环境中部署 Camunda BPM 平台，支持流程建模、执行、监控和优化等全生命周期管理，适用于企业级业务流程自动化场景。

核心功能和特性

• 流程执行引擎：支持 BPMN 2.0 标准，可靠执行复杂业务流程
• 决策引擎：支持 DMN 标准，实现业务规则自动化
• 表单引擎：支持 Form 标准，创建交互式业务表单
• 流程监控：提供 Cockpit 监控工具，实时跟踪流程执行状态
• 流程管理：通过 Tasklist 管理用户任务和工作项
• 流程建模：集成 Modeler 工具，支持流程可视化设计
• 多租户支持：允许在单个实例中管理多个独立租户
• 高可用性：支持集群部署，确保业务流程连续运行

使用场景和适用范围

Camunda 镜像适用于以下场景：

• 企业级业务流程自动化
• 工作流管理系统部署
• 业务规则引擎实现
• 流程优化和数字化转型项目
• DevOps 环境中的流程自动化部署
• 微服务架构中的服务编排
• 快速原型开发和演示环境搭建

适用范围包括金融、保险、制造、零售、医疗等多个行业的业务流程管理需求。

使用方法和配置说明

基本使用方法

使用 docker run 命令启动

docker run -d --name camunda -p 8080:8080 camunda/camunda-bpm-platform:latest

启动后，可通过访问 http://localhost:8080/camunda 打开 Camunda 欢迎页面。默认登录凭据为：

• 用户名：demo
• 密码：demo

使用 docker-compose 配置

创建 docker-compose.yml 文件：

version: '3'
services:
  camunda:
    image: camunda/camunda-bpm-platform:latest
    container_name: camunda
    ports:
      - "8080:8080"
    environment:
      - DB_DRIVER=org.postgresql.Driver
      - DB_URL=jdbc:postgresql://db:5432/camunda
      - DB_USERNAME=camunda
      - DB_PASSWORD=camunda
    depends_on:
      - db
  
  db:
    image: postgres:13
    container_name: camunda-db
    environment:
      - POSTGRES_DB=camunda
      - POSTGRES_USER=camunda
      - POSTGRES_PASSWORD=camunda
    volumes:
      - camunda-db-data:/var/lib/postgresql/data

volumes:
  camunda-db-data:

启动服务：

docker-compose up -d

环境变量配置

Camunda 镜像支持以下环境变量配置：

数据库配置

• DB_DRIVER: 数据库驱动类名（默认：org.h2.Driver）
• DB_URL: 数据库连接 URL（默认：jdbc:h2:./camunda-h2-dbs/process-engine;DB_CLOSE_DELAY=-1）
• DB_USERNAME: 数据库用户名（默认：sa）
• DB_PASSWORD: 数据库密码（默认：空）
• DB_MAX_POOL_SIZE: 数据库连接池最大连接数（默认：20）

管理员用户配置

• CAMUNDA_ADMIN_USERNAME: 管理员用户名（默认：demo）
• CAMUNDA_ADMIN_PASSWORD: 管理员密码（默认：demo）

JVM 配置

• JAVA_OPTS: JVM 参数配置（默认：-Xmx768m -XX:MaxMetaspaceSize=256m）

日志配置

• LOGGING_LEVEL: 日志级别（默认：INFO）

持久化数据

默认情况下，Camunda 使用嵌入式 H2 数据库，数据存储在容器内部。为了实现数据持久化，建议：

1. 使用外部数据库（PostgreSQL、MySQL、Oracle 等）
2. 将数据目录挂载到宿主机：

docker run -d --name camunda -p 8080:8080 \
  -v ./camunda-data:/camunda/data \
  camunda/camunda-bpm-platform:latest

访问 Web 应用

Camunda 提供以下 Web 应用：

• Cockpit: http://localhost:8080/camunda/app/cockpit/default/#/ - 流程监控和管理
• Tasklist: http://localhost:8080/camunda/app/tasklist/default/#/ - 用户任务管理
• Admin: http://localhost:8080/camunda/app/admin/default/#/ - 用户和权限管理

高级配置

数据库配置示例

PostgreSQL 配置

docker run -d --name camunda -p 8080:8080 \
  -e DB_DRIVER=org.postgresql.Driver \
  -e DB_URL=jdbc:postgresql://postgres-host:5432/camunda \
  -e DB_USERNAME=camunda \
  -e DB_PASSWORD=secure-password \
  camunda/camunda-bpm-platform:latest

MySQL 配置

docker run -d --name camunda -p 8080:8080 \
  -e DB_DRIVER=com.mysql.cj.jdbc.Driver \
  -e DB_URL=jdbc:mysql://mysql-host:3306/camunda?useSSL=false \
  -e DB_USERNAME=camunda \
  -e DB_PASSWORD=secure-password \
  camunda/camunda-bpm-platform:latest

自定义部署

如需部署自定义流程或配置，可以通过挂载部署目录实现：

docker run -d --name camunda -p 8080:8080 \
  -v ./processes:/camunda/conf/processes \
  -v ./config:/camunda/conf \
  camunda/camunda-bpm-platform:latest

更多信息

完整的文档和源代码请参考 camunda/camunda GitHub 仓库。