在Jenkins K8s代理中使用Groovy创建文件失败的问题排查

核心原因 #

你遇到的问题本质是Groovy的new File()方法是在Jenkins Master节点的JVM中执行的，而非你配置的K8s代理节点。即使K8s代理容器里的/agent/workspace/testjob目录确实存在，Jenkins Master服务器上并没有这个路径，所以执行createNewFile()时会提示"No such file or directory"。

正确的解决方案 #

在Jenkins Pipeline中，要在代理节点操作文件，必须使用Pipeline提供的跨节点兼容的内置步骤，或者直接通过shell命令操作，以下是两种可行方案：

方案1：使用Pipeline内置的writeFile步骤 #

writeFile是Jenkins官方推荐的文件操作步骤，会自动在当前关联的代理节点执行：

stage('Test New file') {
    steps {
        script {
            def filePath = "/agent/workspace/testjob/Dockerfile"
            if (!fileExists(filePath)) { // 用Pipeline内置的fileExists检查文件
                writeFile file: filePath, text: '' // 创建空文件
                println "File '${filePath}' created successfully."
            } else {
                println "File '${filePath}' already exists."
            }
        }
    }
}

方案2：使用shell命令创建文件 #

直接通过sh步骤在K8s代理容器中执行shell命令，更适合熟悉Linux操作的场景：

stage('Test New file') {
    steps {
        script {
            def filePath = "/agent/workspace/testjob/Dockerfile"
            sh """
                if [ ! -f ${filePath} ]; then
                    touch ${filePath}
                    echo "File '${filePath}' created successfully."
                else
                    echo "File '${filePath}' already exists."
                fi
            """
        }
    }
}

关键注意事项 #

• 永远不要在Jenkins Pipeline中直接使用Groovy的File类操作代理节点的文件，这类代码只会在Master节点执行，除非你的Pipeline明确在Master上运行。
• 优先使用Jenkins Pipeline提供的内置步骤（如writeFile、readFile、fileExists），它们是为跨节点执行设计的，兼容性更好。

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