GitHub与Azure同步方法及常见同步报错排查方案咨询

低门槛标准同步流程（无需精通YAML或Azure运维经验） #

• 前置准备：在Azure DevOps目标项目下创建空代码仓库，不要初始化README、.gitignore、许可证等任何文件，避免首次同步出现分支基线冲突
• 凭据准备：分别生成两个最小权限的个人访问令牌（PAT）：GitHub侧勾选完整repo权限，Azure DevOps侧勾选代码读写、管道执行权限，记录两个令牌值备用
• 管道创建：进入Azure Pipelines新建流水线，选择经典编辑器创建空流水线，代理池选择默认windows-2022托管代理即可，无需手写YAML配置
• 任务配置：在流水线中依次添加3个命令行任务，按顺序执行以下操作，替换命令中占位的组织名、仓库名、PAT值即可：
  • 第一个任务执行系统、Git基础配置：

    New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
    git config --global core.longpaths true
    git config --global user.name "Sync Service"
    git config --global user.email "sync@dev.local"
    

  • 第二个任务拉取GitHub源仓库代码：

    git clone --mirror https://<替换为你的GitHub PAT>@github.com/<替换为GitHub用户名>/<替换为源仓库名>.git copyrepo
    

  • 第三个任务推送代码到Azure目标仓库：

    cd copyrepo
    git push --mirror https://<替换为你的Azure PAT>@dev.azure.com/<替换为Azure组织名>/<替换为Azure项目名>/_git/<替换为Azure目标仓库名>
    

• 后续自动同步配置：如果需要持续单向同步，可给流水线配置定时触发规则，或配置GitHub webhook在代码推送时触发流水线即可。

三类常见报错针对性修复 #

1. 路径不存在报错：Cannot find path 'D:\a\1\s\copyrepo~' because it does not exist #

• 根因：脚本中配置的临时克隆路径与后续操作进入的路径不一致，存在多余特殊字符、相对路径引用错误
• 修复：统一使用固定相对路径copyrepo作为临时克隆目录，不要给路径加波浪号、特殊后缀或硬编码绝对路径，克隆完成后可执行dir命令确认目录存在再执行后续操作

2. 仓库拉取失败报错：remote: Not Found fatal: repository 'https://github.com/***/' not found ##[warning]Git fetch failed with exit code 128, back off 5.443 seconds before retry #

• 根因：两类问题会触发该报错：一是GitHub PAT权限不足、已过期，或PAT拼接到仓库地址时格式错误；二是私有仓库拉取时触发GitHub临时限流
• 修复：重新生成勾选完整repo权限的GitHub PAT，拼接地址时严格遵循https://<PAT>@github.com/用户名/仓库名.git格式，不要将PAT放在URL路径末尾；如果是限流触发，给拉取任务配置最多2次重试、每次重试间隔10秒即可正常拉取

3. 长文件名报错：error: unable to create file Filename too long #

• 根因：Windows系统默认限制文件路径总长度不超过260字符，新建测试仓库文件层级浅、路径短不会触发该限制，存量运营很久的GitHub仓库嵌套层级深、文件名长，克隆时就会触发报错
• 修复：必须同时开启系统层面和Git层面的长路径支持，也就是在所有Git操作前执行前文流程里提到的注册表长路径开启命令、Git长路径配置命令，执行后再做克隆、推送操作即可正常同步存量老仓库的所有文件，不会再触发长文件名报错。

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