如何用Docker镜像提供静态文件内容？求最优架构方案

问题描述 #

我之前好像见过类似示例，但在Docker标签书签和《Docker in Action》里都没找到。目前负责的系统里有两个Docker容器：一个是Nginx Web服务器，另一个是Java应用服务器。现在Java应用服务器同时处理站点静态内容（HTML、JS、CSS），导致非Java部分的构建和部署和应用服务器强耦合，我想把两者解耦。

我的目标是生成第三个只提供静态Web应用文件的容器，可以按需轻松更新替换。我查过Docker volumes相关内容，但不确定这是不是我需要的方案。我只需要一个包含若干文件的容器，以只读方式把这些文件挂载到Nginx容器的指定挂载点。

我设想的大致步骤是：

• 基于node.js镜像开始构建
• 复制本地git仓库中的内容
• 执行yarn install和yarn build，生成build/目录
• 将build/目录内容复制到独立位置
• 最终得到仅包含构建结果的容器

请问这个方案可行吗？或者Docker生态里有没有更优的架构方式？

回答 #

你的方案完全可行，且属于Docker多阶段构建的典型场景 #

以下是针对需求的具体优化和架构建议：

一、用多阶段构建精简静态资源镜像

你设想的流程可以通过Docker多阶段构建实现，既能完成静态资源的编译构建，又能剥离Node.js构建环境的冗余内容，生成仅含最终产物的轻量镜像。示例Dockerfile如下：

# 第一阶段：构建静态资源（仅用于编译，不进入生产镜像）
FROM node:latest AS builder
WORKDIR /app
# 先复制依赖文件，利用Docker缓存加速后续构建
COPY package.json yarn.lock ./
RUN yarn install --frozen-lockfile
# 复制项目源码
COPY . .
# 执行构建命令生成静态文件
RUN yarn build

# 第二阶段：生成仅含静态资源的生产镜像
# 用scratch空镜像最精简，仅保留构建产物
FROM scratch
# 从builder阶段复制构建好的静态文件
COPY --from=builder /app/build /static-content

# 可选：如果想直接用Nginx提供静态资源，第二阶段可替换为Nginx镜像
# FROM nginx:alpine
# COPY --from=builder /app/build /usr/share/nginx/html
# 此方式可直接启动Nginx服务，无需额外挂载到其他容器

二、将静态资源挂载到现有Nginx容器的两种方式

如果坚持要把静态资源容器挂载到已有的Nginx容器，有两种常用实现：

1. 使用--volumes-from参数共享容器文件
   先创建静态资源容器（无需运行，仅作为存储载体）：

   docker create --name static-files your-static-image
   

   启动Nginx容器时以只读方式挂载该容器的文件：

   docker run -d --name nginx --volumes-from static-files:ro nginx
   

2. 使用Docker卷（Volumes）管理静态资源
   卷的方式更灵活，可独立管理资源更新：

   # 创建独立卷
   docker volume create static-content
   # 通过临时容器将静态资源复制到卷中
   docker run --rm -v static-content:/target your-static-image cp -r /static-content/* /target/
   # 启动Nginx并以只读方式挂载卷
   docker run -d -v static-content:/usr/share/nginx/html:ro nginx
   

   更新静态资源时，只需重新执行复制步骤即可覆盖卷内文件。

三、更优架构建议：直接部署静态资源Nginx服务

如果场景允许，推荐直接在构建阶段生成带Nginx的静态资源镜像，符合Docker“一个容器一个服务”的设计理念，部署和更新更简单：

• 更新静态资源时，重新构建镜像并替换旧容器即可；
• 可结合Docker Compose编排所有服务，示例docker-compose.yml：

version: '3.8'
services:
  java-app:
    image: your-java-app-image
    ports:
      - "8080:8080"

  static-web:
    build: ./static-web # 指向包含多阶段Dockerfile的目录
    ports:
      - "80:80"

  # 可选：添加反向代理Nginx，统一转发静态资源和Java服务请求
  # proxy-nginx:
  #   image: nginx:alpine
  #   volumes:
  #     - ./proxy-conf:/etc/nginx/conf.d
  #   ports:
  #     - "80:80"
  #   depends_on:
  #     - java-app
  #     - static-web

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