容器与云原生 / 系统课时

拆分开发与生产构建

拆分开发与生产构建

本课解决容器镜像在开发阶段和生产阶段需求不同的问题,通过多阶段构建或独立 Dockerfile 分离开发工具、测试依赖与最终运行环境,得到体积更小、更安全、更适合部署的生产镜像。

学习目标

  • 理解开发镜像与生产镜像的职责差异
  • 掌握 Docker 多阶段构建拆分构建环境和运行环境
  • 能根据项目规模选择合适的镜像管理方式

为什么要拆分构建环境

开发环境通常包含编译器、调试工具、测试框架和依赖缓存,而生产环境只需要运行应用所需的最小文件。如果把所有内容放入一个镜像,会导致镜像体积增加,也会扩大攻击面。

生产构建的核心目标是让最终镜像只保留运行时内容。开发阶段负责生成产物,生产阶段负责运行产物,两者通过构建过程连接,而不是共享完整环境。

使用多阶段 Dockerfile

多阶段构建允许一个 Dockerfile 定义多个阶段。前一个阶段安装依赖并生成应用产物,后一个阶段只复制需要的文件。

dockerfile
FROM node:22 AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM nginx:alpine AS production
COPY --from=build /app/dist /usr/share/nginx/html
EXPOSE 80

预期结果

text
构建完成后生成的镜像只包含 nginx 运行环境和 dist 静态文件,不包含 Node.js 构建工具。

这里的 build 阶段负责创建产物,production 阶段负责提供服务。COPY --from 是拆分开发依赖和运行依赖的关键语法。

使用独立 Dockerfile 管理场景

当开发、测试和生产环境差异较大时,可以维护多个 Dockerfile,例如 Dockerfile.dev 用于热更新开发,Dockerfile 用于生产发布。

bash
docker build -f Dockerfile.dev -t app-dev .
docker build -f Dockerfile -t app-prod .

预期结果

text
app-dev    用于本地开发调试
app-prod   用于生产部署

独立 Dockerfile 更容易表达环境差异,但需要额外维护文件。项目较大时,可以结合公共基础镜像减少重复配置。

常见拆分错误

不要在生产镜像中保留源码、测试依赖和构建缓存。也不要为了减少文件数量,把开发工具强行塞入生产镜像,这会让部署环境变得难以控制。

验证生产镜像时,可以检查镜像层和运行内容,确认不存在不需要的开发文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

拆分开发与生产构建

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

登录哪都通