Azure DevOps多阶段流水线变量共享失败，无法更新保留锁

问题根源 #

你遇到的The requested resource does not support http method 'PATCH'错误，本质是UAT2阶段未获取到UAT阶段输出的LeaseId，导致更新保留锁的API请求URL缺失关键参数，请求路径无效才触发了方法不支持的错误。

分步解决方案 #

1. UAT阶段正确输出LeaseId变量

在UAT阶段设置保留锁的PowerShell脚本中，必须将LeaseId标记为输出变量，确保后续阶段能读取：

# 假设你已通过API获取到UAT阶段的保留锁LeaseId，赋值给$leaseId
$leaseId = "获取到的锁ID值"
# 输出变量，isOutput=true是关键
Write-Host "##vso[task.setvariable variable=LeaseId;isOutput=true]$leaseId"

2. UAT2阶段正确引用UAT阶段的输出变量

在流水线的YAML配置中，UAT2阶段必须依赖UAT阶段，并通过stageDependencies正确引用输出变量：

stages:
- stage: UAT
  jobs:
  - job: UATDeploymentJob
    steps:
    # 你的UAT部署步骤
    # 设置1年保留锁并输出LeaseId的PowerShell步骤

- stage: UAT2
  dependsOn: UAT
  variables:
    # 格式：stageDependencies.阶段名.作业名.outputs['作业名.变量名']
    NewLeaseId: $[ stageDependencies.UAT.UATDeploymentJob.outputs['UATDeploymentJob.LeaseId'] ]
  jobs:
  - job: UAT2DeploymentJob
    steps:
    # 你的UAT2部署步骤
    # 更新保留锁的PowerShell步骤

注意：替换UATDeploymentJob为你UAT阶段实际的作业名称，确保拼写完全一致。

3. 修正保留锁更新的PowerShell脚本

确保脚本中使用传递过来的NewLeaseId拼接正确的API请求URL，同时验证API版本和请求体格式：

# 替换为你的组织、项目信息
$orgName = "你的Azure DevOps组织名"
$projName = "你的项目名"
$buildId = $(Build.BuildId)
$leaseId = $(NewLeaseId)
# 替换为你的PAT令牌（需有Build权限）
$pat = "你的PAT令牌"
$authHeader = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$pat"))

# 正确拼接包含LeaseId的API URL
$apiUrl = "https://dev.azure.com/$orgName/$projName/_apis/build/retention/leases/$leaseId?api-version=7.1-preview.2"

# 永久保留的请求体（daysValid=-1表示永久）
$requestBody = @{
  definitionId = $(Build.DefinitionId)
  ownerId = "保留锁的所有者ID"
  daysValid = -1
  protectPipeline = $true
} | ConvertTo-Json

# 执行PATCH请求更新保留锁
Invoke-RestMethod -Uri $apiUrl -Method PATCH `
                  -Headers @{Authorization = "Basic $authHeader"} `
                  -Body $requestBody -ContentType "application/json"

4. 验证变量传递有效性

在UAT2阶段的PowerShell脚本开头添加输出语句，确认NewLeaseId是否成功获取：

Write-Host "从UAT阶段获取的LeaseId：$(NewLeaseId)"

如果输出为空，检查：

• UAT阶段是否正确标记isOutput=true
• UAT2阶段的stageDependencies路径是否与实际阶段、作业名称匹配
• 变量名是否存在拼写错误

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