如何使用Jenkins多分支Pipeline检测master推送并更新远程网站
多分支Pipeline实现master分支推送触发+SSH同步的配置方案
该能力是Jenkins原生支持的核心功能,结合你已完成的环境配置(GitHub对接、webhook部署、Blue Ocean插件安装),无需额外安装复杂插件即可实现目标流程,具体配置步骤如下:
1. 多分支Pipeline任务初始化
- 进入Blue Ocean操作界面,点击「新建Pipeline」,选择已完成授权的GitHub账号对应的目标代码仓库
- 跟随界面引导完成仓库连接校验,Blue Ocean会自动复用你之前配置的GitHub凭据,无需手动重复填写仓库地址、授权信息
- 任务创建完成后,多分支Pipeline会自动扫描所有包含Jenkinsfile的分支,默认生成对应的webhook回调路径
2. 定向触发逻辑配置(仅响应master分支推送)
可从两个层面配置过滤规则,避免其他分支推送触发无效构建:
- GitHub侧webhook配置调整:进入仓库的webhook设置页,将触发事件从「所有事件」调整为仅勾选「Push events」,并配置分支过滤规则为仅当推送目标为
master分支时,才向Jenkins发送请求 - Jenkins侧分支匹配逻辑配置:在仓库根目录的Jenkinsfile中添加分支判断与触发规则,可直接复用的示例结构如下:
pipeline { agent any // 全局开启GitHub推送事件触发 triggers { githubPush() } stages { stage('分支校验') { steps { script { // 非master分支直接终止构建,不执行后续部署流程 if (env.BRANCH_NAME != 'master') { currentBuild.result = 'NOT_BUILT' error("当前推送分支非master,终止构建") } } } } stage('SSH同步代码到Web服务器') { steps { // 调用提前在Jenkins凭据管理中配置的Web服务器SSH密钥 sshagent(credentials: ['你的Web服务器SSH凭据ID']) { sh ''' ssh -o StrictHostKeyChecking=no Web服务器登录账号@Web服务器IP << EOF cd /web项目的实际部署路径 git pull origin master # 按需添加后续操作:文件权限调整、服务重载等 EOF ''' } } } } }
3. 关键校验点
- 多分支Pipeline的webhook回调为分支独立路径,Blue Ocean创建任务时会自动将对应回调地址同步到GitHub侧,无需手动逐分支配置webhook URL
- 若需要精简构建范围,可在多分支Pipeline的「分支源-分支发现」配置中,添加正则规则仅扫描匹配
master$的分支,减少无效的分支扫描开销 - SSH操作依赖你提前在Jenkins凭据管理中添加Web服务器的SSH登录密钥,无需在Jenkinsfile中硬编码账号密码
内容的提问来源于stack exchange,提问作者Erdss4
相关产品推荐
相关产品推荐

