OpenShift 3.11二进制构建Docker层缓存失效问题求助

我之前在OpenShift 3.11上也碰到过一模一样的问题——明明设置了noCache: false，但每次二进制构建还是会从头执行Dockerfile的所有步骤，完全没有缓存复用。下面是我踩坑后总结的排查和解决方法：

为什么缓存会失效？ #

二进制构建的核心痛点在于：每次用oc start-build --from-dir=.上传的本地目录，OpenShift会把整个目录内容作为构建上下文。哪怕你的业务代码、依赖完全没变化，只要上下文里的某个文件哈希变了（比如临时日志、编辑器缓存文件），Docker就会判定“上下文已更新”，直接跳过所有缓存从头构建。另外，如果之前的构建镜像被自动清理（比如successfulBuildsHistoryLimit设置得太小），也会导致没有基础镜像可以复用缓存层。

具体解决方案 #

1. 优化构建上下文：添加.dockerignore文件 #

这是最关键的一步，直接决定了构建上下文的哈希稳定性。在你的项目根目录创建.dockerignore文件，把所有Dockerfile不需要的文件排除在外，示例：

node_modules/
.git/
*.log
tmp/
.vscode/
.DS_Store

这样上传的上下文体积会大幅缩小，同时避免了无关文件的变动导致哈希变化，让Docker能正确识别可复用的层。

2. 确保历史构建镜像被保留 #

检查你的BuildConfig配置：

• 你已经设置了successfulBuildsHistoryLimit: 20，这个数值足够保留历史构建镜像，但要确认对应的ImageStream是否保留了历史版本。可以用oc get istag ${IMAGE_STREAM_NAME}查看是否有多个历史镜像标签。
• 如果ImageStream的latest标签被频繁覆盖，你可以尝试在BuildConfig的output.to中使用带版本号的标签（比如${IMAGE_STREAM_NAME}:build-${BUILD_NUMBER}），或者修改ImageStream的策略来保留历史镜像。

3. 启动构建时强制启用增量模式 #

启动构建时添加--incremental参数，让OpenShift尝试复用上一次成功构建的缓存：

oc start-build my-build-name --from-dir=. --follow --incremental

这个参数会让构建系统优先以上一次成功构建的镜像作为基础，从而跳过已经执行过的Docker步骤（只要对应步骤的内容没变化）。

4. 显式指定缓存基础镜像 #

在BuildConfig的dockerStrategy中，直接指定上一次构建的镜像作为基础，确保Docker能找到缓存来源：

strategy:
  dockerStrategy:
    noCache: false
    from:
      kind: ImageStreamTag
      name: ${IMAGE_STREAM_NAME}:latest

这样Docker会直接以已构建好的latest镜像为起点，只重新执行Dockerfile中内容有变化的步骤。

5. 从构建日志排查缓存状态 #

执行构建时仔细查看日志，如果完全没有Using cache的字样，说明构建上下文的哈希确实每次都在变动，回到第一步优化.dockerignore；如果有部分步骤显示Using cache，说明这部分层已经复用，重点排查未缓存步骤对应的文件是否有隐性变动。

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