先找出重复的范围。复合操作封装同一作业中的步骤,可复用工作流则可以共享包含多个作业的流程。

保留调用方的后续步骤


例如,两个作业都安装工具并配置缓存,之后却运行不同测试。可以将安装和配置封装为复合操作,各调用方仍在同一作业内运行自己的测试。如果团队连独立的构建和测试作业都要共享,就使用可复用工作流,并在作业层调用。

先迁移一个调用方


记下旧流程的输入、输出和失败提示。迁移一个调用方后,对照新旧运行。确认成功时仍有预期输出,故意失败的测试也会使对应作业失败。对照通过后再迁移其他调用方。

先写下调用方必须掌控的内容。如果它要在初始化之后追加步骤,并沿用同一工作目录,就保留调用方的作业,从其中一个步骤调用复合操作。如果共享流程需要选择运行器、运行多个作业,或向审核者分别展示各项作业,就用可复用工作流表达这些边界。

迁移测试可先选一个仓库,分别跑已知成功和故意失败的案例。比较审核者看到的作业名称、日志是否仍能找到,以及下游作业是否收到所需输出。跨仓库调用可复用工作流时也要核对检出的仓库:GitHub 说明被调用工作流里的 checkout 默认检出调用方。推广时可先固定到一个稳定版本,避免共享定义改动后所有调用方意外一起变化。

https://docs.github.com/en/actions/concepts/workflows-and-actions/reusing-workflow-configurations