You need to enable JavaScript to run this app. 如何使用Jenkins多分支Pipeline检测master推送并更新远程网站
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 03:36:01