主题
运行历史与取消
两个编号再强调
| 编号 | 范围 | 用途 |
|---|---|---|
| 运行 ID(runId) | 全局自增 | logs / stop / WS / API 路径 |
| 构建号(buildNumber) | 项目或任务内自增 | 日志头部、版本追溯、摘要展示 |
CLI 摘要同时标出两者:运行 ID #88(构建号 #13)。拿不到构建号时退化为只显示运行 ID。 不要拿构建号去调 logs/stop——那是全局接口。
历史查询
bash
deploy runs list # 全部
deploy runs list --project my-app # 按目标 key(任务运行同样把 task key 存于该列)
deploy runs list --status failed --page 2CLI 暂无独立的 --task 过滤 flag;--project 按 project_key 列匹配,项目与任务 key 同名时会混在一起。 API 提供 taskKey 参数精确过滤任务运行(附加 task_id <> 0 条件),见 运行与日志接口。
网页 /runs 列表过滤项:目标关键字、类型(project/task)、状态。 列表含触发者/触发方式、开始时间、耗时、终态;点入详情看日志与步骤明细。
保留期:运行记录随日志保留策略清理(logRetentionDays);删除项目会连带删除其运行历史与日志(更新、归档与删除)。
取消
bash
deploy stop 88 # 幂等:已终态再 stop 不报错- 取消按进程树杀(Linux 进程组 / Windows taskkill),终态
canceled。 - 管道级联:依赖管道中取消任一运行,同时取消该管道中在跑与排队的其他运行。
cancelPrev策略与 CLI--cancel-on-interrupt本质都是调取消接口。- 取消不回收已产生的副作用(已发布的文件、已重启的服务)——发布脚本应幂等或带健康检查回滚。
等待终态的三种姿势
| 场景 | 做法 |
|---|---|
| 人要看的 | deploy run <key> -f |
| 脚本只要结果 | deploy run <key> --wait --json |
| 外部系统 | Hook ?wait=true(上限 30 分钟) |
提交后未等待的响应只是受理(runId + queued);提交超时先 runs list 查是否已受理,避免重复触发。 中断的等待可能退出码 0 而服务端仍在跑:报告成功必须以终态 success 为准。
审计建议
- 发布窗口内保留
runs list --project <key>输出作为变更证据(含触发者与提交哈希 GIT_COMMIT)。 - 失败运行不要删项目「清痕迹」:日志是排查依据;归档即可隐藏。