Azure DevOps与GitHub仓库双向同步问题及解决方案咨询

核心思路 #

双向同步需覆盖代码分支和**Pull Requests（PR）**两类资源：分支通过Git原生的推送/拉取实现同步；PR作为平台专属资源，需通过流水线触发脚本在目标平台镜像创建PR（评论、审批状态等暂无法直接同步，需依赖人工或自定义脚本补充）。

前置准备 #

• 在Azure DevOps中创建GitHub服务连接，授权访问目标GitHub仓库
• 生成GitHub个人访问令牌（PAT），权限需包含repo、admin:repo_hook；生成Azure DevOps PAT，权限需包含Code (Full)
• 确保两个仓库初始代码、分支已完全对齐（你已完成初始导入，可跳过此步，但建议再次校验）

一、Azure DevOps → GitHub 同步 #

1. 分支同步流水线（YAML） #

触发条件：Azure DevOps仓库指定分支更新时，自动推送至GitHub对应分支

trigger:
  branches:
    include:
      - main
      - develop
      - feature/*
      - bugfix/*
  paths:
    exclude:
      - README.md # 按需排除无需同步的文件

pool:
  vmImage: 'ubuntu-latest'

steps:
- checkout: self
  fetchDepth: 0 # 拉取全部分支历史，避免推送失败

- script: |
    git remote add github https://$(GitHub-PAT)@github.com/<你的GitHub用户名>/<仓库名>.git
    git fetch github
    # 推送当前触发分支到GitHub
    git push github $(Build.SourceBranchName):$(Build.SourceBranchName)
    # 同步所有标签（可选）
    git push github --tags
  displayName: '同步分支至GitHub'
  env:
    GitHub-PAT: $(GitHub-PAT) # 在Azure DevOps变量组中存储的GitHub PAT

2. PR同步流水线（YAML） #

触发条件：Azure DevOps中创建PR时，自动在GitHub推送源分支并创建对应PR

pr:
  branches:
    include:
      - main
      - develop

pool:
  vmImage: 'ubuntu-latest'

steps:
- checkout: self
  fetchDepth: 0

- script: |
    # 提取PR的源分支和目标分支（移除refs/heads/前缀）
    PR_SOURCE_BRANCH=${System.PullRequest.SourceBranch#refs/heads/}
    PR_TARGET_BRANCH=${System.PullRequest.TargetBranch#refs/heads/}

    # 推送源分支到GitHub
    git remote add github https://$(GitHub-PAT)@github.com/<你的GitHub用户名>/<仓库名>.git
    git push github $PR_SOURCE_BRANCH:$PR_SOURCE_BRANCH

    # 使用GitHub CLI创建PR
    gh auth login --with-token <<< $(GitHub-PAT)
    gh pr create --base $PR_TARGET_BRANCH --head $PR_SOURCE_BRANCH --title "$(System.PullRequest.Title)" --body "$(System.PullRequest.Description)"
  displayName: '同步PR至GitHub'
  env:
    GitHub-PAT: $(GitHub-PAT) # Azure DevOps变量组中的PAT

二、GitHub → Azure DevOps 反向同步 #

1. 分支同步流水线（YAML） #

触发条件：GitHub仓库指定分支更新时，自动推送至Azure DevOps对应分支

resources:
  repositories:
    - repository: githubRepo
      type: github
      endpoint: <你的GitHub服务连接名称>
      name: <你的GitHub用户名>/<仓库名>

trigger:
  branches:
    include:
      - main
      - develop
      - feature/*
      - bugfix/*

pool:
  vmImage: 'ubuntu-latest'

steps:
- checkout: githubRepo
  fetchDepth: 0

- script: |
    git remote add azure https://$(Azure-DevOps-PAT)@dev.azure.com/<你的组织名>/<项目名>/_git/<仓库名>.git
    git fetch azure
    # 推送当前触发分支到Azure DevOps
    git push azure $(Build.SourceBranchName):$(Build.SourceBranchName)
    git push azure --tags
  displayName: '同步分支至Azure DevOps'
  env:
    Azure-DevOps-PAT: $(Azure-DevOps-PAT) # Azure DevOps变量组中的PAT

2. PR同步流水线（YAML） #

触发条件：GitHub创建PR时，通过Webhook触发Azure DevOps流水线，推送源分支并创建对应PR

1. 先在GitHub仓库设置Webhook，指向Azure DevOps流水线的触发URL，触发事件选择Pull requests
2. 流水线代码：

trigger: none # 禁用默认触发，仅通过Webhook触发

resources:
  repositories:
    - repository: githubRepo
      type: github
      endpoint: <你的GitHub服务连接名称>
      name: <你的GitHub用户名>/<仓库名>

pool:
  vmImage: 'ubuntu-latest'

steps:
- checkout: githubRepo
  fetchDepth: 0

- script: |
    # 解析Webhook请求体中的PR信息（需提前安装jq工具）
    PR_TITLE=$(echo $(requestBody) | jq -r '.pull_request.title')
    PR_BODY=$(echo $(requestBody) | jq -r '.pull_request.body')
    PR_SOURCE_BRANCH=$(echo $(requestBody) | jq -r '.pull_request.head.ref')
    PR_TARGET_BRANCH=$(echo $(requestBody) | jq -r '.pull_request.base.ref')

    # 推送源分支到Azure DevOps
    git remote add azure https://$(Azure-DevOps-PAT)@dev.azure.com/<你的组织名>/<项目名>/_git/<仓库名>.git
    git push azure $PR_SOURCE_BRANCH:$PR_SOURCE_BRANCH

    # 使用Azure DevOps CLI创建PR
    az devops login --organization https://dev.azure.com/<你的组织名> --token $(Azure-DevOps-PAT)
    az repos pr create --project <你的项目名> --repository <仓库名> --source-branch $PR_SOURCE_BRANCH --target-branch $PR_TARGET_BRANCH --title "$PR_TITLE" --description "$PR_BODY"
  displayName: '同步GitHub PR至Azure DevOps'
  env:
    Azure-DevOps-PAT: $(Azure-DevOps-PAT) # Azure DevOps变量组中的PAT
    requestBody: $(requestBody) # 启用Webhook传递的请求体变量

关键注意事项 #

• 权限校验：确保两类PAT的权限范围足够，避免同步失败
• 分支规范：两个仓库的分支命名需完全一致，否则会导致同步混乱
• 冲突处理：提前约定代码修改的权威源（如以GitHub为主），冲突时优先保留权威源的代码
• PR同步限制：PR的评论、审批状态无法跨平台直接同步，若需完整同步需自定义扩展脚本

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