Docker 101 教程：深入理解镜像构建最佳实践

镜像分层机制解析

在 Docker 中，镜像是通过分层（Layer）的方式构建的，理解这一机制对于优化镜像构建至关重要。通过 docker image history 命令，我们可以清晰地查看镜像的组成结构。

查看镜像分层

执行以下命令查看之前构建的 docker-101 镜像的分层情况：

docker image history docker-101

输出结果示例：

IMAGE               CREATED             CREATED BY                                      SIZE                COMMENT
a78a40cbf866        18s ago      /bin/sh -c #(nop)  CMD ["node" "/app/src/ind…   0B                  
f1d1808565d6        19s ago      /bin/sh -c yarn install --production            85.4MB              
a2c054d14948        36s ago      /bin/sh -c #(nop) COPY dir:5dc710ad87c789593…   198kB               
9577ae713121        37s ago      /bin/sh -c #(nop) WORKDIR /app                  0B                  
b95baba1cfdb        7w ago       /bin/sh -c #(nop)  CMD ["node"]                 0B

每行代表一个镜像层，最底层是基础镜像，最上层是最近添加的层。通过这个视图，我们可以直观地看到每个层的大小，这对于诊断镜像体积过大问题非常有帮助。

查看完整命令

默认情况下，输出可能会被截断。添加 --no-trunc 参数可以查看完整命令：

docker image history --no-trunc docker-101

分层缓存优化策略

理解分层机制后，我们可以利用它来优化构建过程。一个关键原则是：

当某一层发生变化时，所有后续层都需要重新构建

原始 Dockerfile 分析

考虑以下原始 Dockerfile：

FROM node:10-alpine
WORKDIR /app
COPY . .
RUN yarn install --production
CMD ["node", "/app/src/index.js"]

这种写法的问题是，每次源代码有变动（即使只是修改了一个HTML文件），都会导致 COPY . . 层变化，进而触发 yarn install 重新执行，这在大多数情况下是不必要的。

优化后的 Dockerfile

更聪明的做法是先只复制 package.json 和 yarn.lock 文件，安装依赖，然后再复制其他文件：

FROM node:10-alpine
WORKDIR /app
COPY package.json yarn.lock ./
RUN yarn install --production
COPY . .
CMD ["node", "/app/src/index.js"]

这样修改后：

1. 只有当 package.json 或 yarn.lock 变化时，才会重新安装依赖
2. 修改源代码文件不会触发依赖重新安装
3. 构建速度显著提升

实际效果验证

修改 src/static/index.html 后重新构建，你会看到前四步都使用了缓存：

Step 1/6 : FROM node:10-alpine
---> Using cache
Step 2/6 : WORKDIR /app
---> Using cache
Step 3/6 : COPY package* yarn.lock ./
---> Using cache
Step 4/6 : RUN yarn install --production
---> Using cache

这种优化对于大型项目特别有价值，可以节省大量构建时间。

多阶段构建进阶技巧

多阶段构建（Multi-stage build）是 Docker 的高级特性，它能带来两个主要好处：

1. 分离构建时依赖和运行时依赖
2. 显著减小最终镜像体积

Java 应用示例

对于 Java 应用，构建时需要 JDK 和 Maven，但运行时只需要 JRE 和 Tomcat：

FROM maven AS build
WORKDIR /app
COPY . .
RUN mvn package

FROM tomcat
COPY --from=build /app/target/file.war /usr/local/tomcat/webapps

这个例子中：

• 第一阶段使用 Maven 镜像完成构建
• 第二阶段只复制构建产物到 Tomcat 镜像
• 最终镜像不包含 JDK 和 Maven，体积更小

React 应用示例

React 应用构建时需要 Node 环境，但运行时只需要静态文件：

FROM node:10 AS build
WORKDIR /app
COPY package* yarn.lock ./
RUN yarn install
COPY public ./public
COPY src ./src
RUN yarn run build

FROM nginx:alpine
COPY --from=build /app/build /usr/share/nginx/html

这种构建方式：

1. 使用 Node 镜像完成所有构建工作
2. 将构建产物复制到轻量级的 Nginx 镜像
3. 最终镜像不包含 Node 环境，更安全、更小巧

最佳实践总结

1. 分层缓存利用：合理安排 Dockerfile 指令顺序，最大化利用构建缓存
2. 最小化层数：合并相关指令，减少不必要的层
3. 多阶段构建：分离构建环境和运行环境，减小镜像体积
4. 精确复制：只复制必要的文件，避免意外包含大文件或敏感信息
5. 基础镜像选择：优先使用官方维护的轻量级镜像（如 alpine 版本）

通过掌握这些技巧，你可以构建出更高效、更安全的 Docker 镜像，显著提升开发和部署效率。