如何根据Jenkins任务参数正确配置Pipeline的仓库分支？

核心配置步骤 #

• 确认参数已正确添加：在任务的「General」标签下，勾选「This project is parameterized」，添加字符串参数或分支参数，参数名设为BRANCH，可设置默认值（如main）。
• 配置分支构建规则：切换到「Pipeline」标签，在「Branches to build」输入框中，直接填入${BRANCH}。这里的变量名要和你定义的参数名完全一致（大小写敏感）。
  • 若用分支参数类型，参数值会自动对应仓库分支，直接引用即可；若用字符串参数，需确保输入的分支格式合法（比如main或refs/heads/main，取决于仓库的分支引用规则）。

Jenkinsfile中引用参数（可选） #

如果需要在Jenkins脚本里使用该分支参数，直接通过params.BRANCH调用，示例：

pipeline {
    agent any
    stages {
        stage('拉取代码') {
            steps {
                git branch: params.BRANCH, url: '你的仓库URL'
            }
        }
    }
}

常见问题排查 #

• 检查参数名大小写：Jenkins参数区分大小写，BRANCH和branch是两个不同参数。
• 确认任务已开启参数化：未勾选「This project is parameterized」时，参数不会被识别。
• 多分支Pipeline注意事项：如果是多分支任务，不要和自动分支索引规则冲突，普通Pipeline按上述配置即可。

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