2、Dockerfile 最佳实践：减少层数、合并 RUN 命令、使用 .dockerignore 文件

在容器镜像构建过程中，Dockerfile 的编写质量直接决定了镜像的体积、构建速度以及运行时的 I/O 性能。每一行指令都会生成一个只读层（Layer），过多的层数不仅会膨胀镜像体积，还会在容器启动时增加联合文件系统的挂载开销。本章聚焦于三个核心最佳实践：减少层数、合并 RUN 命令以及使用 .dockerignore 文件，帮助你在发布流水线中构建更轻量、更高效的容器镜像。

2.1 层数对 I/O 性能的影响

Docker 镜像由多个只读层堆叠而成，每个层代表 Dockerfile 中的一条指令。当容器启动时，这些层会被挂载为联合文件系统（如 OverlayFS）。层数越多，文件查找路径越长，元数据操作（如 stat、open）的延迟越高。

2.2 减少层数的核心策略

减少层数并不意味着牺牲可读性，而是通过合理的指令合并和顺序优化，在保持 Dockerfile 清晰的同时降低层数。以下是三种最有效的策略：

2.3 合并 RUN 命令的最佳实践

合并 RUN 命令是减少层数最直接的手段。每个 RUN 指令都会创建一个新层，即使该指令只执行了简单的清理操作。通过使用 && 连接符，可以将多个命令合并到同一个层中。

反例：未合并的 RUN 命令

FROM ubuntu:22.04
RUN apt-get update
RUN apt-get install -y curl wget
RUN apt-get clean
RUN rm -rf /var/lib/apt/lists/*
RUN mkdir -p /app
COPY app.sh /app/
RUN chmod +x /app/app.sh

上述 Dockerfile 产生了 7 个层，其中多个层仅用于清理和文件操作，浪费了层数资源。

正例：合并后的 RUN 命令

FROM ubuntu:22.04
RUN apt-get update && \
    apt-get install -y curl wget && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*
RUN mkdir -p /app
COPY app.sh /app/
RUN chmod +x /app/app.sh

合并后减少到 4 个层，且所有临时文件在同一层内被清理，不会传递到后续层。

2.4 使用 .dockerignore 文件

.dockerignore 文件的作用类似于 .gitignore，用于在构建上下文中排除不必要的文件和目录。构建上下文会被打包发送到 Docker 守护进程，过大的上下文不仅拖慢构建速度，还会导致不必要的层变更。

.dockerignore 文件示例

# 版本控制
.git/
.gitignore

# 依赖目录
node_modules/
vendor/
bower_components/

# 构建产物
dist/
build/
*.tar.gz

# 日志和临时文件
*.log
*.tmp
.cache/

# 环境配置
.env
.env.local
*.pem

# IDE 配置
.idea/
.vscode/
*.swp

2.5 综合对比：优化前后的效果

以下表格展示了应用上述最佳实践前后，一个典型 Node.js 应用的镜像构建指标对比：

2.6 实践检查清单

在编写或审查 Dockerfile 时，可以使用以下清单确保遵循了最佳实践：

• 层数检查： 最终镜像层数是否控制在 10 层以内？
• RUN 合并： 所有安装、配置、清理操作是否合并到同一个 RUN 块中？
• .dockerignore： 是否已创建 .dockerignore 文件并排除了不必要的目录？
• 构建上下文： 使用 docker build -t myapp . 时，上下文大小是否小于 50 MB？
• 缓存利用： 是否将不常变更的层（如基础镜像、依赖安装）放在 Dockerfile 前面？
• 多阶段构建： 是否已使用多阶段构建分离构建环境和运行环境？