Azure Pipeline推送Azure主仓库至GitHub主仓库失败问题排查

核心错误原因 #

1. 本地无main分支：Azure Pipeline默认checkout: self会以分离HEAD模式检出触发提交，而非本地main分支，导致git checkout main报错。
2. 同步逻辑倒置：你的脚本先将本地代码重置为GitHub仓库的版本，再尝试推送，与「把Azure代码推送到GitHub」的目标完全相反。
3. 推送时无本地分支：重置到GitHub的main后，仍处于分离HEAD状态，没有本地main分支，因此git push repoGithub main会提示src refspec main does not match any。

修复后的Pipeline配置 #

trigger:
- main

pool:
  vmImage: ubuntu-latest

name: Keep clone up to date

variables:
  REMOTE_ADDR: 'XXXXXXXXXXXXXXXXXXXXXX' # 格式需为带PAT的GitHub地址：https://<PAT>@github.com/xxx/xxx.git

stages:
  - stage: sync_to_github
    displayName: Sync Azure Repos to GitHub
    jobs:
      - job: sync_job
        displayName: Perform sync
        continueOnError: false
        steps:
          - checkout: self
            clean: true
            persistCredentials: true
            fetchDepth: 0 # 拉取完整仓库历史与分支，确保能创建本地main分支
            displayName: Checkout Azure Repos main branch
          - bash: | 
              # 基于远程origin/main创建并切换到本地main分支
              git checkout -b main origin/main
              # 添加GitHub作为远程仓库
              git remote add repoGithub $(REMOTE_ADDR)
              # 拉取GitHub分支（处理跨仓库历史无关的情况）
              git pull repoGithub main --allow-unrelated-histories
              # 推送到GitHub main分支（-f为强制覆盖，按需使用）
              git push -f repoGithub main
            displayName: Sync code to GitHub

关键修正点 #

• fetchDepth: 0：拉取完整仓库数据，确保能基于Azure仓库的远程main分支创建本地分支。
• git checkout -b main origin/main：显式创建本地main分支，解决分离HEAD导致的分支不存在问题。
• 修正同步逻辑：先基于Azure代码创建本地分支，再处理与GitHub的合并（或直接覆盖），符合业务目标。
• --allow-unrelated-histories：针对Azure与GitHub仓库历史完全独立的场景，允许拉取合并操作。

可选简化（强制覆盖GitHub内容） #

如果不需要合并GitHub现有内容，直接用Azure代码覆盖，可简化bash脚本：

git checkout -b main origin/main
git remote add repoGithub $(REMOTE_ADDR)
git push -f repoGithub main

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