cnb-rs build

cnb-rs build <subcommand>
cnb-rs run <subcommand>     # alias

管理仓库的 CI/CD 构建流水线。CNB 称该能力为「云原生构建」，对应 gh run。

支持触发构建、停止构建、查询状态、查看日志等操作。构建由 CNB 平台的 CI/CD 引擎驱动，支持多流水线并行执行。

alias

cnb-rs run 是本命令组的 visible_alias，与 gh run 一致。cnb-rs build 与 cnb-rs run 完全等效，选一个习惯即可。

可用命令

与 gh 同名 / 对齐语义的子命令：

• cnb-rs build list — 列出构建记录（alias：ls，对齐 gh run list）
• cnb-rs build status — 查询构建状态（alias：view，对齐 gh run view）
• cnb-rs build stop — 停止构建（alias：cancel，对齐 gh run cancel）
• cnb-rs build rerun — 按 SN 重跑历史构建（对齐 gh run rerun）
• cnb-rs build watch — Polling 状态直到终态（对齐 gh run watch）
• cnb-rs build start — 触发构建（gh 端无同名，语义差异较大）

CNB 云原生构建特有能力（gh 无对应名，不加 alias）：

• cnb-rs build stage — 查看 Stage 详情
• cnb-rs build download-log — 下载 Runner 日志
• cnb-rs build delete-log — 删除构建日志
• cnb-rs build crontab-sync — 同步定时任务

示例

# 触发默认分支构建
$ cnb-rs build start

# 查看构建列表。以下 4 种等效：
$ cnb-rs build list
$ cnb-rs build ls       # 子命令 alias
$ cnb-rs run list       # 命令组 alias
$ cnb-rs run ls         # 两个 alias 同时生效

# 查询构建状态
$ cnb-rs build status cnb-1qa-1i3f5ecau
$ cnb-rs run view cnb-1qa-1i3f5ecau     # gh 风格

# 停止构建
$ cnb-rs build stop cnb-1qa-1i3f5ecau
$ cnb-rs run cancel cnb-1qa-1i3f5ecau   # gh 风格

# 按 SN 重跑一次历史构建
$ cnb-rs build rerun cnb-1qa-1i3f5ecau
$ cnb-rs run rerun cnb-1qa-1i3f5ecau    # gh 风格

# 实时监看构建状态直到终态
$ cnb-rs build watch cnb-1qa-1i3f5ecau
$ cnb-rs run watch cnb-1qa-1i3f5ecau    # gh 风格

与 gh run 对照

能力	gh run	cnb-rs build / run
list (ls)	✓	✓
view	✓	✓ (status 主名)
cancel	✓	✓ (stop 主名)
rerun	✓	✓ (rerun 主名，event 默认重写为 api_trigger)
watch	✓	✓ (watch 主名，polling、不能流式看 job 日志)
download	✓ (artifact)	✗（cnb-rs download-log 是 log 不是 artifact）
delete	✓ (删个 run)	✗（cnb-rs delete-log 是删 log）
start 新构建	✗ (gh actions 手动触发需 web)	✓ (start)
stage 详情	✗	✓
crontab 同步	✗	✓
Runner 日志下载 / 删除	log api 隐式	✓ 专门命令

另请参阅

• cnb-rs
• cnb-rs repo
• gh run 文档 — 对齐参考