如何用Azure Pipeline YAML实现跨Git仓库文件夹同步

前置配置补全 #

你目前的资源配置缺少固定路径、显式拉取的相关设置，调整后完整配置如下：

resources:
  repositories:
  # 原有源仓库配置，补充两个关键参数
  - repository: SourceRepo
    type: git
    name: MyCollection/SourceRepo
    ref: main # 指定需要同步的源仓库分支
    path: sourceRepo # 固定源仓库的本地拉取路径，避免路径不确定
# 定期同步的调度配置
schedules:
  - cron: "0 0 * * *" # 按需求调整定时规则，此处为每天UTC时间0点执行
    displayName: Daily sync from source repo
    always: true # 即使源分支无变更也按调度执行
    branches:
      include:
      - main # 目标仓库需要推送的分支
trigger: none # 关闭代码提交触发，避免非预期执行

说明：Pipeline默认关联的仓库就是你要写入的目标仓库，不需要额外添加资源配置，其本地拉取路径固定为$(Build.Repository.LocalPath)。

核心执行步骤 #

1. 显式拉取两个仓库到工作区 #

默认情况下Pipeline只会拉取关联的目标仓库，源仓库需要显式执行checkout步骤拉取，否则工作区内找不到源仓库文件。同时要开启凭证持久化，保证后续推送代码的权限：

steps:
# 拉取目标仓库，持久化git凭证
- checkout: self
  clean: true # 每次拉取干净的仓库副本，避免旧文件污染
  persistCredentials: true # 关键：保留git推送所需的临时凭证
# 拉取之前配置的源仓库
- checkout: SourceRepo
  clean: true

完成拉取后两个仓库的固定访问路径：

• 源仓库（文件来源）：$(System.DefaultWorkingDirectory)\sourceRepo
• 目标仓库（写入位置）：$(Build.Repository.LocalPath)

2. 执行文件夹拷贝 #

直接复用你已经掌握的CopyFiles@2任务逻辑，只需要把原来同仓库的源路径替换为跨仓库的源路径即可：

- task: CopyFiles@2
  inputs:
    # 替换为源仓库下需要同步的指定文件夹路径
    SourceFolder: '$(System.DefaultWorkingDirectory)\sourceRepo\MyFolder\'
    Contents: |
      **
      !**\obj\**
      !**\bin\**
    # 保留原来的目标仓库内的存放路径配置
    TargetFolder: '$(Build.Repository.LocalPath)\DestFolder'
    flattenFolders: false
    CleanTargetFolder: true
    OverWrite: true
    preserveTimestamp: true

这里的CleanTargetFolder: true是保证两边内容一致的关键：拷贝前会清空目标路径下的所有旧文件，不会残留源仓库已经删除的冗余文件。

3. 提交并推送变更到目标仓库 #

拷贝操作只会修改Pipeline临时工作区的文件，需要通过git命令把变更推回目标仓库才算完成同步。这一步要增加变更检测，避免无变更时生成空提交：

- task: CmdLine@2
  inputs:
    script: |
      # 进入目标仓库根目录
      cd $(Build.Repository.LocalPath)
      # 配置git提交身份
      git config user.name "Sync Bot"
      git config user.email "syncbot@azuredevops.local"
      # 暂存目标路径下的所有变更
      git add DestFolder/
      # 检测是否存在实际文件变更
      $hasChanges = git status --porcelain
      if (-not $hasChanges) {
          Write-Host "No file changes detected, skip commit"
          exit 0
      }
      # 提交变更
      git commit -m "Sync updated files from SourceRepo/MyFolder, sync time: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
      # 推送到目标仓库的对应分支
      git push origin HEAD:main

常见踩坑点 #

• 权限问题：需要在目标仓库的安全设置中，给项目对应的Build Service账号开通Contribute权限，否则git push会返回403认证失败
• 凭证问题：checkout目标仓库的时候如果没开persistCredentials: true，后续执行git push时会因为没有有效凭证失败
• 路径确认：可以在Pipeline执行的最开始加一行打印工作区路径的命令，确认源仓库的实际拉取位置，避免硬编码路径导致的文件找不到问题
• 一致性问题：要保证CopyFiles里的排除规则和实际需要同步的内容完全匹配，否则会出现多拷、漏拷的情况

内容的提问来源于stack exchange，提问作者Sara Nikta Yousefi