主题
步骤 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 变动来源。 - 需要「稳定引用某一步且频繁增删」时,考虑拆成多个小任务,而不是一个大任务加偏移计算。