如何从Jenkinsfile迁移至使用JTE的pipeline_config.groovy

核心问题原因 #

默认多分支流水线的分支源仅配置了Jenkinsfile识别规则，无匹配文件时会直接跳过分支，不会触发JTE模板的读取逻辑。

配置步骤 #

• 进入对应多分支流水线的配置页面，定位到分支源配置块
• 在构建配置的模式下拉菜单中，将默认的by Jenkinsfile切换为Jenkins Templating Engine
• 在项目识别器配置栏下依次添加两个识别规则：
  • 规则1（Jenkinsfile优先）：文件路径填写Jenkinsfile，识别器选择标准Jenkinsfile识别器，可自定义脚本路径适配非根目录的Jenkinsfile存储场景
  • 规则2（JTE兜底）：文件路径填写pipeline_config.groovy，识别器选择Jenkins Templating Engine 项目识别器
• 勾选JTE配置块底部的允许自定义Jenkinsfile覆盖JTE模板选项（JTE 2.3版本原生支持该配置）
• 保存配置后重新执行Scan Multibranch Pipeline Now即可生效

生效逻辑 #

• 分支存在Jenkinsfile时，优先调用该文件定义的流水线执行
• 分支无Jenkinsfile但存在pipeline_config.groovy时，自动调用JTE治理层共享模板执行
• 两个配置文件均不存在时，才会跳过该分支并输出对应日志提示

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