Docker buildx跨平台构建不缓存bundle install，每次全量重建求助

问题描述 #

我用MacBook开发，公司服务器是Intel平台，所以采用Docker buildx构建跨平台镜像（也欢迎其他适配该场景的方案）。但目前每次构建都会从头执行所有步骤：每次都要下载docker.io/library/ruby:3.1.4-bullseye基础镜像，还要重新运行RUN bundle install，在低带宽环境下耗时极久——哪怕代码完全没改动，隔天后重新构建依然会全量重建。

我使用的构建命令：

docker buildx build --platform linux/amd64,linux/arm64 --push -t registry.digitalocean.com/[MY COMPANY NAME]/[MY IMAGE NAME] .

按Docker的机制，本该缓存镜像层，仅重建修改过的层及后续层，完全无改动时不该全量重来。我怀疑是否和Ruby on Rails有关，想请教解决办法；另外在公司服务器上构建也存在同样问题。

附上我的Dockerfile：

FROM ruby:3.1.4-bullseye

COPY Gemfile Gemfile.lock ./
RUN bundle install

# Install dependencies
RUN apt-get -y update -qq
RUN apt-get install -y nano postgresql-client postgresql-client-common bash

# Default directory
ENV INSTALL_PATH /opt/[MY PROJECT]
RUN mkdir -p $INSTALL_PATH
WORKDIR $INSTALL_PATH
COPY . .

EXPOSE 3001

CMD ["rails", "server", "-b", "0.0.0.0", "-p", "3001"]

核心原因分析 #

Docker buildx跨平台构建时，默认不会复用本地单平台构建的缓存；如果直接推送到远程仓库，构建缓存也不会自动保留，导致每次都要从头拉取基础镜像、重新执行所有步骤。同时你的Dockerfile也有可优化缓存逻辑的空间。

具体解决步骤 #

1. 为buildx配置远程缓存存储 #

构建时指定远程缓存镜像，让构建层可以复用，避免重复拉取和执行：

docker buildx build \
  --platform linux/amd64,linux/arm64 \
  --push \
  -t registry.digitalocean.com/[MY COMPANY NAME]/[MY IMAGE NAME] \
  --cache-from type=registry,ref=registry.digitalocean.com/[MY COMPANY NAME]/[MY IMAGE NAME]-cache \
  --cache-to type=registry,ref=registry.digitalocean.com/[MY COMPANY NAME]/[MY IMAGE NAME]-cache,mode=max \
  .

这个命令会把构建缓存推送到一个专门的缓存镜像，下次构建时直接从该镜像拉取缓存，大幅减少重复操作。

2. 优化Dockerfile的缓存顺序 #

把不常变动的步骤放在前面，最大化利用Docker的分层缓存机制：

FROM ruby:3.1.4-bullseye

# 先安装系统依赖，这部分几乎不会变动
RUN apt-get -y update -qq && \
    apt-get install -y nano postgresql-client postgresql-client-common bash && \
    rm -rf /var/lib/apt/lists/*  # 清理APT缓存，减小镜像体积

# 设置工作目录
ENV INSTALL_PATH /opt/[MY PROJECT]
RUN mkdir -p $INSTALL_PATH
WORKDIR $INSTALL_PATH

# 先复制Gemfile相关文件，只有Gemfile/Gemfile.lock改动时才会重新执行bundle install
COPY Gemfile Gemfile.lock ./
RUN bundle install --jobs 4 --retry 3  # 增加并发数和重试次数，加快安装速度

# 最后复制整个项目代码，代码改动仅影响这一层及后续步骤
COPY . .

EXPOSE 3001

CMD ["rails", "server", "-b", "0.0.0.0", "-p", "3001"]

调整顺序后，系统依赖、bundle install的镜像层会被缓存，只有当Gemfile相关文件或项目代码改动时，才会重建对应层级。

3. 其他跨平台构建方案 #

• 用公司Intel服务器作为buildx构建节点：在服务器上创建buildx builder，指定使用amd64平台，构建时直接复用服务器本地缓存，无需跨平台模拟，速度更快。
• 借助CI/CD工具：GitHub Actions、GitLab CI等工具原生支持跨平台构建，且自带缓存机制，能自动保留构建层，避免本地构建的缓存失效问题。

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