CI/CD / 系统课时
用 Docker 提供一次性构建环境
用 Docker 提供一次性构建环境
共享 Jenkins Agent 很容易因 JDK、Node.js 或构建工具版本变化而出现“昨天能构建、今天失败”。使用 Docker Agent 可以让阶段在指定镜像中执行,把工具版本写进 Jenkinsfile,并在任务结束后释放一次性容器环境。
学习目标
- 使用 Declarative Pipeline 的 Docker Agent 固定构建工具版本
- 理解宿主 Agent、Docker 容器与 Workspace 的关系
- 验证命令确实运行在指定容器环境中
Docker Agent 解决什么问题
传统节点需要预先安装项目所需的全部工具。多个项目共享节点时,一个项目升级 Maven 或 Node.js 可能影响另一个项目。Docker Agent 把这些依赖放入镜像,由 Pipeline 明确选择所需环境。
Jenkins 仍然需要先找到能够运行 Docker 工作负载的 Agent,再启动指定镜像执行该阶段。容器是执行环境,不等于 Jenkins Agent 基础设施本身。

在阶段中指定 Docker 镜像
下面使用 Jenkins Declarative Pipeline 的 agent { docker { ... } }。运行它的 Jenkins 环境必须已经提供 Docker Pipeline 能力,并且存在能够执行 Docker 容器的 Agent。
pipeline {
agent none
stages {
stage('Build') {
agent {
docker {
image 'maven:3.9.9-eclipse-temurin-21'
}
}
steps {
sh 'mvn --version'
}
}
}
}预期输出
Apache Maven 3.9.9
Java version: 21完整的 mvn --version 还会显示 Maven home、JVM、操作系统等信息,具体文本随镜像平台和运行环境变化。关键验证点是 Maven 主版本为 3.9.9,Java 主版本为 21。
固定镜像版本而不是依赖宿主工具
镜像名同时描述了 Maven 和 JDK 版本,因此 Jenkins Agent 宿主机无需为这个阶段维护同一套 Maven/JDK 安装。项目升级工具链时,可以通过修改 Jenkinsfile 中的镜像版本完成显式变更,并接受代码审查。
生产流水线还应谨慎使用 latest 之类会漂移的标签。即使 Jenkinsfile 没变,标签指向的镜像内容变化也可能让两次构建使用不同环境。需要更强可复现性时,可以使用组织验证过的不可变镜像策略。
验证工具来自容器
可以让阶段同时打印 Maven、Java 和容器内操作系统信息,以确认实际环境。以下 Jenkinsfile 是可独立运行的验证示例。
pipeline {
agent none
stages {
stage('Verify Environment') {
agent {
docker {
image 'maven:3.9.9-eclipse-temurin-21'
}
}
steps {
sh '''
mvn --version
java -version
cat /etc/os-release | head -n 2
'''
}
}
}
}预期输出
Apache Maven 3.9.9
Java version: 21
<OS_RELEASE_INFORMATION>java -version 的部分输出通常写入标准错误,Jenkins 控制台仍会收集显示;操作系统发行版文本取决于当前镜像内容,因此用 <OS_RELEASE_INFORMATION> 表示动态结果。
使用一次性环境时仍要控制边界
Docker Agent 特别适合编译、单元测试、静态检查等需要固定工具链的阶段。若构建还需要访问私有仓库、Docker daemon 或其他宿主资源,应显式配置凭据和访问方式,而不是为了方便直接扩大容器权限。
当流水线成功显示预期 Maven 与 Java 版本后,再检查阶段结束后没有继续依赖容器内临时文件。需要跨阶段保存的构建结果应通过 stash、归档或制品仓库传递,而不是假定下一阶段还能访问已经结束的一次性容器。