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 基础设施本身。

Jenkins Agent 启动一次性 Docker 构建容器的关系

在阶段中指定 Docker 镜像

下面使用 Jenkins Declarative Pipeline 的 agent { docker { ... } }。运行它的 Jenkins 环境必须已经提供 Docker Pipeline 能力,并且存在能够执行 Docker 容器的 Agent。

groovy
pipeline {
    agent none

    stages {
        stage('Build') {
            agent {
                docker {
                    image 'maven:3.9.9-eclipse-temurin-21'
                }
            }
            steps {
                sh 'mvn --version'
            }
        }
    }
}

预期输出

text
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 是可独立运行的验证示例。

groovy
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
                '''
            }
        }
    }
}

预期输出

text
Apache Maven 3.9.9
Java version: 21
<OS_RELEASE_INFORMATION>

java -version 的部分输出通常写入标准错误,Jenkins 控制台仍会收集显示;操作系统发行版文本取决于当前镜像内容,因此用 <OS_RELEASE_INFORMATION> 表示动态结果。

使用一次性环境时仍要控制边界

Docker Agent 特别适合编译、单元测试、静态检查等需要固定工具链的阶段。若构建还需要访问私有仓库、Docker daemon 或其他宿主资源,应显式配置凭据和访问方式,而不是为了方便直接扩大容器权限。

当流水线成功显示预期 Maven 与 Java 版本后,再检查阶段结束后没有继续依赖容器内临时文件。需要跨阶段保存的构建结果应通过 stash、归档或制品仓库传递,而不是假定下一阶段还能访问已经结束的一次性容器。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Docker 提供一次性构建环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通