容器与云原生 / 系统课时
拆分开发与生产构建
拆分开发与生产构建
本课解决容器镜像在开发阶段和生产阶段需求不同的问题,通过多阶段构建或独立 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 更容易表达环境差异,但需要额外维护文件。项目较大时,可以结合公共基础镜像减少重复配置。
常见拆分错误
不要在生产镜像中保留源码、测试依赖和构建缓存。也不要为了减少文件数量,把开发工具强行塞入生产镜像,这会让部署环境变得难以控制。
验证生产镜像时,可以检查镜像层和运行内容,确认不存在不需要的开发文件。
按自己的节奏,确认真正理解。