Jenkins Parameter Separator 插件通过分组标题和CSS样式美化参数界面,需安装插件、配置全局样式(Globalseparatorstyle/Globalsectionheaderstyle)、在Job中添加Parameter Separator及后续参数,并验证渲染效果。

在 Linux 环境下用 Jenkins 的 Parameter Separator 插件美化复杂发布任务的参数界面,核心是把一堆混杂的构建参数按逻辑分组、加标题、设样式,让运维或开发人员一眼看清“哪块填什么”,避免选错、输错、漏填。操作不难,但需注意配置层级和 CSS 样式生效位置。
安装 Parameter Separator 插件
登录 Jenkins Web 界面(如 http://your-jenkins:8080),进入:
Manage Jenkins → Manage Plugins → Available(可选插件)
搜索 Parameter Separator,勾选并点击 Install without restart(推荐)或重启 Jenkins。
配置全局分隔样式
插件安装后,前往:
Manage Jenkins → Configure System → Parameter Separator
这里可设置两组关键全局变量:
- Globalseparatorstyle:控制分隔线本身的样式(比如高度、边框、背景色)
- Globalsectionheaderstyle:控制每个分组标题(Section Header)的显示效果(字体、颜色、对齐、大小等)
例如,一个清晰易读的标题样式可写成:
background-color: #48D1CC; color: #FFFFFF; padding: 6px 12px; font-size: 16px; font-weight: bold; text-align: left;保存后,所有未单独覆盖的 Job 都会继承该样式。
在具体 Job 中添加分组与参数
编辑你要美化的构建任务(Freestyle 或 Pipeline Job 均支持),进入 Configure → 向下滚动到 General → This project is parameterized。
点击 Add Parameter → Parameter Separator,填写:
– Section Header:如 “【环境选择】”、“【发布控制】”、“【回滚配置】”
– 可选:勾选 Use custom separator style 覆盖全局样式(适合某组特殊强调)
紧接着,在这个 Separator 下方,添加真实参数,比如:
- Choice Parameter:env = [dev, test, prod]
- String Parameter:version = “v1.2.0”
- Boolean Parameter:force_deploy = false
重复添加多个 Parameter Separator + 参数组合,即可形成视觉清晰的区块化表单。
验证与微调建议
保存 Job 后,点击 Build with Parameters,观察实际渲染效果:
- 标题是否居中/左对齐?文字是否够大、颜色是否足够对比?
- 分隔线是否太细或太突兀?可调整
border-bottom或margin - 若中文标题显示异常,确保字体声明含
sans-serif或SimSun, "Microsoft YaHei" - 避免在 Section Header 中使用过长文本,建议控制在 10 字以内,加符号引导更直观
样式调试推荐直接在浏览器开发者工具中预览 CSS 效果,再复制回 Jenkins 全局配置中固化。


















