GitLab自定义组级项目模板：如何向衍生仓库同步变更？

以下是几种实用的落地方案，可根据团队协作模式和变更场景选择：

1. Git上游远程分支同步 #

给每个从模板创建的仓库添加模板仓库作为上游远程：

git remote add upstream <模板仓库的Git地址>

后续需要同步变更时，执行以下命令拉取并合并模板的最新内容：

git fetch upstream
git merge upstream/main  # 将main替换为模板仓库的默认分支名

若想自动化这个流程，可在派生仓库的.gitlab-ci.yml中添加定时流水线，自动执行拉取、合并和推送操作（注意：代码冲突需要手动介入处理，建议在流水线中加入冲突检测逻辑，触发冲突时及时通知负责人）。

2. 自动化批量创建合并请求 #

通过GitLab API结合脚本，实现模板变更后自动给所有派生仓库发起合并请求：

• 编写Shell/Python脚本，遍历组内所有从模板派生的仓库
• 检测模板仓库的最新提交记录，若有更新则调用GitLab API为每个派生仓库创建合并请求
• 将该脚本集成到模板仓库的CI/CD流水线中，每次模板有新提交时自动触发执行

3. 抽离公共部分为可复用组件 #

CI/CD配置复用 #

把.gitlab-ci.yml中的公共逻辑抽离成GitLab CI/CD模板（组级或项目级），在派生仓库的CI配置中通过include引用：

# 派生仓库的.gitlab-ci.yml
include:
  - project: '你的组/模板仓库'
    ref: main
    file: '/templates/common-ci.yml'

后续模板中的公共CI配置更新后，所有派生仓库会自动加载最新版本。

应用骨架公共部分复用 #

将应用程序中的公共依赖、配置文件等抽离为独立仓库，通过Git子模块或包管理工具（如npm、pip）引入到派生仓库：

• 使用Git子模块：git submodule add <公共组件仓库地址> src/common，更新时执行git submodule update --remote
• 使用包管理：将公共组件发布为私有包，派生仓库通过依赖声明引入，更新时只需升级包版本即可

4. 组级CI/CD配置强制同步 #

如果需要强制同步CI/CD配置，可在GitLab组级别设置组CI/CD模板，让组内所有仓库默认继承该模板。或者在派生仓库的CI配置中强制引入组级模板，这样组级模板更新后，所有派生仓库的CI流程会自动同步变更。

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