如何在Jenkins作业中使用不定长数组参数实现迭代执行？

我来帮你搞定这个问题——动态处理长度不固定的服务器配置数组，确实是Jenkins里常见的需求。结合实际经验，给你推荐几个靠谱的方案，其中Pipeline是最灵活的首选：

方案一：使用Pipeline Job（强烈推荐） #

Pipeline天生适合处理动态逻辑，不管你的数组长度怎么变，都能轻松应对。分两种场景来说：

1. 单构建内循环处理所有服务器

如果希望一次构建就遍历完所有服务器配置，直接用Pipeline的循环逻辑就行。

首先，给Job加一个字符串参数（比如叫SERVERS_JSON），让用户输入标准的JSON数组，格式像这样：

[
  {"ServerName": "server1.example.com", "IP": "1.1.1.1", "user": "Homer"},
  {"ServerName": "server2.example.com", "IP": "2.2.2.2", "user": "Bart"}
]

然后用Pipeline脚本解析这个JSON，逐个处理每个元素：

pipeline {
    agent any
    parameters {
        string(name: 'SERVERS_JSON', defaultValue: '[]', description: '输入服务器配置的JSON数组，支持动态添加元素')
    }
    stages {
        stage('处理所有服务器') {
            steps {
                script {
                    def servers = readJSON text: params.SERVERS_JSON
                    // 遍历每个服务器配置
                    servers.each { server ->
                        echo "开始处理服务器: ${server.ServerName}"
                        echo "IP地址: ${server.IP}"
                        echo "登录用户: ${server.user}"
                        // 这里替换成你的实际操作，比如SSH执行命令、部署应用等
                        // 示例：sshCommand remote: sshServerConfig, command: "echo Hello from ${server.user}"
                    }
                }
            }
        }
    }
}

如果不想手动输入JSON，还可以结合你之前用的Extended Choice Parameter插件，用Groovy脚本动态生成JSON参数——比如从本地文件、数据库或者API拉取最新的服务器配置，自动转成JSON格式，这样数组长度变了也不用手动改参数。

2. 触发独立子构建处理每个服务器

如果需要每个服务器对应一次单独的构建（也就是你说的“第一次迭代用server1，第二次用server2”），可以用Pipeline的build步骤循环触发子作业：

1. 先创建一个参数化子作业，包含ServerName、IP、user三个字符串参数；
2. 在主Pipeline里解析JSON数组，逐个触发子构建：

pipeline {
    agent any
    parameters {
        string(name: 'SERVERS_JSON', defaultValue: '[]', description: '输入服务器配置的JSON数组')
    }
    stages {
        stage('触发子构建') {
            steps {
                script {
                    def servers = readJSON text: params.SERVERS_JSON
                    servers.each { server ->
                        build job: '你的子作业名称', 
                              parameters: [
                                  string(name: 'ServerName', value: server.ServerName),
                                  string(name: 'IP', value: server.IP),
                                  string(name: 'user', value: server.user)
                              ],
                              wait: false // 不需要等待子构建完成就继续下一个的话，设为false
                    }
                }
            }
        }
    }
}

方案二：Freestyle Job + Dynamic Parameter插件 #

如果你更习惯用传统的Freestyle Job，可以试试Dynamic Parameter插件（注意和Extended Choice Parameter不是同一个），它能通过Groovy脚本动态生成参数选项。

步骤：

1. 安装Dynamic Parameter插件；
2. 在Freestyle Job的参数配置里，添加Dynamic Choice Parameter，类型选“Groovy Script”；
3. 编写Groovy脚本返回服务器配置列表，每个元素用分隔符（比如|）拼接所有信息：

   // 示例：从本地文件读取配置，实际可以替换成从API/数据库拉取
   def configFile = new File('/var/jenkins_home/server_list.txt')
   def serverList = []
   configFile.eachLine { line ->
       def parts = line.split(',')
       serverList.add("${parts[0].trim()}|${parts[1].trim()}|${parts[2].trim()}")
   }
   return serverList
   

4. 在构建步骤里，用shell脚本分割参数，提取需要的字段：

   # 假设参数名叫SERVER_CONFIG
   IFS='|' read -r serverName ip user <<< "$SERVER_CONFIG"
   echo "正在处理：ServerName=$serverName, IP=$ip, User=$user"
   # 执行你的业务操作
   

   不过这个方案需要用户手动选择要处理的服务器，如果要自动遍历所有元素，还是Pipeline更合适。

方案三：Matrix Project插件（适合简单遍历场景） #

Matrix Project可以基于参数组合生成多个构建，结合Groovy脚本动态生成轴参数，也能应对数组长度变化：

1. 安装Matrix Project插件；
2. 创建Matrix Job，在“Matrix Axes”里添加Dynamic Axis，用Groovy脚本返回服务器配置列表；
3. 在构建步骤里处理每个轴对应的配置。不过这个方案灵活性不如Pipeline，适合逻辑简单的场景。

补充：Extended Choice Parameter的正确打开方式 #

你之前用这个插件没搞定动态数组，其实可以用它的Groovy脚本功能动态生成JSON参数。比如从文件读取配置并转成JSON：

def configFile = new File('/var/jenkins_home/server_configs.txt')
def servers = []
configFile.eachLine { line ->
    def parts = line.split(',')
    servers.add([
        ServerName: parts[0].trim(),
        IP: parts[1].trim(),
        user: parts[2].trim()
    ])
}
return new groovy.json.JsonBuilder(servers).toPrettyString()

把这个脚本放到Extended Choice Parameter的“Groovy Script”栏，参数类型选“JSON”，这样每次打开Job页面时，参数会自动加载最新的服务器配置，数组长度变化也能自动识别。

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