主题
运行生命周期与并发
状态机
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;健康检查步骤单独设短超时,避免卡死整次运行。