如何基于原有Docker镜像运行仅含变更的新镜像？

当然可以实现仅推送变更内容、基于原有镜像生成新镜像的需求，核心是利用Docker的分层镜像架构，结合以下几种实践方案：

1. 重构Dockerfile，最大化缓存复用 #

Docker镜像由多层只读层叠加而成，构建时会复用未变更的层。调整Dockerfile的指令顺序，将不变的内容放在前面，频繁变更的代码放在最后：

• 先COPY依赖描述文件（如package.json、requirements.txt），再执行依赖安装命令（npm install/pip install）
• 最后COPY应用代码

示例Dockerfile：

FROM python:3.9-slim
WORKDIR /app

# 先复制依赖文件，复用缓存层
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 最后复制应用代码，仅这一层会频繁变更
COPY . .

CMD ["python", "app.py"]

这样每次更新代码时，只有最后一层会变化，推送/拉取的仅为这一层的增量（远小于5GB）。

2. 启用Docker BuildKit实现增量推送 #

BuildKit是Docker的新一代构建引擎，支持更高效的分层缓存与增量镜像推送。开启后，构建并推送镜像时只会上传变更的层：

• 临时开启：执行构建命令前添加环境变量

  DOCKER_BUILDKIT=1 docker build --push -t your-registry/your-image:latest .
  

• 永久开启：修改/etc/docker/daemon.json添加配置，重启Docker服务

  {
    "features": {
      "buildkit": true
    }
  }
  

3. 手动基于原有镜像生成增量镜像（离线/特殊场景） #

如果无法使用镜像仓库的分层推送功能，可以手动提取变更内容，在生产环境基于原有镜像生成新镜像：

1. 本地构建新镜像后，对比新旧镜像的文件差异：

   docker diff old-image-id new-image-id > changes.txt
   

2. 根据changes.txt打包所有新增/修改的文件
3. 生产环境加载原有镜像并启动临时容器：

   docker run -d --name temp-container old-image-id sleep 3600
   

4. 将打包的变更文件复制到临时容器：

   docker cp ./changes-files temp-container:/app/
   

5. 提交临时容器为新镜像：

   docker commit temp-container new-image:tag
   

6. 停止并删除临时容器：

   docker stop temp-container && docker rm temp-container
   

4. 多阶段构建缩小镜像体积（附带优化） #

通过多阶段构建分离构建环境与运行环境，大幅减小最终镜像的体积，同时让变更层更轻量化：
示例Dockerfile（Node.js应用）：

# 构建阶段（包含编译依赖，体积大但不常变更）
FROM node:18 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

# 运行阶段（轻量镜像，仅包含编译后的产物）
FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html

最终运行镜像仅包含Nginx和编译后的静态文件，每次更新仅需推送dist目录对应的层，体积可能从5GB降至几十MB。

注意事项 #

• 确保镜像仓库支持Docker分层存储（主流仓库如Docker Hub、Harbor、阿里云镜像仓库均支持）
• 生产环境拉取镜像时，Docker会自动仅下载缺失的层，无需手动处理
• 定期清理生产环境的旧镜像与无用层，避免存储冗余：docker image prune -a

内容的提问来源于stack exchange，提问作者Philippe