如何仅针对特定路径变更触发Jenkinsfile构建

嘿，这个问题我之前刚踩过坑！确实Jenkins多分支流水线默认会在代码提交时触发所有关联的流水线，但完全可以通过路径过滤来精准控制触发范围，不用纠结自己是不是漏了配置方法～

你想要的“按路径选择性触发”可以通过Jenkins自带的when指令结合changeset条件实现，不需要额外装插件，而且写法很直观，下面给你两种常用的实现方式：

方式一：跳过不符合路径的Stage（保留构建记录） #

如果只是不想执行某个Stage的逻辑，但希望保留构建记录，可以把when放在对应Stage上：

pipeline {
    agent { label 'Codebuild' }
    stages {
        stage('Do the magic') {
            // 只有当指定路径下有代码变更时，才执行这个Stage
            when {
                changeset "**/some/path/**"
            }
            steps {
                script {
                    // 这里写你的任务逻辑
                }
            }
        }
    }
}

changeset支持Ant风格的路径匹配规则：

• ** 匹配任意层级的目录
• * 匹配任意字符（不含目录分隔符）
• 如果要排除特定路径，用not包裹即可：

  when {
      not {
          changeset "**/exclude/this/path/**"
      }
  }
  

方式二：直接终止不符合条件的构建（不生成无用记录） #

如果希望完全不触发整个流水线，而不是只跳过Stage，可以在流水线开头加一个检查Stage，一旦检测到没有指定路径的变更就直接终止构建：

pipeline {
    agent { label 'Codebuild' }
    stages {
        stage('Check Path Changes') {
            steps {
                script {
                    // 遍历本次提交的所有变更路径，判断是否包含目标路径
                    def hasTargetChanges = scm.changeset.any { change ->
                        change.paths.any { path ->
                            // 这里可以用startsWith、contains或者正则来匹配路径
                            path.path.startsWith('some/path/')
                        }
                    }
                    if (!hasTargetChanges) {
                        error "No changes detected in 'some/path/', aborting build now."
                    }
                }
            }
        }
        stage('Do the magic') {
            steps {
                script {
                    // 你的任务逻辑
                }
            }
        }
    }
}

补充一句：你设想的trigger { include '/some/path' }语法虽然不是Jenkins的原生写法，但上面两种方式完全能实现相同的效果，而且都是Jenkins官方支持的配置方式～

另外要注意，路径匹配是相对于仓库根目录的相对路径，别写错了层级哦！

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