Heroku平台Docker应用如何实现构建层缓存加速部署
Heroku Docker 构建的缓存机制说明
核心结论
Heroku 原生容器构建流程默认不支持跨构建的Docker本地层缓存,这就是你每次空提交部署都全量重新拉取基础镜像、重复执行依赖安装的根本原因。
误区澄清:你部署日志里看到的
Layer already exists是镜像推送到Heroku私有 registry 时的存储去重提示,意思是这些层的哈希值之前已经被registry 存储过、不需要重复上传,和构建阶段的Docker层缓存没有任何关系。
为什么无法命中原生构建缓存
Docker的本地层缓存依赖构建节点上持久化的Docker daemon存储的中间层数据,但Heroku的Docker构建流程是在每次部署时启动一个完全隔离的临时构建实例:
- 构建实例启动时没有任何历史构建残留数据,所有缓存目录、中间层存储都是空的
- 构建完成后整个临时实例会被完全销毁,不会留存任何可供下次构建使用的缓存内容
所以无论你两次构建的Dockerfile有多少重复步骤,在Heroku的构建节点上都属于从零开始构建,没有缓存可命中。
另外Heroku内置的构建缓存能力(比如buildpack构建时留存的gems、npm包缓存)仅适用于buildpack驱动的构建流程,对Docker容器构建流程不生效。
可落地的缓存复用实现方案
虽然没有原生的构建层缓存,你可以通过手动维护依赖基础镜像的方式,实现等价的缓存效果:
- 拆分构建流程,把依赖安装步骤单独做成可复用的基础镜像
新增专门的依赖镜像文件Dockerfile.deps,内容就是你原来的依赖安装步骤:FROM ruby:2.7.2-alpine WORKDIR /app COPY Gemfile Gemfile.lock ./ RUN bundle install - 首次构建依赖镜像,推送到Heroku私有registry 留存
在本地构建和Heroku运行环境同架构(linux/amd64)的依赖镜像,给它打固定的版本标签后推送到Heroku的容器仓库:# 构建匹配Heroku运行架构的依赖镜像 docker build --platform linux/amd64 -f Dockerfile.deps -t registry.heroku.com/<你的应用名>/web:deps-base . # 登录Heroku容器仓库后推送镜像 docker push registry.heroku.com/<你的应用名>/web:deps-base - 调整正式应用的Dockerfile,直接从留存的依赖镜像开始构建
把原来的Dockerfile基础源替换成你刚才推上去的依赖镜像,跳过重复的依赖安装步骤:FROM registry.heroku.com/<你的应用名>/web:deps-base WORKDIR /app # 只同步业务代码,不需要重新执行bundle install COPY . . # 你的启动命令 CMD ["bundle", "exec", "rackup", "-o", "0.0.0.0", "-p", "5000"] - 日常部署时的缓存使用逻辑
- 当你没有修改
Gemfile或Gemfile.lock时,直接走正常的Heroku Docker构建流程,因为基础源已经是装好依赖的镜像,构建时拉取这一层的速度远快于从零安装依赖 - 只有当你修改了依赖清单文件时,重新构建一次
deps-base镜像推送到registry,更新留存的依赖版本即可
- 当你没有修改
注意事项
- 本地构建依赖镜像时一定要指定
linux/amd64架构,否则在Apple Silicon等arm架构设备上构建的镜像会无法在Heroku的x86运行环境正常启动 - 不要在这个依赖基础镜像里写入业务代码,避免依赖更新和代码修改的逻辑耦合,导致不必要的全量重新上传
- 该方案不需要修改你现有的
heroku.yml配置,保持原有build.docker.web = Dockerfile的配置即可正常工作
内容的提问来源于stack exchange,提问作者Kevin Sylvestre
相关产品推荐
相关产品推荐

