容器与云原生 / 系统课时

组织文件与依赖安装

组织文件与依赖安装

Docker 构建效率很大程度取决于 Dockerfile 中文件复制和依赖安装的顺序。合理安排工作目录、依赖文件和源码复制步骤,可以最大化利用缓存,减少代码变化导致的重复安装。

学习目标

  • 理解 Docker 镜像层缓存的工作方式。
  • 掌握文件复制和依赖安装的推荐顺序。
  • 能够编写更高效、更容易维护的 Dockerfile。

Docker 构建缓存机制

Dockerfile 中每一条指令都会产生镜像层。只要某一层内容发生变化,该层之后的步骤通常都需要重新执行。

因此,变化频繁的源码文件应该尽量靠后复制,而变化较少的依赖描述文件应该提前处理。这样修改业务代码时,可以复用已经安装好的依赖层。

设计合理的复制顺序

典型 Node.js 项目通常先复制依赖清单,再安装依赖,最后复制业务代码。

dockerfile
FROM node:22-slim

WORKDIR /app

# 先复制依赖文件,让依赖安装层可以被缓存
COPY package.json package-lock.json ./
RUN npm ci

# 源码变化频繁,放在依赖安装之后
COPY . .

CMD ["node", "server.js"]

预期输出

text
npm ci completed successfully
Docker image build completed

如果先复制全部源码:

dockerfile
COPY . .
RUN npm ci

任何源码修改都会导致依赖安装层失效,增加构建时间。

管理构建上下文

Docker 构建时会把上下文目录发送给 Docker 引擎。无关文件进入上下文不仅增加传输时间,也可能被错误复制到镜像中。

可以通过 .dockerignore 排除不需要的内容。

text
node_modules
.git
*.log
.env

预期结果

text
Excluded files are not sent to Docker build context

依赖安装与文件组织策略

大型项目通常按照以下原则组织:

  • 依赖声明文件先复制并安装。
  • 配置文件根据是否参与构建决定复制时机。
  • 源代码最后复制,减少缓存失效范围。
  • 临时文件和本地开发文件加入忽略列表。

对于需要编译的应用,可以进一步使用多阶段构建,将编译工具和最终运行文件分离。

验证构建效果

构建镜像时可以观察缓存是否生效:

bash
docker build -t app-image .

预期输出

text
Step 1/6 : FROM node:22-slim
Using cache
Successfully built <IMAGE_ID>

如果修改源码后仍然重复执行依赖安装,通常说明 Dockerfile 层设计不合理。

常见错误排查

依赖安装缓慢时,先检查是否因为复制顺序导致缓存失效;镜像体积过大时,检查是否把开发依赖、日志或本地目录复制进去了。

构建路径混乱时,应重新划分项目目录和 Dockerfile 职责,让每一层只完成明确任务。

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

目录与阅读设置

阅读设置

17

记录一个想法

组织文件与依赖安装

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

登录哪都通