flow-resume 是 CocoPlus 工具集中用于恢复已暂停 CocoFlow 流水线的技能。
用途:当 CocoFlow 流水线被暂停后,使用该技能移除暂停标志并继续执行,从下一个待处理阶段或指定的 stage-id 恢复。
主要能力:
- 检查当前目录是否已初始化 CocoPlus(.cocoplus/ 是否存在)。若未初始化,输出提示并停止。
- 检查流水线是否处于暂停状态(.cocoplus/flow.pause 是否存在)。若未暂停,输出提示并停止。
- 支持通过 stage-id 参数从指定阶段恢复,并将之前所有待处理阶段标记为跳过。
- 未提供参数时,从下一个待处理阶段恢复。
- 移除暂停标志文件 .cocoplus/flow.pause。
- 激活 flow-run 技能以开始执行。
- 输出恢复信息,指明从哪个阶段继续。
使用方式:
- 确认当前目录已初始化 CocoPlus(存在 .cocoplus/ 目录)。
- 确认流水线已暂停(存在 .cocoplus/flow.pause 文件)。
- 可选:提供 stage-id 参数以从指定阶段恢复。
- 执行该技能,移除暂停标志并激活 flow-run 技能继续执行。
适用场景:
- 需要从暂停状态继续 CocoFlow 流水线时。
- 需要从特定阶段恢复执行时。
限制与注意事项:
- 若未初始化 CocoPlus,无法使用。
- 若流水线未暂停,无法使用。
- 不应从流水线开头恢复,否则已完成阶段会重复执行,导致交付物重复和阶段状态损坏。
- 仅移除暂停标志而不激活 flow-run 技能会导致流水线卡住,开发者看不到反馈。
- 退出标准:.cocoplus/flow.pause 标志文件不存在;flow-run 技能已激活并从下一个待处理阶段继续执行;输出指明从哪个阶段恢复。