Ruby on Rails Dockerfile优化：仅Gemfile变更时执行bundle install

核心原理 #

Docker 构建时会按层缓存执行结果，只有当某一层的指令或上下文内容发生变化时，才会重新执行该层及后续层。利用这一机制，我们可以将依赖安装步骤与项目代码复制步骤分离，仅在依赖文件变更时重新执行 bundle install。

优化后的 Dockerfile 示例 #

# 匹配你的Rails项目所需的Ruby版本，这里以3.2.2为例
FROM ruby:3.2.2-slim-bookworm

# 配置bundle环境变量，指定依赖安装路径，避免交互并跳过文档生成
ENV BUNDLE_PATH=/bundle \
    BUNDLE_BIN=/bundle/bin \
    GEM_HOME=/bundle \
    PATH="$BUNDLE_BIN:$PATH" \
    BUNDLE_WITHOUT="development test"

# 安装Rails运行所需的系统依赖（根据项目调整，比如替换为mysql-client等）
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    libpq-dev \
    nodejs \
    yarn \
    && rm -rf /var/lib/apt/lists/*

# 关键步骤：先单独复制Gemfile和Gemfile.lock，触发缓存判断
COPY Gemfile Gemfile.lock ./

# 执行bundle安装依赖，仅当Gemfile或Gemfile.lock变更时重新运行
RUN bundle install

# 复制整个项目代码（这一步缓存会频繁失效，但不影响依赖安装层）
COPY . .

# 预编译静态资产（生产环境构建时需要）
RUN bundle exec rails assets:precompile

# 设置容器启动命令
CMD ["bundle", "exec", "puma", "-C", "config/puma.rb"]

关键优化点说明 #

• 提前复制依赖文件：将Gemfile和Gemfile.lock单独复制到镜像中，这一层的缓存仅在这两个文件修改时失效，后续的bundle install才会重新执行。
• 环境变量配置：通过BUNDLE_PATH指定依赖安装目录，确保依赖被缓存到独立层；BUNDLE_WITHOUT跳过开发/测试依赖，减少安装时间和镜像体积。
• 系统依赖清理：安装后删除apt缓存，缩小镜像大小。

额外注意事项 #

• 检查.dockerignore文件，确保没有排除Gemfile、Gemfile.lock或yarn.lock（如果用前端依赖）。
• 若项目使用前端依赖，可同样先复制package.json和yarn.lock，执行yarn install后再复制项目代码，进一步优化前端依赖的缓存。
• 选择合适的基础镜像：slim或alpine版本的镜像体积更小，能加快构建和拉取速度。

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