如何更新VM规模集托管的Azure DevOps代理池以构建.NET 8

问题描述 #

代码库升级至.NET 8后，使用VM规模集托管的代理池执行部署时，MSBuild步骤报错：

Error : Version 8.0.405 of the .NET SDK requires at least version 17.8.3 of MSBuild

已将规模集中的实例更新至最新版本，并添加Use Dot Net Core步骤指定.NET 8，但错误依旧。流水线原YAML如下：

pool:
  name: <<Pool Name>>
  demands: msbuild

variables:
  vsVersion: '17.0'

steps:
- task: UseDotNet@2
  displayName: 'Use .NET Core sdk 8.0.x'
  inputs:
    version: 8.0.x
    includePreviewVersions: true

- task: ms.advancedsecurity-tasks.codeql.init.AdvancedSecurity-Codeql-Init@1
  displayName: 'Initialize CodeQL'
  inputs:
    enableAutomaticCodeQLInstall: true
    languages: csharp
    querysuite: 'security-and-quality'

- task: MSBuild@1
  displayName: 'Build solution **/*.sln'
  inputs:
    msbuildArchitecture: x64
    restoreNugetPackages: true

- task: ms.advancedsecurity-tasks.codeql.analyze.AdvancedSecurity-Codeql-Analyze@1
  displayName: 'Perform CodeQL analysis'
  inputs:
    WaitForProcessing: true

解决方案 #

1. 更新VS版本变量 #

当前vsVersion设为17.0，会引导MSBuild任务调用旧版本的MSBuild，不符合.NET 8.0.405 SDK的要求。将其修改为17.8.3或更高版本：

variables:
  vsVersion: '17.8.3'

2. 强化代理池的版本要求 #

在代理池的demands中添加MSBuild版本校验，确保只有满足版本要求的代理才会被选中执行流水线：

pool:
  name: <<Pool Name>>
  demands: 
    - msbuild
    - msbuildversion -ge 17.8.3

3. 显式指定MSBuild任务的VS版本 #

在MSBuild@1任务中添加vsVersion参数，明确指定使用符合要求的MSBuild版本：

- task: MSBuild@1
  displayName: 'Build solution **/*.sln'
  inputs:
    msbuildArchitecture: x64
    restoreNugetPackages: true
    vsVersion: '$(vsVersion)'

4. 确认代理环境的VS版本 #

如果是自托管代理，手动将Visual Studio更新至17.8.3及以上版本；如果使用托管代理，确认选择的代理镜像包含对应版本的Visual Studio。

修改后的完整流水线YAML #

pool:
  name: <<Pool Name>>
  demands: 
    - msbuild
    - msbuildversion -ge 17.8.3

variables:
  vsVersion: '17.8.3'

steps:
- task: UseDotNet@2
  displayName: 'Use .NET Core sdk 8.0.x'
  inputs:
    version: 8.0.x
    includePreviewVersions: true

- task: ms.advancedsecurity-tasks.codeql.init.AdvancedSecurity-Codeql-Init@1
  displayName: 'Initialize CodeQL'
  inputs:
    enableAutomaticCodeQLInstall: true
    languages: csharp
    querysuite: 'security-and-quality'

- task: MSBuild@1
  displayName: 'Build solution **/*.sln'
  inputs:
    msbuildArchitecture: x64
    restoreNugetPackages: true
    vsVersion: '$(vsVersion)'

- task: ms.advancedsecurity-tasks.codeql.analyze.AdvancedSecurity-Codeql-Analyze@1
  displayName: 'Perform CodeQL analysis'
  inputs:
    WaitForProcessing: true

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