Camunda Platform 8 Docker镜像技术文档

1. 镜像概述和主要用途

Camunda Platform 8 Docker镜像是用于部署和运行Camunda流程自动化平台组件的容器化解决方案。该镜像集合提供了Camunda Platform 8核心组件的容器化封装，支持用户在开发、测试及生产环境中快速部署和管理流程自动化平台。

主要用途：

• 部署Zeebe工作流引擎，处理流程实例与任务执行
• 运行Operate进行流程可视化监控与管理
• 提供Tasklist用户任务管理界面
• 集成Optimize进行流程数据分析与优化
• 通过Identity服务实现统一身份认证与授权

2. 核心功能和特性

2.1 容器化部署优势

• 环境一致性：跨开发、测试和生产环境的标准化部署
• 快速启动：简化依赖管理，缩短部署周期
• 资源隔离：组件独立运行，避免环境冲突
• 版本控制：通过镜像标签精确控制组件版本

2.2 核心组件特性

2.3 平台级特性

• 可扩展性：支持水平扩展（如Zeebe集群部署）
• 持久化存储：支持数据卷挂载，确保流程数据持久化
• 监控集成：暴露Prometheus指标接口，支持第三方监控系统
• 配置灵活性：通过环境变量或配置文件自定义组件行为

3. 使用场景和适用范围

3.1 典型使用场景

• 企业流程自动化：端到端业务流程管理（如订单处理、审批流程）
• 微服务编排：基于BPMN的分布式服务协作与数据流控制
• 任务管理：人工任务分配、跟踪与团队协作
• 流程优化：通过数据分析识别流程瓶颈，持续改进业务流程
• 开发测试环境：快速搭建隔离的流程引擎环境，验证流程设计

3.2 适用范围

• 企业级应用：支持高并发、高可用的业务流程需求
• 中小团队：轻量化部署，按需选择组件，降低资源消耗
• 混合云环境：兼容公有云（AWS/Azure/GCP）、私有云及本地数据中心
• 容器编排平台：支持Docker Compose、Kubernetes等容器管理工具

4. 详细使用方法和配置说明

4.1 前提条件

• Docker Engine 20.10+
• Docker Compose v2+（多组件部署）
• 最低资源要求：2核CPU、4GB RAM（开发环境）；4核CPU、8GB RAM（生产环境）

4.2 获取镜像

从Docker Hub拉取官方镜像：

# 拉取核心组件镜像
docker pull camunda/zeebe:latest          # 工作流引擎
docker pull camunda/operate:latest        # 流程监控
docker pull camunda/tasklist:latest       # 任务管理
docker pull camunda/optimize:latest       # 流程分析
docker pull camunda/identity:latest       # 身份认证

4.3 基本部署示例

4.3.1 单组件快速启动（开发环境）

启动Zeebe Broker：

docker run -d \
  --name zeebe \
  -p 26500:26500 \  # 网关API端口
  -p 9600:9600 \    # 监控指标端口
  -e ZEEBE_BROKER_GATEWAY_ENABLED=true \
  camunda/zeebe:latest

验证启动状态：

docker logs zeebe | grep "Startup completed"

4.3.2 多组件部署（Docker Compose）

创建docker-compose.yml部署完整平台：

version: '3.8'

services:
  zeebe:
    image: camunda/zeebe:latest
    container_name: zeebe
    ports:
      - "26500:26500"  # 网关API
      - "9600:9600"    # 监控指标
    environment:
      - ZEEBE_BROKER_GATEWAY_ENABLED=true
      - ZEEBE_BROKER_CLUSTER_PARTITIONSCOUNT=3
      - ZEEBE_BROKER_CLUSTER_REPLICATIONFACTOR=1
    volumes:
      - zeebe-data:/usr/local/zeebe/data  # 持久化数据
    networks:
      - camunda-network

  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.11.3
    container_name: elasticsearch
    environment:
      - discovery.type=single-node
      - xpack.security.enabled=false
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ports:
      - "9200:9200"
    volumes:
      - es-data:/usr/share/elasticsearch/data
    networks:
      - camunda-network

  operate:
    image: camunda/operate:latest
    container_name: operate
    ports:
      - "8080:8080"  # Web界面
    environment:
      - CAMUNDA_OPERATE_ZEEBE_GATEWAYADDRESS=zeebe:26500
      - CAMUNDA_OPERATE_ELASTICSEARCH_URL=[***]
    depends_on:
      - zeebe
      - elasticsearch
    networks:
      - camunda-network

  tasklist:
    image: camunda/tasklist:latest
    container_name: tasklist
    ports:
      - "8081:8080"  # Web界面
    environment:
      - CAMUNDA_TASKLIST_ZEEBE_GATEWAYADDRESS=zeebe:26500
      - CAMUNDA_TASKLIST_ELASTICSEARCH_URL=[***]
    depends_on:
      - zeebe
      - elasticsearch
    networks:
      - camunda-network

networks:
  camunda-network:
    driver: bridge

volumes:
  zeebe-data:
  es-data:

启动服务：

docker-compose up -d

访问服务：

• Operate界面：http://localhost:8080
• Tasklist界面：http://localhost:8081

4.4 核心配置参数

4.4.1 Zeebe关键环境变量

4.4.2 Operate关键环境变量

4.5 持久化配置

核心组件数据持久化需挂载数据卷：

• Zeebe：/usr/local/zeebe/data（流程数据）
• Elasticsearch：/usr/share/elasticsearch/data（Operate/Tasklist数据）
• Identity：/opt/keycloak/data（身份认证数据）

示例（Zeebe持久化）：

docker run -d \
  --name zeebe \
  -v zeebe-data:/usr/local/zeebe/data \
  camunda/zeebe:latest

4.6 监控配置

Zeebe暴露Prometheus指标接口（默认端口9600），Prometheus配置示例：

# prometheus.yml
scrape_configs:
  - job_name: 'zeebe'
    static_configs:
      - targets: ['zeebe:9600']  # Zeebe容器服务地址

5. 进阶配置

5.1 自定义配置文件

通过挂载配置文件覆盖默认设置：

docker run -d \
  --name zeebe \
  -v $(pwd)/custom-zeebe-config:/usr/local/zeebe/config \
  camunda/zeebe:latest

5.2 Zeebe集群部署

配置多节点集群：

# 节点1
docker run -d \
  --name zeebe-node1 \
  -e ZEEBE_BROKER_CLUSTER_NODEID=0 \
  -e ZEEBE_BROKER_CLUSTER_PEERS=zeebe-node1:26502,zeebe-node2:26502 \
  camunda/zeebe:latest

6. 故障排除

• Zeebe启动失败：检查数据卷权限（容器内用户ID为1000），执行chown -R 1000:1000 ./zeebe-data
• 组件通信失败：验证Docker网络配置，确保组件通过服务名互通
• Elasticsearch内存不足：调整JVM参数ES_JAVA_OPTS=-Xms512m -Xmx512m
• 端口冲突：使用docker ps检查占用端口，修改端口映射（如-p 26501:26500）

7. 参考资源

• Camunda Platform 8官方文档
• Docker Hub镜像仓库
• Zeebe客户端SDK
• Camunda社区论坛