Admin仓库模板场景下：Reusable Workflows与Git Submodules选型建议

一、各自适用场景 #

Reusable Workflows #

• 仅需复用GitHub Actions工作流（admin_workflow.yml）的场景，它是GitHub官方专为工作流复用设计的方案
• 希望工作流版本可控，通过指定commit、tag或分支引用，无需将工作流文件同步到Provisioned仓库
• 不需要把config.yml这类静态配置文件引入到Provisioned仓库的情况
• 追求轻量化，不想增加仓库的子模块依赖复杂度

Git Submodules #

• 需要同时复用**工作流文件和静态配置文件（config.yml）**的场景，子模块可以将Admin仓库的指定版本资源整体或部分引入
• 希望Provisioned仓库中能直接查看甚至按需编辑复用的文件，或者本地开发时需要离线访问这些资源
• 团队已有成熟的子模块管理流程，成员熟悉Git Submodules的操作逻辑

二、方案选型建议 #

结合你需要复用指定commit版本的admin_workflow.yml和config.yml、且通过Backstage作为模板的需求，优先选择Git Submodules，原因如下：

1. 能同时覆盖两类文件的复用需求，Reusable Workflows仅支持工作流复用，config.yml还需额外处理（比如手动复制、用Action拉取），子模块可一步到位
2. 可直接在子模块配置中固定commit哈希，确保Provisioned仓库始终使用Admin仓库的特定版本资源，版本控制更可靠
3. Backstage模板继承子模块结构后，后续Provisioned仓库的维护逻辑更统一

如果你的需求仅聚焦在工作流复用，config.yml无需同步到Provisioned仓库（比如通过其他加载方式获取），那Reusable Workflows更轻量——它不需要修改仓库目录结构，仅需在Provisioned的工作流文件中用uses引用即可。

内容的提问来源于stack exchange，提问作者Developer