如何在Jenkins流水线中将源码仓库文件传入Agent Dockerfile？

当你使用Jenkins的dockerfile agent时，默认流程是Jenkins先把Git仓库的代码完整检出到流水线工作区，再基于指定的Dockerfile构建代理镜像。问题的核心是要确保Dockerfile能访问到工作区里的requirements.txt，调整方式如下：

1. 调整Dockerfile的COPY路径 #

假设你的仓库结构是这样的：

仓库根目录/
├── requirements.txt
├── ci/
│   └── unit_test/
│       └── Dockerfile
└── ...

因为构建镜像时的上下文是流水线工作区的根目录（也就是仓库根目录），所以在ci/unit_test/Dockerfile里可以用相对路径复制requirements.txt：

# 替换为你需要的基础Python镜像
FROM python:3.10-slim

# 从构建上下文（仓库根目录）复制requirements.txt到镜像临时目录
COPY requirements.txt /tmp/

# 安装依赖，--no-cache-dir可以减小镜像体积
RUN pip install --no-cache-dir -r /tmp/requirements.txt

# 可选：设置后续流水线步骤的工作目录
WORKDIR /app

2. 优化Jenkinsfile配置（可选但更清晰） #

虽然默认构建上下文就是工作区根目录，但显式指定context参数能让配置更易读，避免后续混淆：

/* Requires the Docker Pipeline plugin */
pipeline {
    agent {
        dockerfile {
            dir 'ci/unit_test'  // 指定Dockerfile所在的子目录
            context '.'         // 指定构建上下文为工作区根目录
        }
    }
    stages {
        stage('验证依赖安装') {
            steps {
                sh 'pip list | grep -E "(你的目标依赖包名)"'  // 验证依赖是否成功安装
            }
        }
        // 其他业务阶段...
    }
}

关于你之前的报错 #

在agent阶段直接写checkout scm是错误的，因为agent块仅用于定义执行环境，不能直接放置步骤逻辑。Jenkins默认会在启动代理镜像前自动检出Git仓库代码，除非你特意设置了skipDefaultCheckout: true，所以完全不需要手动添加这一步。

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