如何在Jenkins Active Choices插件Groovy脚本中执行Shell命令？

嘿，这个问题我之前帮人处理过，其实是可以在Active Choices的Groovy脚本里切换节点执行Shell的，不过得用正确的姿势才行！

首先得搞清楚为啥直接用sh会崩：Active Choices的脚本默认是在Jenkins master的JVM进程里跑的，没有绑定到任何具体的执行节点（不管是master还是agent），而流水线里的sh方法是依赖流水线的节点上下文的，所以直接调用肯定会失败，触发回退脚本。

那怎么解决呢？我们可以通过Jenkins的节点API，显式指定一个节点来执行Shell命令，具体步骤和示例如下：

核心实现思路 #

• 先获取Jenkins实例，找到你要用来执行Shell的节点（可以是master，也可以是某个特定的agent节点）
• 在该节点的上下文里启动一个命令执行通道，运行你的Shell命令
• 捕获命令输出，处理后作为Active Choices的选项返回

示例代码 #

// 获取Jenkins实例
def jenkins = Jenkins.instance

// 指定要使用的节点名称，比如'master'或者你的agent节点名
def targetNode = jenkins.getNode('master')

if (targetNode) {
    def commandOutput = []
    // 在目标节点上执行Shell命令
    targetNode.build { launcher ->
        // 启动命令执行通道
        def channel = launcher.launch().stdout().start()
        // 这里替换成你需要执行的Shell命令，比如获取Git分支列表
        channel.execute('git ls-remote --heads https://github.com/your/repo.git | cut -d/ -f3')
        // 读取命令输出并转为列表
        commandOutput = channel.in.text.readLines()
        channel.close()
    }
    // 去重、排序后返回作为选项
    return commandOutput.unique().sort()
} else {
    // 如果找不到指定节点，返回备选提示
    return ['指定节点未找到，请检查节点名称']
}

注意事项 #

• 权限问题：确保执行这个脚本的Jenkins用户有访问目标节点的权限，以及执行Shell命令所需的权限（比如Git拉取、文件读写等）。如果Jenkins开启了脚本安全策略，你可能需要在Manage Jenkins -> In-process Script Approval里审批相关的API调用（比如Jenkins.instance、getNode等方法）。
• 性能影响：Active Choices参数在用户加载页面时会执行脚本，所以尽量避免执行耗时的Shell命令，不然会让用户等待很久。如果数据不需要实时更新，可以考虑加个缓存机制，比如把结果存在临时文件或者Jenkins全局变量里，定期刷新。
• 节点可用性：如果指定的agent节点离线，脚本会返回错误提示，所以最好提前判断节点状态，或者设置备选节点。

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