如何为Jenkins下游Pipeline创建支持数组类型的参数？

嘿，我刚好在工作中碰到过一模一样的问题！其实Pipeline间传递数组的核心思路就是「要么转成字符串传，要么用工具原生支持的方式」，我给你整理下不同场景下的解决方案：

1. 序列化数组为字符串（通用兜底方案） #

不管你用的是Jenkins、Azure DevOps还是GitLab CI，这都是最稳妥的办法——把数组转成分隔符分隔的字符串（比如逗号、竖线，只要数组元素里不包含这个分隔符就行），下游Pipeline拿到后再拆分回数组。

• 上游CallingPipeline示例（以Jenkins Groovy为例）：

  def myArray = ["apple", "banana", "cherry"]
  // 转成逗号分隔的字符串
  def arrayStr = myArray.join(",")
  // 调用下游时传递这个字符串参数
  build job: 'CalledPipeline', parameters: [string(name: 'ARRAY_PARAM', value: arrayStr)]
  

• 下游CalledPipeline处理：

  def arrayStr = params.ARRAY_PARAM
  // 拆分回数组
  def myArray = arrayStr.split(",")
  // 现在就能正常使用数组了
  println myArray
  

2. 用工具原生支持的参数类型（优先选这个） #

很多主流Pipeline工具其实是支持数组/列表类型参数的，只是可能需要你手动开启或者找对参数类型：

• Azure DevOps：新版已经直接支持「List」类型参数了，直接在下游Pipeline的参数配置里选就行；如果是旧版本，用「Multi-line text」参数，上游传数组时用换行符分隔每个元素，下游用split('\n')拆分回数组。
• GitLab CI/CD：父子Pipeline场景下，可以直接用YAML数组语法传递变量：

  # 上游CallingPipeline
  trigger:
    include:
      - project: 'your-project/CalledPipeline'
        ref: main
        strategy: depend
        variables:
          MY_ARRAY: ["apple", "banana", "cherry"]
  

  下游Pipeline里可以直接把$MY_ARRAY当作数组来使用。
• Jenkins：可以安装「Extended Choice Parameter」插件，它支持创建列表/数组类型的参数，安装后下游Pipeline就能直接接收数组参数，上游调用时直接传数组即可。

3. 文件传递（适合复杂/大数组） #

如果你的数组元素结构复杂（比如嵌套对象），或者数组长度很大，序列化字符串容易出问题，那就把数组转成JSON格式写到文件里，上传到共享存储（比如Jenkins工作区、GitLab Artifacts），下游Pipeline下载文件后再解析成数组：

• 上游示例（Jenkins）：

  def myArray = [["name": "apple", "count": 5], ["name": "banana", "count": 3]] // 复杂嵌套数组
  // 转成JSON写入文件
  writeJSON file: 'array-data.json', json: myArray
  // 调用下游时传递文件路径
  build job: 'CalledPipeline', parameters: [string(name: 'ARRAY_FILE_PATH', value: 'array-data.json')]
  

• 下游处理：

  def arrayJson = readJSON file: params.ARRAY_FILE_PATH
  def myArray = arrayJson as List
  

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