如何在Jenkins Build Queue小部件中展示更多自定义环境变量信息

AI 小北

2026-9-28

实现方案

方案1：使用Build Name and Description Setter插件（适配自由风格/Pipeline任务）

这是最简便的实现方式，操作步骤如下：

进入Jenkins插件管理页，搜索安装Build Name and Description Setter插件，安装完成后重启Jenkins生效
打开你需要调整的Gerrit触发任务的配置页面，找到「构建环境」配置区块，勾选Set Build Name选项
在构建名称输入框中填入自定义模板，直接引用Gerrit触发时传入的环境变量即可，示例模板如下：
```
master - 变更号#${GERRIT_CHANGE_NUMBER} - 提交人${GERRIT_EVENT_ACCOUNT_NAME}
```
保存配置后，所有新触发的排队、构建中的任务都会在Build Queue小部件中直接显示上述自定义名称，无需悬浮即可直观查看对应信息。

方案2：Pipeline原生语法实现（仅适配Pipeline任务）

如果不想额外安装插件，且你的任务是Pipeline类型，可以直接在Jenkinsfile中配置构建显示名称：

在Pipeline逻辑最开始的初始化阶段，添加currentBuild.displayName赋值逻辑即可，示例代码如下：

pipeline {
  agent any
  stages {
    stage('初始化') {
      steps {
        script {
          // 直接调用触发时传入的Gerrit相关环境变量
          currentBuild.displayName = "master - #${env.GERRIT_CHANGE_NUMBER} - ${env.GERRIT_EVENT_ACCOUNT_NAME}"
        }
      }
    }
    // 此处保留你原有构建、测试、部署等阶段逻辑
  }
}