Azure CI/CD构建ASP.NET MVC项目：发布Zip路径异常与优化咨询

问题根源 #

1. 路径混乱原因：原VSBuild任务仅设置了OutputPath（编译输出目录），未指定Web发布的PublishDir，导致发布流程默认使用项目本地obj目录的临时路径，混入了代理机器的本地源路径（D_C\a\1\s）。
2. 构建目标错误：使用/t:build目标仅触发编译，Web发布依赖DeployOnBuild的隐式行为，路径控制不稳定。
3. 冗余构建：针对整个解决方案构建，多余的类库项目增加构建时间，且可能干扰Web项目的发布输出。

优化后的管道配置 #

# 定义构建编号格式：年.月.日.自动递增修订号
name: $(Year:yyyy).$(Month).$(DayOfMonth).$(Rev:r)

trigger:
- '*'

pool:
  vmImage: 'windows-latest'

variables:
  buildConfiguration: 'Release'
  # 仅指定需要发布的MVC5 Web项目路径
  webProjectPath: '**/My.Web.csproj'
  # 统一发布输出目录到工件暂存区
  publishDir: '$(Build.ArtifactStagingDirectory)\WebPublish'

steps:
# 安装指定版本的NuGet工具
- task: NuGetToolInstaller@1
  inputs:
    versionSpec: '>=6.0'

# 还原Web项目依赖（如需还原整个解决方案，可将restoreSolution改为**/*.sln）
- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(webProjectPath)'
    feedsToUse: 'select'

# 构建并发布Web项目，输出可直接部署到IIS的文件结构
- task: VSBuild@1
  inputs:
    solution: '$(webProjectPath)'
    msbuildArgs: >
      /t:WebPublish
      /p:Configuration=$(buildConfiguration)
      /p:DeployOnBuild=true
      /p:PublishDir=$(publishDir)
      /p:WebPublishMethod=FileSystem
      /p:DeleteExistingFiles=true
      /p:AutoParameterizationWebConfigConnectionStrings=false
    platform: 'Any CPU'
    configuration: '$(buildConfiguration)'

# 将发布目录打包为带构建编号的Zip包
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(publishDir)'
    includeRootFolder: false
    archiveType: 'zip'
    archiveFile: '$(Build.ArtifactStagingDirectory)\My.Web_$(Build.BuildNumber).zip'
    replaceExistingArchive: true

# 发布最终Zip包作为管道工件
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Build.ArtifactStagingDirectory)\My.Web_$(Build.BuildNumber).zip'
    publishLocation: 'pipeline'
    artifact: 'WebDeployPackage'

关键调整说明 #

• 聚焦单个Web项目：通过webProjectPath变量仅构建目标MVC5项目，排除冗余类库，提升构建效率。
• 精准控制发布路径：
  • 使用/t:WebPublish目标明确触发Web发布流程，替代依赖隐式行为的build目标。
  • PublishDir直接指向管道的ArtifactStagingDirectory，彻底避免代理本地路径混入。
  • WebPublishMethod=FileSystem指定文件系统发布模式，输出的文件结构可直接复制到IIS部署。
  • DeleteExistingFiles=true确保发布目录无残留旧文件，AutoParameterizationWebConfigConnectionStrings=false避免自动修改连接字符串（如需保留默认行为可移除）。
• 可控打包：用ArchiveFiles任务生成带构建编号的Zip包，比VSBuild自动生成的包更灵活，且版本号清晰。

构建编号/版本号配置 #

管道级构建编号 #

YAML开头的name字段定义了版本格式：$(Year:yyyy).$(Month).$(DayOfMonth).$(Rev:r)，例如2024.5.20.1，其中$(Rev:r)会在同一天自动递增。该编号可通过$(Build.BuildNumber)变量在整个管道中引用。

注入到Web项目（可选） #

如果需要将版本号写入项目的AssemblyInfo.cs或Web.config，可在VSBuild任务前添加以下步骤：

1. 更新AssemblyInfo版本号

- task: AssemblyInfoReader@2
  inputs:
    path: '$(webProjectPath)'
    assemblyVersion: '$(Build.BuildNumber)'
    assemblyFileVersion: '$(Build.BuildNumber)'

2. 替换Web.config中的版本占位符

先在Web.config中添加占位符（如{Version}），再添加任务：

- task: ReplaceTokens@4
  inputs:
    rootDirectory: '$(webProjectPath)'
    targetFiles: 'Web.config'
    tokenPrefix: '{'
    tokenSuffix: '}'
    tokens: |
      Version=$(Build.BuildNumber)

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