在YAML管道中构建多应用.NET Framework VS解决方案的最佳实践

核心思路：直接构建整个解决方案只会默认处理Web项目的发布，要给每个需要独立交付的应用单独执行发布步骤，同时复用已编译的核心项目输出，避免重复编译浪费时间。

1. 先编译整个解决方案 #

用VSBuild@1一次性编译所有项目，包括.Core和各个应用项目，统一输出到指定目录，后续发布步骤直接用这些编译好的文件：

- task: VSBuild@1
  displayName: '编译整个解决方案'
  inputs:
    solution: '**/*.sln'
    msbuildArgs: '/p:Configuration=$(BuildConfiguration) /p:Platform=$(BuildPlatform) /p:DeployOnBuild=false /p:OutDir=$(Build.BinariesDirectory)'
    platform: '$(BuildPlatform)'
    configuration: '$(BuildConfiguration)'

重点是/p:DeployOnBuild=false，只做编译不自动发布；OutDir指定统一的编译输出目录，方便后续步骤引用。

2. 为每个应用单独执行发布 #

针对Web应用、控制台应用、Windows服务，分别用VSBuild@1执行发布，指定各自的项目文件和独立的输出目录：

2.1 发布Web应用 #

Web项目用打包方式发布，输出到工件暂存目录的WebApp子文件夹：

- task: VSBuild@1
  displayName: '发布Web应用'
  inputs:
    solution: '**/YourWebProject.csproj'
    msbuildArgs: '/p:Configuration=$(BuildConfiguration) /p:Platform=$(BuildPlatform) /p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation=$(Build.ArtifactStagingDirectory)/WebApp'
    platform: '$(BuildPlatform)'
    configuration: '$(BuildConfiguration)'

2.2 发布控制台应用 #

控制台应用直接发布文件到独立目录：

- task: VSBuild@1
  displayName: '发布控制台应用'
  inputs:
    solution: '**/YourConsoleProject.csproj'
    msbuildArgs: '/p:Configuration=$(BuildConfiguration) /p:Platform=$(BuildPlatform) /p:DeployOnBuild=true /p:PublishDir=$(Build.ArtifactStagingDirectory)/ConsoleApp /p:OutputPath=$(Build.BinariesDirectory)/ConsoleApp'
    platform: '$(BuildPlatform)'
    configuration: '$(BuildConfiguration)'

2.3 发布Windows服务 #

Windows服务的发布逻辑和控制台一致，指定独立的输出目录即可：

- task: VSBuild@1
  displayName: '发布Windows服务'
  inputs:
    solution: '**/YourWindowsServiceProject.csproj'
    msbuildArgs: '/p:Configuration=$(BuildConfiguration) /p:Platform=$(BuildPlatform) /p:DeployOnBuild=true /p:PublishDir=$(Build.ArtifactStagingDirectory)/WindowsService /p:OutputPath=$(Build.BinariesDirectory)/WindowsService'
    platform: '$(BuildPlatform)'
    configuration: '$(BuildConfiguration)'

3. 发布独立工件 #

把每个应用的发布结果单独打包成Azure DevOps工件，方便后续部署时按需取用：

3.1 单独发布每个工件 #

逐个发布，清晰明了：

- task: PublishBuildArtifacts@1
  displayName: '发布Web应用工件'
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)/WebApp'
    ArtifactName: 'WebApp'
    publishLocation: 'Container'

- task: PublishBuildArtifacts@1
  displayName: '发布控制台应用工件'
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)/ConsoleApp'
    ArtifactName: 'ConsoleApp'
    publishLocation: 'Container'

- task: PublishBuildArtifacts@1
  displayName: '发布Windows服务工件'
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)/WindowsService'
    ArtifactName: 'WindowsService'
    publishLocation: 'Container'

3.2 批量发布（适合应用数量多的场景） #

用PowerShell遍历工件暂存目录下的子文件夹，自动发布所有应用工件：

- task: PowerShell@2
  displayName: '批量发布所有应用工件'
  inputs:
    targetType: 'inline'
    script: |
      $artifactsDir = "$(Build.ArtifactStagingDirectory)"
      Get-ChildItem -Path $artifactsDir -Directory | ForEach-Object {
          $artifactName = $_.Name
          $publishPath = $_.FullName
          Write-Host "发布工件: $artifactName 路径: $publishPath"
          Publish-BuildArtifact -Name $artifactName -Path $publishPath -Container
      }

关键注意事项 #

• 复用编译输出：先整体编译解决方案，避免每个发布步骤重复编译.Core项目，提升流水线效率。
• 目录隔离：每个应用的发布输出必须放到独立子文件夹，防止不同应用的文件互相覆盖。
• 统一变量：用$(BuildConfiguration)和$(BuildPlatform)这类内置变量，保持不同环境的配置一致性。
• 适配项目类型：Web项目用打包参数生成部署包，控制台和服务直接发布文件，根据项目类型调整msbuild参数。

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