sitapati/zbctl Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

zbctl Docker镜像文档

镜像概述和主要用途

zbctl是Zeebe的命令行界面(CLI)工具，用于与Zeebe broker交互执行各类维护任务。本Docker镜像提供容器化版本，无需通过NPM安装即可使用，适用于CI环境、本地开发或快速访问zbctl的场景。

核心功能和特性

• 工作流部署：通过BPMN或YAML文件部署工作流至Zeebe broker
• 工作流实例管理：创建、取消工作流实例
• 作业生命周期管理：激活、完成、失败作业
• 变量与重试管理：更新作业变量和重试次数
• 集群监控：查看Zeebe集群当前状态
• 消息操作：向Zeebe broker发布消息
• 文档生成：生成zbctl相关文档

使用场景和适用范围

• CI/CD环境：自动化流程中与Zeebe集群交互（如部署工作流）
• 本地开发测试：无需安装NPM环境，快速验证Zeebe功能
• 集群日常维护：执行工作流部署、作业管理、状态监控等常规任务

使用方法和配置说明

基础使用语法

bash
docker run [选项] sitapati/zbctl [zbctl选项] [命令]

Docker运行示例（Camunda Cloud集群）

从Camunda Cloud控制台获取环境变量后，执行集群状态检查：

bash
docker run  --env ZEEBE_ADDRESS=$ZEEBE_ADDRESS \
  --env ZEEBE_CLIENT_ID=$ZEEBE_CLIENT_ID \
  --env ZEEBE_CLIENT_SECRET=$ZEEBE_CLIENT_SECRET \
  --env ZEEBE_AUTHORIZATION_SERVER_URL=$ZEEBE_AUTHORIZATION_SERVER_URL \
  sitapati/zbctl status

环境变量配置

主要命令列表

高级配置示例

本地Zeebe集群状态检查

bash
docker run --network=host sitapati/zbctl status

--network=host使容器使用主机网络，直接访问本地Zeebe broker（默认地址127.0.0.1:26500）

部署本地工作流文件

bash
docker run -v $(pwd):/workflows \
  --env ZEEBE_ADDRESS=$ZEEBE_ADDRESS \
  --env ZEEBE_CLIENT_ID=$ZEEBE_CLIENT_ID \
  --env ZEEBE_CLIENT_SECRET=$ZEEBE_CLIENT_SECRET \
  --env ZEEBE_AUTHORIZATION_SERVER_URL=$ZEEBE_AUTHORIZATION_SERVER_URL \
  sitapati/zbctl deploy /workflows/workflow.bpmn

-v $(pwd):/workflows将当前目录挂载至容器，使zbctl可访问本地工作流文件

选项说明