如何在Jenkins中创建可复用的模板Pipeline？

DevOps 小满

2026-10-5

JTE 模板Pipeline操作指南

问题说明

Jenkins Templating Engine（JTE）不会在新建任务的类型选择页新增独立的模板任务选项，你选择Pipeline类型创建任务的操作是正确的，不需要额外寻找「Select Job Template」的任务类型入口。

配置步骤

第一步：先配置JTE治理层（支持全局或文件夹层级配置）
进入「Manage Jenkins」→「Configure System」，找到「Jenkins Templating Engine」配置区域，开启全局模板支持，上传或关联模板仓库、配置公共库依赖、定义可用的Pipeline模板即可。如果是多团队使用，建议在文件夹层级配置治理层，不同业务线可以独立维护模板规则。
第二步：开启单任务的JTE支持
回到你已经创建的Pipeline任务配置页，下拉到「Pipeline」配置块，将「Definition」的默认选项从Pipeline script或Pipeline script from SCM切换为Jenkins Templating Engine，切换后就会出现模板选择、自定义参数配置的相关选项。
第三步：绑定模板并运行
选择你提前配置好的对应Pipeline模板，填写模板所需的自定义参数后保存任务，即可基于模板运行流水线。

基础模板示例

通用多场景JTE模板参考：
// 模板入口文件
on_pull_request {
  build()
  static_code_scan()
  unit_test()
}

on_merge_to_main {
  build()
  artifact_build()
  artifact_scan()
  deploy("test")
  interface_test()
}

on_release_tag {
  deploy("prod")
  send_notification()
}
模板中build、deploy等通用步骤可以封装为JTE公共库实现，不同技术栈的项目可以重载对应步骤的逻辑，无需修改模板本身即可实现多项目复用。