GitLab仓库迁移至Azure DevOps：脚本镜像及自动同步方案咨询

一、脚本化镜像迁移完全可行 #

针对带有大量历史提交、分支和标签的仓库，借助Git原生的镜像克隆/推送能力配合脚本，能高效完成迁移，且可保证所有Git refs（分支、标签、提交历史）完整同步。

二、手动镜像迁移脚本示例 #

单个仓库迁移脚本 #

# 替换为你的实际仓库地址
GITLAB_REPO="git@gitlab.com:your-org/target-repo.git"
AZURE_REPO="git@dev.azure.com:your-org/your-project/_git/target-repo"

# 克隆GitLab仓库的完整镜像（包含所有分支、标签、提交历史，裸仓库模式）
git clone --mirror $GITLAB_REPO temp-mirror-repo
cd temp-mirror-repo

# 将镜像完整推送到Azure DevOps
git push --mirror $AZURE_REPO

# 清理临时目录
cd ..
rm -rf temp-mirror-repo

• --mirror 参数是核心：它会克隆仓库的所有 refs（包括分支、标签、隐藏的refs），并以裸仓库模式存储，确保迁移的完整性。
• git push --mirror 会将所有本地 refs 同步到远程，覆盖Azure端对应 refs（首次迁移前确保Azure仓库为空，或已做好备份）。

批量仓库迁移脚本 #

如果需要迁移多个仓库，可以将仓库列表写入文本文件，用循环批量处理：

# 仓库列表文件：每行格式为「GitLab仓库地址,Azure DevOps仓库地址」
REPO_LIST="./repo-list.txt"

# 循环处理每个仓库
while IFS=, read -r gitlab_repo azure_repo; do
    echo "=== 开始迁移: $gitlab_repo ==="
    git clone --mirror "$gitlab_repo" temp-mirror
    cd temp-mirror
    git push --mirror "$azure_repo"
    cd ..
    rm -rf temp-mirror
    echo "=== 迁移完成: $gitlab_repo ==="
done < "$REPO_LIST"

repo-list.txt 示例内容：

git@gitlab.com:your-org/repo1.git,git@dev.azure.com:your-org/proj/_git/repo1
git@gitlab.com:your-org/repo2.git,git@dev.azure.com:your-org/proj/_git/repo2

三、自动同步机制设置 #

迁移完成后，可通过定时任务实现GitLab到Azure DevOps的单向自动同步，确保两边仓库状态一致。

方案1：GitLab CI/CD定时同步 #

在GitLab仓库的根目录创建 .gitlab-ci.yml，添加定时同步任务：

sync-to-azure:
  script:
    # 添加Azure仓库作为远程
    - git remote add azure $AZURE_REPO_URL
    # 拉取GitLab最新变更并清理过时refs
    - git fetch origin --prune
    # 同步所有refs到Azure
    - git push azure --mirror
  only:
    # 仅在定时计划触发时执行
    - schedules
  tags:
    # 指定可用的GitRunner标签（根据你的Runner配置调整）
    - docker

然后在GitLab仓库的「Settings → CI/CD → Schedules」中添加定时计划（比如每天凌晨1点执行），并在Runner中配置Azure DevOps的访问凭证（推荐用SSH密钥或PAT）。

方案2：Azure DevOps Pipeline定时拉取同步 #

在Azure DevOps中创建一个定时Pipeline，通过拉取GitLab镜像完成同步：

# 关闭自动触发，仅定时执行
trigger: none

# 定时计划：每天凌晨2点同步
schedules:
- cron: "0 2 * * *"
  displayName: 每日同步GitLab仓库
  branches:
    include:
    - main
  always: true

# 使用Ubuntu虚拟机执行任务
pool:
  vmImage: 'ubuntu-latest'

steps:
- bash: |
    # 克隆GitLab镜像仓库
    git clone --mirror $GITLAB_REPO_URL temp-mirror
    cd temp-mirror
    # 推送到当前Azure仓库
    git push --mirror $(Build.Repository.LocalPath)/../
  env:
    # 替换为你的GitLab仓库地址
    GITLAB_REPO_URL: "git@gitlab.com:your-org/target-repo.git"

需在Pipeline的「Library → Variables」中配置GitLab的访问凭证，或通过服务连接配置SSH密钥。

四、关键注意事项 #

• 权限配置：执行同步的账号需同时拥有GitLab仓库的读权限和Azure DevOps仓库的写权限，推荐使用个人访问令牌（PAT）或SSH密钥，避免明文密码。
• 冲突避免：迁移完成后，建议将Azure DevOps仓库设置为只读（仅允许同步任务推送），防止手动提交导致同步冲突。若必须允许Azure端提交，需修改脚本增加合并逻辑，但会增加复杂度。
• 大仓库优化：针对超大型仓库，可设置Git压缩参数 git config --global core.compression 9 减少传输体积，--mirror已默认是裸仓库，无需额外添加--no-checkout。

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