Azure Release Pipeline CopyFiles任务无法复制Artifact文件排查

核心原因 #

你当前配置缺失Artifact拉取步骤：Deployment group job的任务运行在目标业务服务器上，和构建/发布阶段的Agent文件系统完全隔离，默认不会自动把构建产出的zip包同步到目标服务器，你配置再多CopyFiles的内容匹配规则，也会因为源路径下根本不存在对应文件导致复制0个文件，和zip匹配规则配置无关。

两种部署逻辑的正确配置流程 #

方案1：先解压再复制到服务目录（推荐，流程更简洁） #

• 第一步（你已配置）：通过PowerShell任务停止目标服务器上的Windows服务，确保部署目录文件不被占用
• 第二步（缺失，必须新增）：添加Download Pipeline Artifact（旧版本Azure DevOps对应为Download Build Artifacts）任务，配置如下：
  • 选择要下载的对应构建产出Artifact
  • 下载到目标服务器的本地临时路径，示例值：$(System.DefaultWorkingDirectory)\deploy_temp
• 第三步（新增）：添加Extract Files解压任务，配置如下：
  • 压缩包路径：$(System.DefaultWorkingDirectory)\deploy_temp\**\*.zip
  • 解压目标路径：$(System.DefaultWorkingDirectory)\extracted_files
  • 勾选「解压前清空目标目录」避免旧文件干扰
• 第四步（调整原有CopyFiles任务）：
  • 源文件夹（Source Folder）：$(System.DefaultWorkingDirectory)\extracted_files
  • 内容匹配（Contents）：**（匹配所有解压后的文件及子目录）
  • 目标文件夹（Target Folder）：Windows服务对应的实际部署目录，示例：D:\Services\YourApp
  • 可选勾选「清空目标目录」，避免旧版本文件残留
• 最后可新增PowerShell步骤重启Windows服务完成部署

方案2：先复制zip到目标服务器再本地解压 #

• 第一步（已配置）：PowerShell停止Windows服务
• 第二步（缺失，必须新增）：添加Download Pipeline Artifact任务，将zip包下载到目标服务器本地临时目录，路径示例：$(System.DefaultWorkingDirectory)\deploy_temp
• 第三步（调整原有CopyFiles任务）：
  • 源文件夹：$(System.DefaultWorkingDirectory)\deploy_temp
  • 内容匹配：**/*.zip
  • 目标文件夹：目标服务器本地临时存放路径，示例：D:\deploy_cache
• 第四步（新增）：通过Extract Files任务或者PowerShell的Expand-Archive命令，将本地临时路径下的zip包解压到Windows服务部署目录
• 最后新增PowerShell步骤重启服务

配置参考 #

你的当前流水线配置截图如下：

排查技巧 #

如果调整配置后仍存在复制异常，可在流水线变量中新增system.debug = true开启调试日志，运行后查看CopyFiles任务的扫描日志，确认任务实际扫描的源路径下存在的文件列表，快速定位路径拼写错误、权限不足等问题。

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