Jenkins点击Build后立即显示自定义动态表单并触发任务的方案问询

绝对有Jenkins内部的方案能完美满足你的需求，不用依赖外部Web服务器，还能通过Groovy直接访问Jenkins的内部资源！我之前帮不少团队实现过类似的场景，核心就是用Active Choices Plugin这个官方生态的插件，它能让你在Build触发前直接展示动态生成的表单，完全替代Pipeline Input Step那种需要跳转的体验。

核心实现步骤 #

1. 先安装必要插件 #

首先在Jenkins插件管理里安装Active Choices Plugin（包括它的依赖Active Choices Reactive Reference Parameter），这个插件是Jenkins官方推荐的动态参数解决方案，稳定性很高。

2. Freestyle项目配置（如果用Freestyle） #

如果你用的是Freestyle项目，操作很直观：

• 进入项目配置，找到「This project is parameterized」选项并勾选
• 点击「Add Parameter」，选择「Active Choices Reactive Parameter」
• 在参数配置里：
  • 填写参数名称（比如TARGET_BRANCH）
  • 选择参数类型（比如下拉框、单选按钮组）
  • 在「Script」区域写Groovy脚本，动态获取分支列表，示例脚本：

    // 获取当前项目关联的Git仓库分支
    def scm = Jenkins.instance.getItem(env.JOB_NAME).scm
    def branches = scm.getBranches().collect { it.name }
    return branches
    

  • 保存配置后，点击「Build Now」就能直接看到动态生成的分支下拉框，选完就能触发构建。

3. Pipeline项目配置（如果用Pipeline） #

如果是Pipeline项目，用properties块结合Active Choices的语法就能实现，示例代码如下：

pipeline {
    agent any
    properties([
        // 定义动态分支选择参数
        activeChoiceReactiveParam(
            name: 'TARGET_BRANCH',
            description: '选择要构建的分支',
            choiceType: 'PT_SINGLE_SELECT', // 下拉单选
            script: [
                $class: 'GroovyScript',
                script: [
                    script: '''
                        // 直接访问Jenkins内部的SCM对象获取分支
                        def scm = currentBuild.rawBuild.project.scm
                        def branches = scm.getBranches().collect { it.name }
                        return branches
                    '''
                ]
            ]
        )
    ])
    stages {
        stage('Build') {
            steps {
                echo "正在构建分支: ${params.TARGET_BRANCH}"
                // 这里写你的构建逻辑
            }
        }
    }
}

保存Pipeline后，点击「Build Now」会直接弹出包含分支列表的表单，选择参数后立即触发构建，完全不用去日志或侧边栏找输入入口。

为什么这个方案适合你？ #

• 直接在Build触发前显示表单：完美解决了Pipeline Input Step需要跳转的痛点，用户体验更流畅
• 完全基于Jenkins内部资源：Groovy脚本可以直接访问Jenkins的scm、Jenkins.instance、currentBuild等内部对象，轻松获取分支、项目配置等数据
• 支持参数联动：如果需要更复杂的表单（比如选完分支后显示对应的环境选项），可以用Active Choices的Reactive功能，让参数之间互相依赖

注意事项 #

• 确保Jenkins的安全策略允许Groovy脚本执行：如果遇到脚本权限问题，可以在「Manage Jenkins」→「In-process Script Approval」里批准对应的脚本
• 如果是多SCM项目，需要调整Groovy脚本里获取分支的逻辑，适配你的项目结构

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