camunda/operate

Camunda Operate Docker镜像文档

1. 镜像概述和主要用途

Camunda Operate 是 Camunda 流程自动化平台的核心组件之一，提供流程实例的实时监控、操作与分析能力。该 Docker 镜像封装了 Camunda Operate 应用，旨在简化部署流程，支持快速集成到基于容器化的 Camunda 生态系统中。

主要用途：

• 监控运行中的流程实例状态与进度
• 查看流程变量、任务详情及执行路径
• 处理异常流程实例（如挂起、激活、终止等操作）
• 分析流程性能指标与瓶颈
• 导出流程运行数据用于审计或报表

更多信息请参考 https://github.com/camunda/camunda%E3%80%82

2. 核心功能和特性

2.1 核心功能

• 实时监控：通过直观的仪表盘展示流程定义、实例数量、活跃任务等关键指标
• 实例追踪：支持按流程定义、业务键、时间范围等维度筛选并查看实例详情
• 操作能力：提供对流程实例的生命周期管理（激活/挂起、终止、重试等）
• 变量管理：查看和更新流程实例的变量数据
• 异常处理：高亮显示失败或停滞的实例，并提供问题定位工具

2.2 关键特性

• 轻量级部署：基于容器化设计，支持快速启停和水平扩展
• 多引擎集成：可连接多个 Camunda 引擎实例，集中监控分布式部署的流程
• 权限控制：支持基于角色的访问控制（RBAC），限制不同用户的操作权限
• 数据持久化：支持外部数据库（如 PostgreSQL、MySQL）存储监控数据，确保数据不丢失

3. 使用场景和适用范围

3.1 典型使用场景

• 企业级流程监控：在生产环境中实时跟踪核心业务流程（如订单处理、审批流程）的运行状态
• 流程运维：运维人员通过 Operate 快速定位并处理异常流程实例，减少业务中断
• 流程优化：通过分析流程执行数据，识别重复卡点或低效环节，优化流程设计
• 合规审计：导出流程运行日志，满足行业合规性要求（如***、***领域的审计追踪）

3.2 适用范围

• 已部署 Camunda BPMN 引擎的容器化环境
• 需要可视化监控流程运行状态的业务团队或运维团队
• 支持单机部署或 Kubernetes 集群环境

4. 使用方法和配置说明

4.1 环境要求

• Docker 19.03+ 或 Kubernetes 1.16+
• 至少 2GB 内存（推荐 4GB+ 用于生产环境）
• 网络可访问 Camunda 引擎 REST API 接口（默认端口 8080）
• 可选：外部数据库（PostgreSQL 12+、MySQL 8.0+）用于数据持久化

4.2 基础部署（Docker Run）

4.2.1 最简启动命令

bash
docker run -d \
  --name camunda-operate \
  -p 8080:8080 \
  -e CAMUNDA_ENGINE_REST_URL=http://camunda-engine:8080/engine-rest \
  camunda/camunda-operate:latest

4.2.2 参数说明

4.3 高级配置（Docker Compose）

4.3.1 完整 docker-compose.yml 示例

yaml
version: '3.8'

services:
  camunda-operate:
    image: camunda/camunda-operate:latest
    container_name: camunda-operate
    ports:
      - "8080:8080"  # Operate Web UI 端口
    environment:
      # 引擎连接配置
      - CAMUNDA_ENGINE_REST_URL=http://camunda-engine:8080/engine-rest
      - CAMUNDA_ENGINE_REST_CONNECT_TIMEOUT=30000  # 连接超时（毫秒）
      - CAMUNDA_ENGINE_REST_READ_TIMEOUT=30000     # 读取超时（毫秒）
      
      # 数据库配置（默认使用内置 H2，生产环境建议外部数据库）
      - SPRING_DATASOURCE_URL=jdbc:postgresql://postgres:5432/operate
      - SPRING_DATASOURCE_USERNAME=operate_user
      - SPRING_DATASOURCE_PASSWORD=operate_pass
      - SPRING_DATASOURCE_DRIVER_CLASS_NAME=org.postgresql.Driver
      
      # 认证配置（默认关闭，生产环境建议启用）
      - SECURITY_ENABLED=true
      - SECURITY_AUTHORIZATION_ENABLED=true
      - SECURITY_USER_NAME=admin
      - SECURITY_USER_PASSWORD=secure_password
      
      # 日志级别（默认 INFO）
      - LOGGING_LEVEL_ROOT=INFO
      - LOGGING_LEVEL_IO_CAMUNDA_OPERATE=DEBUG  # Operate 模块日志级别
    volumes:
      - operate-data:/app/data  # 持久化应用数据（如配置缓存、临时文件）
    depends_on:
      - camunda-engine
      - postgres
    restart: unless-stopped

  # Camunda 引擎服务（示例）
  camunda-engine:
    image: camunda/camunda-bpm-platform:latest
    container_name: camunda-engine
    ports:
      - "8081:8080"  # 引擎 REST API 端口（避免与 Operate 冲突）
    environment:
      - SPRING_DATASOURCE_URL=jdbc:postgresql://postgres:5432/camunda
      - SPRING_DATASOURCE_USERNAME=camunda_user
      - SPRING_DATASOURCE_PASSWORD=camunda_pass

  # 外部数据库（示例：PostgreSQL）
  postgres:
    image: postgres:14-alpine
    container_name: camunda-postgres
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_MULTIPLE_DATABASES=camunda,operate  # 创建引擎和 Operate 数据库
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  operate-data:
  postgres-data:

4.4 核心配置参数说明

4.4.1 引擎连接参数

4.4.2 数据库参数（外部数据库配置）

4.4.3 安全认证参数

4.5 访问与验证

部署完成后，通过 http://<宿主机IP>:8080 访问 Camunda Operate Web UI：

• 默认端口：8080（可通过 -p 参数自定义映射）
• 未启用认证时：直接访问 UI；启用认证时，使用配置的 SECURITY_USER_NAME 和 SECURITY_USER_PASSWORD 登录

5. 注意事项

• 数据持久化：生产环境需使用外部数据库（如 PostgreSQL）并挂载数据卷，避免容器重启导致数据丢失
• 版本兼容性：Operate 版本需与 Camunda 引擎版本匹配（建议使用相同大版本，如 Operate 8.x 对应引擎 8.x）
• 资源配置：根据流程实例数量调整容器内存（推荐生产环境分配 4GB+ 内存）
• 网络隔离：确保 Operate 与引擎、数据库之间的网络连通性，避免防火墙或网络策略限制

如需更多配置细节或高级功能，建议参考 Camunda 官方文档或 GitHub 仓库。