Skip to content

运行生命周期与并发 ​

状态机 ​

text
queued ──> running ──> success
                    ├─> failed     (命令退出码非 0 且 abort)
                    ├─> timeout    (整体或命令超时)
                    ├─> error      (引擎/准备阶段错误)
                    └─> canceled   (stop / cancelPrev / 管道级联)
状态含义CLI 退出码
queued已入队未执行—(未终态)
running执行中—(未终态)
success全部生效命令成功0
failed命令失败(abort 策略)1
timeout超时被杀1
error引擎错误(如 Git 准备失败、工作目录非法)1
canceled被取消1

阶段与步骤状态 ​

运行分两个阶段:prepare(Git 准备,未启用记 skipped)与 command(逐命令/步骤)。 步骤状态:pending / running / skipped / 终态。选择性运行时未选中的步骤记 skipped。

并发策略 ​

项目/任务级 concurrency:

值语义
queue同目标串行排队(默认)
allow同目标允许并行
cancelPrev新运行先取消同目标在跑/排队运行

全局另有闸门 maxConcurrentRuns(默认 5):跨目标的总并行上限,系统设置可热调。 队列中的运行仍占运行记录;queued 时间过长时检查闸门与同目标策略。

超时 ​

  • 项目/任务 timeoutSec:整次运行 deadline,0 不限时。
  • 命令/步骤 timeoutSec:单步覆盖。
  • Git 准备单独超时 gitPrepareTimeoutSec(默认 600s)。
  • 超时按进程树杀:Linux 进程组信号、Windows taskkill /T /F。

触发方式 ​

TRIGGER_TYPE 记录来源:web / api / cli / hook / rerun(网页详情页「重新执行」)。 TRIGGER_BY 记录触发者用户名或 hook 令牌标识。

依赖管道 ​

--with-dependencies 时一次触发产生多条 Run(依赖 + 目标),拓扑序串行、去重、失败阻断、取消级联。 详见 依赖构建。

实务建议 ​

  • 发布类项目用 queue 防并发互踩;勘察类任务可用 allow。
  • cancelPrev 适合「只关心最新一次」的持续集成场景,但会丢弃在跑构建的产物半成品,发布脚本需幂等。
  • 长构建给足 timeoutSec;健康检查步骤单独设短超时,避免卡死整次运行。