Docker Slate应用挂载卷无法实现实时预览的问题咨询

核心思路 #

不改动生产用的多阶段Dockerfile，通过docker-compose的环境配置隔离，单独为开发场景挂载本地代码目录、启动middleman热重载服务，同时保留原有生产部署配置完全不变。

具体调整步骤 #

1. 保留原有生产Dockerfile #

你当前的多阶段构建Dockerfile（Ruby编译静态文件+Nginx托管）继续用于生产部署，无需修改。

2. 新增开发专用配置（二选一） #

选项A：新增Dockerfile.dev开发镜像

# Dockerfile.dev
FROM ruby:2.7-slim

# 安装middleman运行依赖
RUN apt-get update && apt-get install -y build-essential git nodejs
WORKDIR /slate

# 优先拷贝Gemfile缓存依赖，加快镜像构建
COPY Gemfile Gemfile.lock ./
RUN bundle install

# 默认启动middleman开发服务
CMD ["bundle", "exec", "middleman", "serve", "--bind", "0.0.0.0"]

选项B：直接在docker-compose中定义开发环境（无需额外Dockerfile）

跳过单独的开发镜像，直接用官方Ruby镜像挂载本地依赖，适合快速调试。

3. 配置docker-compose实现环境隔离 #

推荐用docker-compose.override.yml自动覆盖主配置，不污染生产用的docker-compose.yml：

# docker-compose.override.yml
version: '3'
services:
  web:
    # 替换为开发镜像（选项A）或直接用ruby镜像（选项B）
    build:
      context: .
      dockerfile: Dockerfile.dev
    # 选项B替换为：image: ruby:2.7-slim
    volumes:
      # 挂载本地核心代码目录到容器，实现实时同步
      - ./source:/slate/source
      - ./config.rb:/slate/config.rb
      - ./Gemfile:/slate/Gemfile
      - ./Gemfile.lock:/slate/Gemfile.lock
    ports:
      - "4567:4567" # middleman默认开发端口
    # 选项B需添加command：
    # command: bash -c "bundle install && bundle exec middleman serve --bind 0.0.0.0"

启动开发环境时直接执行docker-compose up，Docker会自动加载override配置；生产环境只需删除docker-compose.override.yml即可沿用原有部署流程。

4. 关键配置说明 #

• 本地目录挂载：将本地source文档目录、配置文件直接映射到容器内，本地修改的代码会实时同步到容器环境
• middleman serve：middleman自带文件监听和热重载能力，代码变更后会自动重新编译并通知浏览器刷新，无需手动执行构建命令
• 环境完全隔离：生产环境依然使用原有Nginx托管静态文件的方案，开发环境单独运行middleman服务，两者互不影响

现有配置无法实时预览的原因 #

当前多阶段构建是一次性编译静态文件，容器内仅运行Nginx托管已生成的静态资源，既没有挂载本地代码目录同步变更，也没有运行middleman的开发监听服务，因此代码修改后必须重新构建镜像才能更新内容。

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