如何在Azure DevOps流水线中实现从Azure Repo到本地VM的文件拷贝？

前置准备 #

• 本地SQL Server虚拟机必须能被Azure DevOps访问：最直接的方式是在虚拟机上安装自托管代理，或者通过VPN/ExpressRoute打通虚拟机与Azure DevOps的网络（优先推荐自托管代理，配置更简单）
• 给自托管代理分配足够权限：要能读取目标Azure Repo，同时拥有SQL Server虚拟机目标路径的读写权限（比如本地管理员权限，或目标文件夹的专属读写权限）
• 理清Azure Repo里的文件结构，明确要复制的文件范围

流水线配置步骤 #

步骤1：创建基础流水线 #

• 登录Azure DevOps项目，进入「流水线」页面，点击「新建流水线」
• 选择「Azure Repos Git」作为源代码源，选中对应的仓库和分支

步骤2：确认获取源代码任务 #

• 流水线默认会自动添加「获取源代码」任务，检查任务设置里的仓库、分支是否正确，确保能拉取到需要的文件
• 如果只需要复制特定文件夹，可在任务的「路径映射」中配置，比如仅拉取/src/sql-scripts/下的文件

步骤3：添加文件复制逻辑（两种可选方式） #

方式一：用内置「复制文件」任务

• 在流水线中搜索并添加「Copy Files」任务
• 配置参数：
  • 源文件夹：填写Azure Repo拉取到代理机器后的路径，比如$(Build.SourcesDirectory)/src/sql
  • 目标文件夹：填写SQL Server虚拟机上的本地路径，比如D:\SQL\Scripts\（因为用的是自托管代理，直接填本地路径即可）
  • 匹配模式：可选，指定要复制的文件类型，比如*.sql、*.bak

方式二：用PowerShell脚本灵活控制

• 添加「PowerShell」任务，选择「内联脚本」
• 示例脚本：

# 源路径：Azure Repo拉取到代理机器的目录
$sourceDir = "$(Build.SourcesDirectory)/src/sql"
# 目标路径：SQL Server本地指定路径
$targetDir = "D:\SQL\Scripts\"

# 先创建目标目录（如果不存在）
if (-not (Test-Path -Path $targetDir)) {
    New-Item -ItemType Directory -Path $targetDir | Out-Null
}

# 复制所有文件及子文件夹，覆盖已有文件
Copy-Item -Path "$sourceDir\*" -Destination $targetDir -Recurse -Force

步骤4：配置触发规则（可选） #

• 自动触发：在流水线「触发器」页面设置，比如指定分支有代码提交时自动运行
• 手动触发：按需手动启动流水线即可

注意事项 #

• 自托管代理要保持在线，否则流水线无法执行
• 务必确认目标路径的权限，避免因权限不足导致复制失败
• 复制大文件时，注意检查网络带宽，必要时分批次复制
• 跨网络场景下，可以先添加「发布构建工件」任务将文件上传到Azure DevOps工件库，再从工件库复制到虚拟机，提升稳定性

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