Azure Pipelines任务版本管理规则与自托管代理相关问题咨询

官方文档查询路径 #

• 所有Azure Pipelines内置任务的参数说明、运行逻辑、依赖要求，均可在Azure DevOps官方文档站的「Azure Pipelines 任务参考」分类下，通过任务主版本标识（例如AzurePowerShell@5、AzureCLI@2）直接检索定位。
• 第三方市场扩展类任务（例如你使用的TerraformTaskV3@3，属于DevLabs发布的Terraform扩展），说明文档附属于对应扩展的市场详情页。无需通过模拟创建发布任务转YAML的方式获取任务完整标识：所有任务的YAML标识遵循固定格式[扩展发布者ID].[扩展ID].[任务ID]@任务主版本号，在流水线编辑器的任务助手面板选中目标任务后，编辑器会自动补全完整的任务标识。

你之前获取到的Terraform任务示例YAML格式正确，参考如下：

steps:
- task: ms-devlabs.custom-terraform-tasks.custom-terraform-release-task.TerraformTaskV3@3
  displayName: 'Terraform : azurerm'
  inputs:
    command: custom
    customCommand: import
    environmentServiceNameAzureRM: 'something'

任务依赖安装对自托管代理环境的影响 #

任务执行过程中的依赖安装操作默认不会修改自托管代理的全局环境，规则如下：

• 任务自动下载的依赖工具，统一存放在代理工作目录下的_work/_tool缓存文件夹中，仅对当前代理的流水线作业生效，不会替换、修改系统全局路径下已安装的对应工具（包括你手动部署的Terraform、Azure CLI、Azure PowerShell）。
• 只有当你主动在流水线中添加专门的工具安装类任务，且手动开启了写入系统全局路径的配置时，才有可能改动系统全局安装的软件版本，默认配置下所有工具安装任务均使用代理缓存目录存储版本文件，不改动全局环境。

Azure PowerShell、Azure CLI任务的版本运行逻辑 #

你遇到的配置LatestVersion参数但仍调用本地旧版本的问题，符合内置任务的默认版本检测逻辑：

1. 默认版本选择优先级
   当你在AzurePowerShell@5任务中配置azurePowerShellVersion: LatestVersion，或在Azure CLI任务中配置对应最新版本参数时，任务的版本检测逻辑会优先校验系统全局路径下是否存在满足最低运行要求的已安装版本：如果全局路径存在可用版本，任务会直接加载全局版本，不会主动触发最新版下载，这就是旧版本被调用的核心原因。

   你使用的AzurePowerShell任务示例配置如下：

   - task: AzurePowerShell@5
       displayName: 'DevCode'
       inputs:
         azureSubscription: 'something'
         ScriptPath: 'something'
         azurePowerShellVersion: LatestVersion
   

2. 免预装使用指定版本的配置方法
   不需要在自托管代理上全局预装最新版工具，也不需要修改代理上已有的旧版本配置，即可在作业中使用最新版Azure PowerShell或Azure CLI：

   • 对于Azure PowerShell作业：在AzurePowerShell@5任务前，显式添加AzurePowerShellToolInstaller@5任务，将目标版本参数设置为latest。该任务会自动将对应最新版Az模块下载到代理工具缓存，临时调整当前作业的路径优先级，确保后续任务加载缓存中的最新版本，全程不会改动代理上全局安装的旧版Az模块。
   • 对于Azure CLI作业：同理，在AzureCLI@2任务前添加AzureCLIVInstaller@0任务，指定目标版本为latest，即可绕过全局安装的旧版本，使用最新版Azure CLI执行脚本。

Terraform任务的版本说明 #

你使用的TerraformTaskV3@3属于第三方扩展任务，本身不内置Terraform自动安装逻辑：

• 如果流水线中没有添加TerraformInstaller@0任务指定Terraform版本，任务会直接调用系统全局路径下的terraform可执行文件。
• 如果添加了TerraformInstaller@0任务指定版本，下载的对应版本Terraform会存放在代理工具缓存中，仅在当前流水线作业生命周期内生效，不会替换你在代理上全局安装的Terraform版本。

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