如何实现Azure DevOps repo与GitHub repo的自动全分支同步

前置准备 #

• 先在GitHub创建目标空仓库，不要初始化README、.gitignore或许可证文件，避免首次同步出现无关提交冲突。
• 生成GitHub Personal Access Token（PAT）：在GitHub开发者设置里选「Personal access tokens - Tokens (classic)」，生成时勾选完整repo权限，生成后把token值保存好，页面刷新后就看不到了。
• 回到Azure DevOps对应项目，进入「Pipelines - Library」，新建一个变量组，存两个机密变量：
  • GITHUB_USERNAME：值填你的GitHub用户名
  • GITHUB_PAT：值填刚才生成的GitHub PAT，勾选「Keep this value secret」
• 给变量组配置权限，允许你即将创建的同步管道访问。

新建同步管道 #

• 在Azure DevOps Pipelines里新建构建管道，源选择你托管在Azure Repos上的目标项目仓库，选择「Starter pipeline」，清空默认生成的所有yaml内容，替换为以下配置：

# 触发条件：所有分支、所有标签的push操作都会触发同步
trigger:
  branches:
    include:
    - '*'
  tags:
    include:
    - '*'

# 关闭PR触发，不需要在提交PR时跑同步
pr: none

pool:
  vmImage: 'ubuntu-latest'

steps:
- checkout: self
  persistCredentials: true
  fetchDepth: 0 # 关闭浅克隆，拉取全量提交历史，避免同步不全

- script: |
    # 配置GitHub远端地址，带鉴权信息
    git remote add github https://$(GITHUB_USERNAME):$(GITHUB_PAT)@github.com/替换成你的GitHub用户名/替换成你的目标仓库名.git
    # 强制同步所有分支
    git push github --all --force
    # 强制同步所有标签
    git push github --tags --force
  displayName: 'Sync full repo to GitHub'

• 把yaml里的GitHub用户名、仓库名替换成你自己的信息，保存管道的时候可以选择把yaml文件存在仓库根目录，方便后续改配置。

验证&排坑 #

• 第一次跑管道之前，建议先在本地手动验证一次权限：本地仓库同时添加Azure DevOps和GitHub两个远端，手动执行git push github --all和git push github --tags，确认能正常推送后再跑自动管道。
• 这个方案用了--force参数推送，GitHub端的内容会完全和Azure DevOps端保持一致，包括强制推送改写历史、删除分支/标签的操作，都会同步到GitHub，符合完全副本的要求。
• 常见配置失败原因：
  • 没设置fetchDepth: 0，浅克隆导致提交历史不全，推送时报错
  • GitHub PAT权限不足，没给全repo权限，或者PAT过期
  • 触发条件没写'*'匹配所有分支，导致新建分支push后不会触发同步
  • 创建GitHub目标仓库时初始化了README等文件，两端首次提交不匹配，推送时报ref冲突，这种情况先在本地把GitHub初始提交拉下来合并，或者直接删掉GitHub仓库重建空仓库就行。

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