Azure Pipelines中字符串参数转JSON数组的实现问询

问题概述 #

需要将Azure Pipelines中分号分隔的特征旗字符串参数（例如"Feature_A;Feature_B"）转换为如下格式的JSON字符串：

[{"name":"Feature_A","value":"true"},{"name":"Feature_B","value":"true"}]

目标是通过单任务将该JSON传入预定义模板，避免使用each循环生成多个任务。

现有尝试 #

当前尝试用Azure Pipelines表达式拆分字符串，但无法实现对数组每个元素的格式映射：

steps:
  - pwsh: |
      $featureAsJson = "$env:FEATUREFLAGS_AS_JSON";

      Write-Host "feature-flag-to-json:";
      Write-Host $featureAsJson;
      [Environment]::Exit(0);
    displayName: "TEST AUSGABE"
    env:
      FEATUREFLAGS_AS_JSON: ${{ join(',', split(parameters.featureFlags, ';')) }}

期望找到类似C#中Select的表达式函数，实现对数组元素的格式化：

void Main()
{
  var list = new []{"Feature_A", "Feature_B"};
  var newList = list.Select(item=> $"{{\"name\":\"{item}\",\"value\"=\"true\"}}");
  var json = string.Join(",", newList);
  json = $"[{json}]";
  Console.WriteLine(json); // => [{"name":"Feature_A","value":"true"},{"name":"Feature_B","value":"true"}]
}

解决方案 #

Azure Pipelines的表达式系统没有直接提供对数组元素的映射转换函数，最简洁的方式是在PWSH任务中直接完成字符串到JSON的转换，然后将结果传入模板。

方法1：生成JSON变量后传递给模板 #

先在步骤中生成JSON字符串，通过流水线变量传递给模板：

steps:
  - pwsh: |
      # 拆分分号分隔的字符串并移除空元素
      $features = "${{ parameters.featureFlags }}".Split(';', [System.StringSplitOptions]::RemoveEmptyEntries)
      # 转换为指定格式的对象数组
      $featureObjects = $features | ForEach-Object {
        @{
          name = $_
          value = "true"
        }
      }
      # 转换为压缩格式的JSON字符串
      $featureJson = $featureObjects | ConvertTo-Json -Compress
      # 设置为输出变量
      Write-Host "##vso[task.setvariable variable=FeatureFlagsJson;isOutput=true]$featureJson"
    displayName: "生成特征旗JSON"
    name: GenerateFeatureJson

# 调用模板时引用生成的变量
- template: edit-json-file.yml
  parameters:
    jsonPath: ${{ parameters.jsonPath }}
    settings: ${{ steps.GenerateFeatureJson.outputs.FeatureFlagsJson }}

方法2：内联脚本直接生成模板参数 #

如果场景简单，可直接在模板参数中通过内联PowerShell脚本生成JSON：

- template: edit-json-file.yml
  parameters:
    jsonPath: ${{ parameters.jsonPath }}
    settings: $[powershell('
      $features = "${{ parameters.featureFlags }}".Split(";", [System.StringSplitOptions]::RemoveEmptyEntries);
      $featureObjects = $features | ForEach-Object { @{name = $_; value = "true"} };
      return $featureObjects | ConvertTo-Json -Compress;
    ')]

关键说明 #

• 两种方法都通过单步处理完成转换，避免了each循环生成多任务的问题
• 使用ConvertTo-Json而非手动拼接字符串，能自动处理特殊字符转义，保证JSON格式合法性
• 若参数包含引号、空格等特殊字符，ConvertTo-Json会自动处理，无需额外转义

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