Skip to content

运行历史与取消 ​

两个编号再强调 ​

编号范围用途
运行 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 2

CLI 暂无独立的 --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)。
  • 失败运行不要删项目「清痕迹」:日志是排查依据;归档即可隐藏。