GitLab中如何让镜像仓库使用子模块的镜像地址？

针对你遇到的镜像仓库子模块仍指向原GitLab实例地址的问题，以下是几种借助GitLab生态或Git原生功能的简便解决方案：

方法一：用GitLab CI/CD自动替换子模块地址 #

适合无需服务器权限、仅针对单个项目的场景，前提是所有子模块已同步到目标GitLab实例：

1. 在目标镜像仓库中创建.gitlab-ci.yml文件，添加如下流水线配置：

   update_submodule_urls:
     stage: deploy
     trigger:
       - push
     script:
       # 替换原GitLab实例地址为目标实例地址
       sed -i 's/https:\/\/old-gitlab.example.com/https:\/\/new-gitlab.example.com/g' .gitmodules
       # 配置CI提交身份
       git config user.name "GitLab CI Runner"
       git config user.email "ci-runner@your-domain.com"
       # 提交修改
       git add .gitmodules
       git commit -m "Update submodule URLs to target GitLab instance"
       git push origin $CI_COMMIT_BRANCH
     only:
       - main # 按需调整分支
   

2. 确保GitLab CI/CD runner拥有仓库的推送权限（可在项目设置的「CI/CD」→「权限」中开启）

方法二：Git服务器全局地址替换 #

适合需要批量处理多个项目、拥有目标GitLab实例服务器管理员权限的场景：

1. 登录目标GitLab服务器，编辑Git全局配置文件（通常为/etc/gitconfig或GitLab运行用户的~/.gitconfig）
2. 添加地址替换规则，将原实例地址映射到目标实例：

   [url "https://new-gitlab.example.com/"]
     insteadOf = https://old-gitlab.example.com/
   

3. 保存配置后，所有从该GitLab实例克隆的仓库，在拉取子模块时会自动替换地址，无需修改仓库内容

方法三：改用相对路径配置子模块 #

适合原仓库与镜像仓库路径结构完全一致的场景（如原地址old.gitlab.com/group/sub.git，镜像地址new.gitlab.com/group/sub.git）：

1. 在原仓库中修改.gitmodules文件，将子模块的url字段改为相对路径：

   [submodule "sub-project"]
     path = sub-project
     url = ../sub-project.git
   

2. 提交修改后重新触发镜像同步，目标仓库的子模块会自动适配当前实例的地址，无需额外配置

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