Jenkins声明式流水线：如何从Git获取Dockerfile.ci（agent块先执行）

这个问题确实挺典型的——声明式流水线的顶级agent块会在所有阶段执行前就启动容器，这时候代码还没从Git拉下来，自然找不到Dockerfile.ci。我给你两个实用的解决方案，都是实际项目里常用的：

方案1：顶级agent设为none + 分阶段拉取+暂存代码 #

这是最通用的方案，不管你的Jenkins是动态分配节点还是固定节点都能用：

pipeline {
    agent none // 关闭顶级agent，避免提前启动Docker容器
    stages {
        stage('拉取代码') {
            agent any // 用任意可用节点拉取Git代码
            steps {
                git(url: 'https://www.github.com/...', credentialsId: 'CREDENTIALS', branch: "develop")
                // 把拉取的所有代码暂存起来，供后续阶段跨节点使用
                stash(name: 'project-source', includes: '**/*')
            }
        }
        stage('用Dockerfile构建并运行') {
            agent {
                dockerfile {
                    filename 'Dockerfile.ci' // 现在能找到这个文件了
                }
            }
            steps {
                // 取出之前暂存的代码到当前容器的工作区
                unstash(name: 'project-source')
                // 这里可以执行你的构建、测试命令了
                sh 'mvn clean package' // 举个例子，换成你实际的命令
            }
        }
        // 其他业务阶段...
    }
}

关键说明： #

• agent none是核心：让流水线不会在启动时就尝试构建Docker镜像，给了我们先拉代码的机会
• stash和unstash：因为不同阶段的agent可能跑在不同节点上，这两个命令能帮我们把代码在节点间共享，确保Docker构建时能拿到Dockerfile.ci

方案2：固定节点+复用节点（更简洁） #

如果你的Jenkins是用固定节点（不是动态分配的云节点），可以省去暂存代码的步骤，直接复用拉取代码的节点：

pipeline {
    agent none
    stages {
        stage('拉取代码') {
            agent { label 'my-fixed-node' } // 指定你的固定节点标签
            steps {
                git(url: 'https://www.github.com/...', credentialsId: 'CREDENTIALS', branch: "develop")
            }
        }
        stage('用Dockerfile构建并运行') {
            agent {
                dockerfile {
                    filename 'Dockerfile.ci'
                    reuseNode true // 关键：复用上面拉取代码的节点，工作区代码还在
                }
            }
            steps {
                // 直接使用节点工作区里的代码，不用再暂存/取出
                sh 'echo "直接用已拉取的代码构建镜像"'
            }
        }
    }
}

关键说明： #

• reuseNode true会让Docker容器在拉取代码的同一个节点上启动，节点的工作区里已经有Git拉下来的代码，所以Jenkins能直接找到Dockerfile.ci
• 这个方案更简洁，但只适用于固定节点的场景，动态节点不适用（因为节点可能被回收，工作区代码会丢失）

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