VSTS构建任务：如何从查询结果集生成下拉列表

要实现用外部仓库的包列表动态填充构建/发布定义的下拉选项，核心思路是通过脚本获取外部数据，再借助Azure DevOps REST API更新定义中的参数选项，或者利用自定义任务简化操作。下面是具体的分步操作：

1. 先创建静态下拉参数占位 #

打开你的发布/构建定义，进入「变量」选项卡，添加一个参数化变量（记得勾选「允许在发布时编辑」），类型选择「下拉列表」，先填几个静态选项占位（比如Package1、Package2），变量名设为SelectedPackage——后续我们会用脚本把这些静态选项替换成外部仓库的实际包列表。

2. 编写脚本拉取外部仓库的包列表 #

添加一个PowerShell（或Bash）脚本任务，放在管道最前面（或专门做一个「前置准备」阶段），用来调用外部仓库的API获取包数据。举个PowerShell的示例：

# 替换成你的外部仓库API地址
$repoApiUrl = "https://your-external-repo/api/packages"
# 调用API获取包列表
$packages = Invoke-RestMethod -Uri $repoApiUrl -Method Get

# 提取包名字段（假设API返回的JSON里每个包对象有Name属性）
$packageNames = $packages | Select-Object -ExpandProperty Name

# 日志输出确认结果
Write-Host "成功获取到外部仓库包列表：$($packageNames -join ', ')"

3. 用REST API更新下拉参数的选项 #

在同一个脚本里，调用Azure DevOps的REST API，把刚拿到的包列表更新到发布定义的SelectedPackage参数的允许值里。注意：

• 你需要提前创建一个个人访问令牌（PAT），权限至少包含「发布定义（编辑）」或「构建定义（编辑）」；
• 替换脚本中的组织名、项目名、发布定义ID和PAT令牌。

完整脚本片段：

# 配置Azure DevOps基础信息
$orgName = "你的组织名"
$projName = "你的项目名"
$definitionId = "你的发布定义ID" # 可在定义页面URL中找到
$patToken = "你的PAT令牌"
$base64Auth = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$patToken"))

# 获取当前发布定义详情
$defUrl = "https://dev.azure.com/$orgName/$projName/_apis/release/definitions/$definitionId?api-version=7.1-preview.7"
$definition = Invoke-RestMethod -Uri $defUrl -Headers @{Authorization = "Basic $base64Auth"} -Method Get

# 定位到要更新的下拉参数
$targetParam = $definition.variables | Where-Object { $_.name -eq "SelectedPackage" }
if ($targetParam) {
    # 更新参数允许值为外部仓库包列表
    $targetParam.allowedValues = $packageNames
    Write-Host "已同步外部包列表到下拉参数"
} else {
    Write-Error "未找到名为SelectedPackage的参数，请检查变量名是否正确"
    exit 1
}

# 提交更新后的发布定义
Invoke-RestMethod -Uri $defUrl -Headers @{Authorization = "Basic $base64Auth"} -Method Put `
    -Body ($definition | ConvertTo-Json -Depth 10) `
    -ContentType "application/json"

Write-Host "发布定义更新完成，下次触发时下拉列表将显示最新包列表"

4. 验证效果 #

保存定义后手动触发一次发布：

• 脚本会先拉取外部仓库的包列表，然后更新定义中的下拉选项；
• 下次打开发布触发页面时，SelectedPackage的下拉列表就会显示最新的10个包，你可以直接选择任意一个。

补充说明 #

• 如果是构建定义，只需把REST API路径换成构建定义接口：https://dev.azure.com/$orgName/$projName/_apis/build/definitions/$definitionId?api-version=7.1-preview.7；
• 若不想每次触发都更新定义，可以把这个脚本做成定时管道，定期同步外部仓库的包列表；
• 嫌写API麻烦的话，也可以去Azure DevOps Marketplace找现成的动态参数扩展（比如Dynamic Parameters Task），这类扩展已封装好逻辑，配置更简单。

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