ASP.NET 4.8的DevOps YML构建部署文件结构异常问题

问题现象 #

使用YAML流水线部署ASP.NET 4.8项目到Azure App Service后，文件结构不符合预期：所有文件被归档到C:\home\site\wwwroot\a路径下，且包含_PublishedWebsites等多余嵌套目录，而非直接将Areas、bin、Views等核心目录部署到wwwroot根目录。

问题原因 #

原流水线中VSBuild@1和AzureWebApp@1的配置未正确设置MSBuild参数，导致发布时生成了不必要的嵌套目录层级，最终归档部署后出现路径错误。

解决方案 #

参考默认ASP.NET经典流水线导出的YAML配置，调整VSBuild@1的MSBuild参数，并修改ArchiveFiles@2的归档根目录，具体步骤如下：

1. 修改VSBuild@1任务配置 #

添加WebPublishMethod=FileSystem指定文件系统发布方式，避免生成_PublishedWebsites嵌套目录；同时通过publishUrl指定临时发布目录，确保输出文件直接放在该目录下：

- task: VSBuild@1
  inputs:
    solution: '**/*.sln'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=FileSystem /p:publishUrl="$(Build.ArtifactStagingDirectory)/WebApp" /p:SkipInvalidConfigurations=true'

2. 调整ArchiveFiles@2任务配置 #

将归档根目录指向临时发布目录，并设置includeRootFolder: false，确保归档时不包含外层目录，直接将文件打包到ZIP根目录：

- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.ArtifactStagingDirectory)/WebApp'
    includeRootFolder: false
    archiveType: 'zip'
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'
    replaceExistingArchive: true

3. 配置AzureWebApp@1任务 #

确保部署时指向正确的归档文件：

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<你的Azure订阅名称>'
    appType: 'webApp'
    appName: '<你的App Service名称>'
    package: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'

完成上述修改后，重新运行流水线，部署后的文件将直接部署到wwwroot根目录，符合预期结构。

内容的提问来源于stack exchange，提问作者Jørgen Thyme