sitapati/zbctl

Zeebe命令行界面(CLI)的Docker容器化版本，用于与Zeebe broker交互，执行部署工作流、创建作业实例、管理作业生命周期及查看集群状态等维护任务。

2 收藏0 次下载activesitapati镜像

🚀轩辕镜像专业版更稳定💎一键安装 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_ADDRESS`	Zeebe broker连接地址	`127.0.0.1:26500`
`ZEEBE_CLIENT_ID`	OAuth认证客户端ID	-
`ZEEBE_CLIENT_SECRET`	OAuth认证客户端密钥	-
`ZEEBE_AUTHORIZATION_SERVER_URL`	OAuth授权服务器URL	`[***]`
`ZEEBE_TOKEN_AUDIENCE`	访问令牌目标资源受众	-
`ZEEBE_CA_CERTIFICATE_PATH`	网关请求验证证书路径	-
`ZEEBE_CLIENT_CONFIG_PATH`	OAuth凭证缓存路径	`/Users/sitapati/.camunda/credentials`
`ZEEBE_INSECURE_CONNECTION`	是否使用不安全连接（布尔值）	-

主要命令列表

命令	描述
`activate`	激活资源
`cancel`	取消资源
`complete`	完成资源
`create`	创建资源
`deploy`	部署BPMN/YAML定义的工作流
`fail`	使资源失败
`generate`	生成文档
`help`	查看命令帮助
`publish`	发布消息
`resolve`	解析资源
`set`	设置资源
`status`	检查集群状态
`update`	更新资源
`version`	打印zbctl版本

高级配置示例

本地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可访问本地工作流文件

选项说明

选项	描述	环境变量替代
`--address`	Zeebe broker连接地址	`ZEEBE_ADDRESS`
`--clientId`	OAuth客户端ID	`ZEEBE_CLIENT_ID`
`--clientSecret`	OAuth客户端密钥	`ZEEBE_CLIENT_SECRET`
`--authzUrl`	OAuth授权服务器URL	`ZEEBE_AUTHORIZATION_SERVER_URL`
`--certPath`	证书验证路径	`ZEEBE_CA_CERTIFICATE_PATH`
`--insecure`	使用不安全连接	`ZEEBE_INSECURE_CONNECTION`

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

5

"Docker加速体验非常流畅，大镜像也能快速完成下载。"

常见问题

Q1:轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

Q2:轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

Q3:流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

Q4:410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

Q5:manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

Q6:镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

登录仓库拉取

通过 Docker 登录认证访问私有仓库

Linux

在 Linux 系统配置镜像加速服务

Windows/Mac

在 Docker Desktop 配置镜像加速

Docker Compose

Docker Compose 项目配置加速

K8s Containerd

Kubernetes 集群配置 Containerd

宝塔面板

在宝塔面板一键配置镜像加速

群晖

Synology 群晖 NAS 配置加速

飞牛

飞牛 fnOS 系统配置镜像加速

极空间

极空间 NAS 系统配置加速服务

爱快路由

爱快 iKuai 路由系统配置加速

绿联

绿联 NAS 系统配置镜像加速

威联通

QNAP 威联通 NAS 配置加速

Podman

Podman 容器引擎配置加速

Singularity/Apptainer

HPC 科学计算容器配置加速

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

专属域名拉取

无需登录使用专属域名加速

需要其他帮助？请查看我们的常见问题或官方QQ群: 13763429

zbctl Docker 镜像下载 - 轩辕镜像

zbctl 镜像详细信息和使用指南

zbctl 镜像标签列表和版本信息

zbctl 镜像拉取命令和加速下载

zbctl 镜像使用说明和配置指南

Docker 镜像加速服务 - 轩辕镜像平台

国内开发者首选的 Docker 镜像加速平台

极速拉取 Docker 镜像服务

相关 Docker 镜像推荐

热门 Docker 镜像下载

zbctl 镜像详细信息

zbctl 镜像标签列表

zbctl 镜像使用说明

zbctl 镜像拉取命令

Docker 镜像加速服务

轩辕镜像平台优势

镜像下载指南