camunda/zeebe

Camunda Zeebe 镜像文档

一、镜像概述和主要用途

Camunda Zeebe 镜像为 Camunda Platform 8 的核心组件，封装了分布式微服务编排引擎 Zeebe 的运行环境。Zeebe 基于事件驱动架构，专为处理高吞吐量、低延迟的分布式工作流和服务编排场景设计，支持 BPMN 2.0 标准流程定义，可无缝集成微服务架构，实现业务流程的自动化与可视化管理。

二、核心功能和特性

2.1 核心功能

• 分布式工作流执行：基于 BPMN 2.0 规范解析和执行流程定义，支持流程实例的创建、推进、暂停与终止。
• 微服务编排：通过消息、信号、定时器等机制，协调多个微服务按预定逻辑交互，实现跨服务业务流程。
• 事件驱动处理：支持事件触发式流程（如消息事件、信号事件、错误事件），适配异步通信场景。
• 流程状态管理：实时追踪流程实例状态，提供流程变量存储与查询能力，支持流程历史数据记录。

2.2 关键特性

• 分布式架构：无中心节点设计，支持多节点集群部署，具备水平扩展能力。
• 高可用性：基于 Raft 共识算法实现数据一致性，节点故障时自动选举 leader，保障服务不中断。
• 高吞吐量：优化的持久化机制（基于 RocksDB），支持每秒数万级流程实例处理。
• BPMN 2.0 兼容：完全符合 BPMN 2.0 标准，支持任务、网关、事件、子流程等核心元素。
• 容错与自愈：自动检测并恢复异常流程实例，支持故障节点重启后的数据同步。
• 轻量级网关：内置网关服务，提供 gRPC API 接口，支持客户端（Java、Go、Python 等）接入。

三、使用场景和适用范围

3.1 典型使用场景

• 微服务编排：跨多个微服务的业务流程协调（如订单创建→库存检查→支付处理→物流通知）。
• 复杂业务流程自动化：包含分支、并行、条件判断的流程（如审批流程、报销流程）。
• 事件驱动架构（EDA）：基于事件触发的流程响应（如消息队列事件、数据库变更事件）。
• 高吞吐量业务场景：需要处理大量并发流程实例的系统（如电商订单处理、***交易清算）。
• 可扩展系统构建：支持通过增加节点动态扩展集群处理能力，适配业务增长。

3.2 适用范围

• 微服务架构下的服务编排需求。
• 需要可视化流程定义与监控的业务系统。
• 对流程执行的可靠性、可追溯性有高要求的场景（如***、***）。
• 需支持水平扩展以应对流量波动的业务（如促销活动期间的订单峰值）。

四、使用方法和配置说明

4.1 基本使用（单节点模式）

4.1.1 快速启动（Docker Run）

通过以下命令启动单节点 Zeebe 服务，暴露默认端口并持久化数据：

bash
docker run -d \
  --name zeebe-node \
  -p 26500:26500 \  # 网关 gRPC 端口（客户端通信）
  -p 9600:9600 \    # 监控指标端口（Prometheus）
  -v zeebe-data:/usr/local/zeebe/data \  # 持久化数据目录
  camunda/zeebe:latest

说明：zeebe-data 为 Docker 卷，用于持久化流程数据、元数据及日志，避免容器重启后数据丢失。

4.1.2 Docker Compose 配置（单节点）

创建 docker-compose.yml 文件，定义服务、端口、数据卷及基础环境变量：

yaml
version: '3.8'
services:
  zeebe:
    image: docker.xuanyuan.run/camunda/zeebe:latest
    container_name: zeebe-node
    ports:
      - "26500:26500"  # 网关 gRPC 端口
      - "9600:9600"    # 监控端口
    volumes:
      - zeebe-data:/usr/local/zeebe/data
    environment:
      - ZEEBE_BROKER_GATEWAY_ENABLE=true  # 启用网关（默认开启）
      - ZEEBE_BROKER_LOG_LEVEL=info       # 日志级别（info/warn/debug）
      - JAVA_TOOL_OPTIONS=-Xms512m -Xmx1g  # JVM 内存配置

volumes:
  zeebe-data:  # 声明数据卷

启动服务：

bash
docker-compose up -d

4.2 集群模式配置

Zeebe 支持多节点集群部署，需通过环境变量配置集群参数。以下为 3 节点集群的 docker-compose.yml 示例：

yaml
version: '3.8'
services:
  zeebe-1:
    image: docker.xuanyuan.run/camunda/zeebe:latest
    container_name: zeebe-1
    ports:
      - "26500:26500"
      - "9600:9600"
    volumes:
      - zeebe-data-1:/usr/local/zeebe/data
    environment:
      - ZEEBE_BROKER_CLUSTER_NODE_ID=0
      - ZEEBE_BROKER_CLUSTER_PEERS=zeebe-1:26502,zeebe-2:26502,zeebe-3:26502  # 集群节点通信地址
      - ZEEBE_BROKER_CLUSTER_CLUSTER_SIZE=3  # 集群节点总数
      - ZEEBE_BROKER_CLUSTER_REPLICATION_FACTOR=2  # 数据副本数
      - ZEEBE_BROKER_NETWORK_HOST=zeebe-1  # 容器内主机名（需与服务名一致）

  zeebe-2:
    image: docker.xuanyuan.run/camunda/zeebe:latest
    container_name: zeebe-2
    volumes:
      - zeebe-data-2:/usr/local/zeebe/data
    environment:
      - ZEEBE_BROKER_CLUSTER_NODE_ID=1
      - ZEEBE_BROKER_CLUSTER_PEERS=zeebe-1:26502,zeebe-2:26502,zeebe-3:26502
      - ZEEBE_BROKER_CLUSTER_CLUSTER_SIZE=3
      - ZEEBE_BROKER_CLUSTER_REPLICATION_FACTOR=2
      - ZEEBE_BROKER_NETWORK_HOST=zeebe-2

  zeebe-3:
    image: docker.xuanyuan.run/camunda/zeebe:latest
    container_name: zeebe-3
    volumes:
      - zeebe-data-3:/usr/local/zeebe/data
    environment:
      - ZEEBE_BROKER_CLUSTER_NODE_ID=2
      - ZEEBE_BROKER_CLUSTER_PEERS=zeebe-1:26502,zeebe-2:26502,zeebe-3:26502
      - ZEEBE_BROKER_CLUSTER_CLUSTER_SIZE=3
      - ZEEBE_BROKER_CLUSTER_REPLICATION_FACTOR=2
      - ZEEBE_BROKER_NETWORK_HOST=zeebe-3

volumes:
  zeebe-data-1:
  zeebe-data-2:
  zeebe-data-3:

4.3 核心配置参数（环境变量）

Zeebe 通过环境变量配置，常用参数如下：

4.4 数据持久化

Zeebe 依赖持久化存储流程状态、日志及元数据，必须通过 Docker 卷挂载数据目录，避免容器删除/重启后数据丢失。核心挂载路径：

• /usr/local/zeebe/data：存储 RocksDB 数据、索引及操作日志。

五、参考链接

• https://docs.camunda.io/docs/zeebe/latest/
• https://github.com/camunda/camunda
• https://hub.docker.com/r/camunda/zeebe