Skip to content

步骤 ID 与选择性执行 ​

位置序号语义 ​

任务步骤的 ID 就是位置序号(1 起):第 1 个步骤 ID=1,第 13 个 ID=13。 task get 的步骤表直接展示该 ID;task run --step-id N 引用它。

update 后不变:步骤内联整体保存,位置即 ID。增删步骤会改变后续位置(这是位置语义的自然结果), 但「修改某步脚本内容」不会移动任何 ID。

与项目命令 ID 的对照 ​

项目命令任务步骤
ID 来源服务端生成位置序号(1 起)
update 后全部重新生成不变(除非增删移动位置)
选择性运行run --command-id <id>task run --step-id N
运行前是否需读 ID必须 project get不需要
单条 CRUD有(命令表)无(steps 整体替换)

自动化脚本里缓存项目命令 ID 是常见错误源:update 一次就全部失效。任务的位置 ID 正是为消除这类失效而设计。

选择性执行示例 ​

bash
deploy task get hula-recon                 # 13 步勘察,ID 1..13
deploy task run hula-recon --step-id 13 -f # 只跑第 13 步(公网连通性检查)
deploy task run hula-recon --step-id 1 --step-id 2 -f   # 跑指定多步

被跳过的步骤记 skipped;运行终态只由实际执行的步骤决定。 enabled: false 的步骤同样跳过。

触发契约 ​

API/Hook 侧 commandIds 字段对任务即步骤位置数组;withDependencies 对任务报 400。 详见 项目与任务接口 与 Hook 接口。

实务建议 ​

  • 把「常单独跑」的步骤放在固定位置(如最后一步做连通性验证),并在步骤名里写明序号。
  • 增删步骤后通知依赖 --step-id 的脚本维护者;位置语义下这是唯一的 ID 变动来源。
  • 需要「稳定引用某一步且频繁增删」时,考虑拆成多个小任务,而不是一个大任务加偏移计算。