迁移经典发布管道至YAML管道时ARM模板匹配错误及目录变量咨询

错误原因分析 #

报错Could not find any file matching the template file pattern本质是指定的csmFile路径不存在，核心原因通常是：

• 构建管道未正确将azuredeploy.json打包发布为工件
• 部署作业未下载构建生成的工件，或路径引用错误

三个目录变量的区别 #

直接给结论：优先用Pipeline.Workspace，避免使用System.ArtifactsDirectory，三个变量的详细差异：

• System.DefaultWorkingDirectory：作业的默认工作根目录，构建作业中生成的文件默认存放在这里；但在独立的部署作业中，该目录是空的，需要手动下载工件到这里或Pipeline.Workspace。
• System.ArtifactsDirectory：旧版变量，已被Pipeline.Workspace替代，不推荐在新YAML管道中使用。
• Pipeline.Workspace：Azure DevOps官方推荐的工件存储目录，每个作业拥有独立的Workspace，下载工件任务默认会将工件放到此目录下，路径清晰且隔离性好，适合多阶段管道的构建+部署场景。

修复后的YAML配置示例 #

假设你用的是多阶段管道（构建+部署分离），完整配置如下：

1. 构建阶段：发布ARM模板工件 #

stages:
- stage: Build
  jobs:
  - job: BuildARM
    steps:
    # 这里是你的构建步骤（比如编译、生成文件等）
    # ...
    # 发布包含azuredeploy.json的工件
    - task: PublishPipelineArtifact@1
      inputs:
        targetPath: '$(System.DefaultWorkingDirectory)/deployment'
        artifact: 'arm-templates'
        publishLocation: 'Container'

2. 部署阶段：下载工件并执行部署 #

- stage: Deploy
  jobs:
  - job: DeployARM
    steps:
    # 先下载构建阶段发布的arm-templates工件
    - task: DownloadPipelineArtifact@2
      inputs:
        buildType: 'current' # 如果是引用其他管道的构建，改为'specific'并指定构建ID
        artifactName: 'arm-templates'
        targetPath: '$(Pipeline.Workspace)/arm-templates'
    
    # 执行ARM模板部署，修正路径为下载后的工件路径
    - task: AzureResourceManagerTemplateDeployment@3
      displayName: 'Deploy to ARM Template'
      inputs:
        azureResourceManagerConnection: 'Transportation-SPN'
        subscriptionId: 'c0779592-f81d-4971-8210-11b7eb2b4521'
        resourceGroupName: '$(ResourceGroupName)'
        location: 'West US 2'
        csmFile: '$(Pipeline.Workspace)/arm-templates/azuredeploy.json'
        overrideParameters: '-gcsAppInsightsName $(GcsAppInsightsName) -shouldCreateGCSAppInsights $(ShouldCreateGCSAppInsights)  -azureMapAccountName $(AzureMapAccountName) -cdnContainerName $(CdnContainerName) -azureMapPricingTier $(AzureMapPricingTier) -shouldDeployAzureMap $(ShouldDeployAzureMap) -keyVaultName $(KeyVaultName) -shouldDeployKeyVault $(ShouldDeployKeyVault) -deploymentAgentObjectId $(DeploymentAgentObjectId) -thubEngTeamObjectId $(ThubEngTeamObjectId) -shouldPerformKVRoleAssignments $(shouldPerformKVRoleAssignments) -azureFrontDoorCdnObjectId $(azureFrontDoorCdnObjectId)'
        deploymentOutputs: AzureMapsKey

如果构建和部署在同一个作业 #

如果你的构建和部署是在同一个作业中（没有分阶段），则无需下载工件，直接使用$(System.DefaultWorkingDirectory)/deployment/azuredeploy.json即可，但要确保构建步骤确实生成了该文件。

额外检查项 #

• 确认构建管道的PublishPipelineArtifact任务中，targetPath正确指向包含azuredeploy.json的目录
• 在部署作业中添加目录查看任务，验证文件是否存在：

  - task: Bash@3
    inputs:
      targetType: 'inline'
      script: |
        ls -R $(Pipeline.Workspace)
  

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