Jenkins中Groovy脚本能否用execute()执行Shell命令？最佳方式是什么？

1. 能不能用execute()方法执行Shell命令？ #

可以，但不推荐在Jenkins构建场景下使用。execute()是Groovy原生的进程执行方法，它的运行上下文是Jenkins Master的JVM进程，和Jenkins构建的工作环境完全脱节：

• 不会继承构建任务的环境变量（比如BUILD_NUMBER、WORKSPACE）
• 默认不捕获命令的标准输出、错误输出，出问题难排查
• 命令执行失败时不会主动抛出异常，脚本会继续运行，容易导致隐性错误
• 如果是在Agent节点上运行的脚本，execute()会跑到Master上执行，而非目标Agent节点

2. 执行Shell命令的最佳方式 #

（1）Jenkins Pipeline脚本：用sh步骤（最推荐） #

这是Jenkins官方指定的构建脚本Shell执行方式，完全适配构建环境：

• 自动继承构建的环境变量、工作区路径
• 支持捕获命令输出、检查返回码
• 可以指定在Agent节点执行
• 支持returnStdout、returnStatus等参数，灵活控制执行逻辑

（2）系统Groovy脚本（控制台/系统构建步骤）：用Jenkins Launcher API #

如果是在Jenkins系统层面运行Groovy脚本（比如脚本控制台、系统Groovy构建步骤），可以用Jenkins提供的Launcher API执行，能更好地控制执行上下文：

• 指定执行节点（Master或Agent）
• 绑定工作区、环境变量
• 捕获输出和执行状态

针对你的示例代码的优化版本 #

假设你是在Jenkins Pipeline中运行，优化后的代码如下：

pipeline {
    agent any
    stages {
        stage('Process Files') {
            steps {
                script {
                    def map = [:]
                    def array = readFile('deployable.txt').split('\n')
                    def versionDate = "snapshot"

                    array.each { line ->
                        def splitedPath = line.split('/')
                        def fileName = splitedPath[-1]
                        println fileName
                        // 注意：split的参数是正则，点需要转义
                        def nameOri = fileName.split('\\.t')[0]
                        println nameOri
                        nameOri = "${nameOri}-${versionDate}.txt"
                        map.put(line, nameOri)
                    }

                    map.each { entry ->
                        println "${entry.key}: ${entry.value}"
                        def source = entry.key
                        def dest = entry.value

                        // 使用Jenkins Pipeline的sh步骤
                        sh "touch ${source}"
                        sh "mv ${source} test/${dest}"
                    }
                }
            }
        }
    }
}

原示例的问题说明 #

1. split('.t')中的.是正则表达式元字符，需要转义成\\.t，否则会匹配任意字符
2. 用readFile代替new File()，因为Pipeline中new File()会指向Master的文件系统，而readFile会读取当前工作区的文件
3. 用sh步骤替代execute()，确保在Agent节点执行，且继承构建环境

内容的提问来源于stack exchange，提问作者Ben Hassen Hamdi