Jenkins Pipeline实现多远程主机并行执行任务方案问询

我来帮你搞定这个多主机并行执行的需求！其实Jenkins本身就有很成熟的机制来实现，结合参数化构建和并行流水线就能轻松达成目标，下面一步步给你拆解：

一、前期准备 #

• 确保你的Jenkins已经安装了Pipeline插件（默认通常已预装）；如果是通过SSH连接远程主机，确认SSH Pipeline Steps插件已安装（既然你之前单主机运行正常，这个应该已经配置好了）。
• 所有目标主机都要在Jenkins中配置好可访问的凭据（比如SSH密钥或用户名密码），确保Jenkins能正常连通每台主机。

二、调整参数化配置 #

把原来的单个字符串参数HOST，改成支持多主机输入的形式：

• 推荐用多行字符串参数（Multi-line String Parameter），命名为HOSTS，这样用户可以每行输入一个主机名，操作更直观；
• 也可以保留字符串参数HOST，让用户用逗号/空格分隔多个主机（比如host1,host2,host3），后续在脚本中拆分即可。

三、编写并行执行的Pipeline脚本 #

这是实现并行的核心，下面给两种参数输入方式的示例：

示例1：多行字符串参数（每行一个主机） #

假设参数名是HOSTS，Pipeline脚本如下：

pipeline {
    agent any
    parameters {
        text(name: 'HOSTS', defaultValue: 'host1', description: '每行输入一个目标主机名，空行会自动忽略')
    }
    stages {
        stage('并行执行远程脚本') {
            steps {
                script {
                    // 拆分多行字符串为主机列表，同时过滤空行和多余空格
                    def hostList = params.HOSTS.split('\n').collect { it.trim() }.findAll { it != '' }
                    
                    // 构建并行任务映射，每个主机对应一个执行任务
                    def parallelTasks = [:]
                    for (host in hostList) {
                        parallelTasks["执行主机: ${host}"] = {
                            node {
                                // 替换为你实际的远程执行逻辑，这里以SSH为例
                                sshCommand(
                                    credentialsId: '你的SSH凭据ID', // 替换成Jenkins中已配置的SSH凭据ID
                                    host: host,
                                    command: 'echo "当前执行主机: $HOSTNAME"; /path/to/your/script.sh' // 替换为要运行的脚本命令
                                )
                            }
                        }
                    }
                    
                    // 启动并行执行
                    parallel parallelTasks
                }
            }
        }
    }
}

示例2：逗号分隔的字符串参数 #

如果继续使用原参数HOST，用户输入host1,host2,host3，脚本可以这样写：

pipeline {
    agent any
    parameters {
        string(name: 'HOST', defaultValue: 'host1', description: '用逗号分隔多个主机名，比如host1,host2,host3')
    }
    stages {
        stage('并行执行远程脚本') {
            steps {
                script {
                    // 拆分逗号分隔的字符串为主机列表
                    def hostList = params.HOST.split(',').collect { it.trim() }.findAll { it != '' }
                    
                    def parallelTasks = [:]
                    for (host in hostList) {
                        parallelTasks["执行主机: ${host}"] = {
                            node {
                                sshCommand(
                                    credentialsId: '你的SSH凭据ID',
                                    host: host,
                                    command: 'echo "正在执行主机: $HOSTNAME"; /root/your_script.sh' // 替换为实际脚本路径
                                )
                            }
                        }
                    }
                    
                    parallel parallelTasks
                }
            }
        }
    }
}

四、关键注意事项 #

• 凭据配置：一定要确保credentialsId对应的凭据能访问所有目标主机，避免出现部分主机认证失败的情况。
• 并行控制：如果主机数量较多，可以通过parallel(..., failFast: true)设置——只要有一个主机执行失败，立刻终止所有并行任务（默认是failFast: false，会继续执行其他主机的任务）。
• 日志查看：Jenkins会为每个并行任务生成独立的日志标签，你可以在任务页面切换查看每台主机的执行详情。
• 脚本兼容性：确保你的远程脚本在所有目标主机上的运行环境一致（比如依赖、路径等），如果有差异，建议在脚本中做兼容处理。

这样配置之后，你只要在参数中输入多个主机名，Jenkins就会自动在这些主机上并行执行你的脚本啦！

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