Jenkins流水线访问Git仓库文件遇路径问题及优化方案咨询

背景与现有实现 #

我是Jenkins新手，使用单体仓库（monorepo），需要根据文件变更情况确定构建内容。已创建名为Test的流水线，编写了检测变更文件的脚本：

def changedFiles = currentBuild.changeSets
    .collect { it.getItems() }
    .flatten() // 遍历所有提交，而非仅第一个
    .collect { it.getAffectedPaths() }
    .flatten()
    .toSet() // 确保路径唯一
echo("Changed files: ${changedFiles}")

def changedDirectories = changedFiles.collect {
    if (it.contains('folder/in/monorepo/project/foo')) { // 简化代码示例
        return "Foo"
    }
    return ''
}
.unique()
echo("Changed directories: ${changedDirectories}")

if (changedDirectories.contains("Foo")) {
    stage('Foo Build') {
        node {
            env.NODEJS_HOME = "${tool 'NodeJS'}"
            env.PATH="${env.NODEJS_HOME}/bin:${env.PATH}"
            dir("folder/in/monorepo/buildscripts/") {
                sh 'mybuildscript.sh'
            }
        }
    }
} else {
    echo("No Foo Build")
}

加载NodeJS的代码参考自NodeJS插件文档。安装Jenkins及NodeJS插件并更新其他插件后，遇到了路径问题：Git仓库未克隆到workspace目录，而是被克隆到带唯一ID的子文件夹，导致dir("folder/in/monorepo/buildscripts/")指令找不到仓库内的对应目录（会创建空目录而非指向仓库内的目录）。

我的问题 #

1. 有没有更简便的方式实现我的需求？我知道可能需要按Stack Overflow里的方法查找目录，但想找更简单的方案。
2. 这个安全修复会不会破坏所有构建/Jenkinsfile？毕竟流水线中通常需要调用仓库内的构建脚本、工具或make指令。

补充说明：我意识到问题源于使用“Pipeline script from SCM”且未勾选“Lightweight checkout”，推测正确方式是轻量检出Jenkinsfile后在脚本内克隆仓库；而直接在GUI编写的“Pipeline script”不会自动克隆仓库。

解决方案与解答 #

问题1：更简便的实现方式 #

有两种更简洁的方案可以替代手动收集变更文件的逻辑：

• 使用changeset条件判断：Jenkins流水线原生支持在stage中通过when指令判断指定路径下的文件是否变更，无需手动遍历变更集。示例：

stage('Foo Build') {
    when {
        changeset pattern: 'folder/in/monorepo/project/foo/**'
    }
    steps {
        node {
            env.NODEJS_HOME = "${tool 'NodeJS'}"
            env.PATH="${env.NODEJS_HOME}/bin:${env.PATH}"
            // 直接使用仓库内的相对路径执行脚本
            sh 'folder/in/monorepo/buildscripts/mybuildscript.sh'
        }
    }
}

• 手动控制仓库克隆路径：如果坚持不用轻量检出，可以在node块内手动克隆仓库到当前工作空间根目录，这样后续的相对路径就能正常工作：

node {
    // 手动克隆仓库到当前目录
    checkout scm: [$class: 'GitSCM', 
                  userRemoteConfigs: [[url: '你的Git仓库地址']], 
                  branches: [[name: '*/main']]], 
                  poll: false
    // 后续直接使用相对路径
    env.NODEJS_HOME = "${tool 'NodeJS'}"
    env.PATH="${env.NODEJS_HOME}/bin:${env.PATH}"
    sh 'folder/in/monorepo/buildscripts/mybuildscript.sh'
}

问题2：安全修复对现有构建的影响 #

这个变更（仓库克隆到带唯一ID的子文件夹）是Jenkins为了隔离不同流水线工作空间引入的安全优化，不会全部破坏现有构建，但会影响两类场景：

• 受影响的场景：使用“Pipeline script from SCM”且未勾选轻量检出，同时Jenkinsfile中直接依赖“仓库克隆在workspace根目录”的相对路径调用文件，这类流水线会因路径变化报错，需要调整为手动克隆到指定路径，或切换为轻量检出后在脚本内克隆仓库。
• 不受影响的场景：
  • 直接在GUI编写的“Pipeline script”：本身不会自动克隆仓库，路径逻辑不受影响。
  • 已使用轻量检出+手动克隆的流水线：本来就由脚本控制克隆路径，完全不受此变更影响。

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