如何在Jenkins中配置源码仓库并使Pipeline识别Dockerfile？

问题核心原因 #

• 直接用顶级agent { dockerfile true }时，Jenkins会优先尝试构建镜像，但此时代码还未拉取，自然找不到Dockerfile。
• 分阶段使用独立agent时，每个stage的agent会创建独立工作空间，Checkout阶段拉取的代码不会自动共享到Build阶段的dockerfile agent工作空间，导致依然找不到Dockerfile。

解决方案1：复用工作空间（推荐） #

在Build阶段的dockerfile配置中添加reuseNode: true，让dockerfile agent复用之前Checkout阶段的工作空间，从而访问到已拉取的Dockerfile：

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                checkout scmGit(branches: [[name: '*/master']], extensions: [], userRemoteConfigs: [[url: '/myPath/myRepo/']])
            }
        }
        stage('Build') {
            agent { 
                dockerfile {
                    filename 'Dockerfile' // 可省略，默认找根目录的Dockerfile
                    reuseNode true // 关键：复用当前节点的工作空间
                }
            }
            steps {
                sh 'python3 --version'
            }
        }
    }
}

解决方案2：同阶段内完成代码检出与镜像构建 #

如果场景简单，可以把代码检出和镜像构建放在同一个stage，手动控制镜像构建流程，避免工作空间隔离问题：

pipeline {
    agent any
    stages {
        stage('Build & Test') {
            steps {
                checkout scmGit(branches: [[name: '*/master']], extensions: [], userRemoteConfigs: [[url: '/myPath/myRepo/']])
                script {
                    // 基于当前目录的Dockerfile构建镜像
                    def customImage = docker.build("my-python-image", ".")
                    // 在构建好的镜像内执行测试步骤
                    customImage.inside {
                        sh 'python3 --version'
                    }
                }
            }
        }
    }
}

关键注意事项 #

• 确保Jenkins容器能访问本地Git仓库：启动Jenkins容器时，需要挂载本地Git仓库路径到容器内，例如：

  docker run -d -p 8080:8080 -v /myPath/myRepo:/myPath/myRepo:ro jenkins/jenkins:2.401.3
  

• Dockerfile路径检查：如果Dockerfile不在Git仓库根目录，需要在dockerfile配置中指定目录，例如：

  dockerfile {
      dir 'docker' // 指定Dockerfile所在的子目录
      reuseNode true
  }
  

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