Docker 多阶段构建(Multi-stage Build)的实战技巧?

阿磊酱_7996

阿磊酱_7996

2025-07-01

892人浏览

原创

多阶段构建通过分阶段使用不同镜像提升镜像效率与安全性。其核心好处是减小体积、提高安全性和可能加快构建速度。具体实现包括:1. 明确应用运行所需依赖和文件;2. 构建阶段选择含工具的镜像,运行阶段选择轻量镜像;3. dockerfile 中使用多个 from 指令定义阶段,并通过 copy --from= 引用前一阶段产物;4. 构建并验证镜像。优化方法包括利用缓存、清理临时文件、使用 .dockerignore 和更小基础镜像。常见问题需注意依赖缺失、权限问题、环境变量差异和缓存失效。在 ci/cd 中可用于集成构建测试、安全扫描和镜像推送流程。

Docker 多阶段构建(Multi-stage Build)的实战技巧?

Docker 多阶段构建,简单来说,就是在一个 Dockerfile 里使用多个 FROM 指令。这样做的好处?体积更小,安全更高,构建速度可能更快!直接理解成“搭积木”,先用一个镜像编译,再用另一个镜像把编译好的东西搬过去,就完事儿了。

解决方案

多阶段构建的核心思想是将构建过程分解为多个阶段,每个阶段使用不同的基础镜像,最终只保留最终运行所需的最小依赖。这听起来有点像软件工程里的“最小权限原则”。

  1. 明确需求: 首先,你需要明确你的应用运行需要哪些依赖,哪些文件。哪些是构建时需要的,哪些是运行时需要的?

  2. 选择基础镜像: 选择合适的基础镜像至关重要。构建阶段可以选择包含所有构建工具的镜像,例如 Maven 或 Node.js 镜像。运行阶段则可以选择更轻量级的镜像,例如 Alpine Linux 或 distroless 镜像。

  3. 编写 Dockerfile: 在 Dockerfile 中,使用 FROM 指令定义每个阶段。每个 FROM 指令都创建一个新的构建阶段。你可以为每个阶段命名,方便后续引用。

    # 构建阶段
    FROM maven:3.8.6-jdk-11 AS builder
    WORKDIR /app
    COPY pom.xml .
    COPY src ./src
    RUN mvn clean install -DskipTests
    
    # 运行阶段
    FROM openjdk:11-jre-slim
    WORKDIR /app
    COPY --from=builder /app/target/*.jar app.jar
    EXPOSE 8080
    ENTRYPOINT ["java", "-jar", "app.jar"]

    这个例子中,maven:3.8.6-jdk-11 用于构建 Java 应用,openjdk:11-jre-slim 用于运行。COPY --from=builder 指令将构建阶段生成的 jar 包复制到运行阶段。注意 --from=builder 这里的 builder 就是上面 FROM maven... AS builder 里的别名。

  4. 构建镜像: 使用 docker build 命令构建镜像。

    docker build -t my-app .
  5. 验证: 构建完成后,运行镜像并验证其功能是否正常。

如何优化 Docker 多阶段构建?

优化多阶段构建,其实就是在精简镜像体积上下功夫。毕竟,小即是美。

  1. 利用缓存: Docker 镜像层具有缓存机制。如果 Dockerfile 中的指令没有发生变化,Docker 会直接使用缓存,避免重复执行。所以,尽量将不常变化的指令放在前面,例如安装依赖。

  2. 清理临时文件: 在每个阶段结束时,清理不再需要的临时文件。例如,在构建阶段编译完成后,可以删除源代码和构建工具。

  3. 使用 .dockerignore 文件: .dockerignore 文件用于排除不需要的文件和目录,例如日志文件、构建缓存等。这可以减小镜像体积,提高构建速度。

    Docker部署助手
    Docker部署助手

    「在我电脑上明明能跑」——因为少了Docker。帮你写Dockerfile、构建镜像、配置多环境、编排docker-compose,从本地开发到服务器部署一条龙。支持Node.js/Python/Go/Java/前端全栈,覆盖CI/CD集成、安全加固、监控告警,告别环境不一致的噩梦。 触发词:Docker部署、容...

    下载
  4. 选择更小的基础镜像: 不同的基础镜像体积差异很大。例如,Alpine Linux 镜像体积非常小,适合作为运行阶段的基础镜像。Distroless 镜像则更进一步,只包含运行应用所需的最小依赖。

多阶段构建的常见坑有哪些?

多阶段构建虽好,但也有一些坑需要注意。

  1. 依赖缺失: 确保运行阶段的基础镜像包含应用运行所需的所有依赖。如果依赖缺失,应用可能无法启动或运行出错。

  2. 文件权限问题: 从一个阶段复制到另一个阶段的文件,可能会出现权限问题。确保目标阶段具有访问这些文件的权限。

  3. 环境变量: 不同阶段的环境变量可能不同。确保在每个阶段设置正确的环境变量。

  4. 缓存失效: 如果 Dockerfile 中的指令发生变化,缓存就会失效。这会导致 Docker 重新执行所有指令,增加构建时间。

  5. 构建上下文: docker build 命令的构建上下文是指 Dockerfile 所在的目录。确保构建上下文中包含所有需要的文件。

多阶段构建在 CI/CD 中的应用?

在 CI/CD 流水线中,多阶段构建可以发挥更大的作用。

  1. 构建和测试: 可以使用一个阶段进行构建和单元测试,另一个阶段进行集成测试。

  2. 安全扫描: 可以在构建阶段进行安全扫描,例如漏洞扫描和静态代码分析。

  3. 镜像推送: 只有通过所有测试和安全扫描的镜像才能被推送到镜像仓库。

通过将构建、测试和安全扫描集成到多阶段构建中,可以提高软件质量和安全性,并实现持续交付。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

2025.09.15

4940

19

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

2026.05.09

429

25

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

5176

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

1495

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1978

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

10703

11

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1080

4

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3324

5

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.14

1709

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Docker Desktop故障排查手册
Docker Desktop故障排查手册

共0课时 | 0人学习

Docker镜像构建手册
Docker镜像构建手册

共0课时 | 0人学习