Skip to content
  • Home
  • About
  • No Access
  • Privacy Policy
Bits of .NET
Bits of .NET
  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy

Bits of .NET

Daily micro-tips for C#, SQL, performance, and scalable backend engineering.

  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy
Docker

Docker: Fix a Build That Uses Stale Cached Layers After Changing Source Code

- 06.09.26 - ErcanOPAK

🐳 Your Docker Build Keeps Using Old Code Because of a Cache Layer You Didn’t Expect

Source code changes, `docker build` runs, and the container still behaves like the OLD code – not because Docker ignored the change, but because a `COPY` instruction earlier in the Dockerfile bundled source code together with something that rarely changes, so Docker’s layer cache sees no difference at that step and happily reuses a stale layer for everything after it.

🔎 The Problem

FROM node:20

WORKDIR /app
COPY . .              # <- copies EVERYTHING, including source, in one layer
RUN npm install
CMD ["node", "server.js"]

# Docker caches each instruction'"'"'s layer based on its inputs. Because
# `COPY . .` bundles package.json AND all your source files into ONE
# layer, changing app.js still invalidates that layer correctly here -
# but the REAL problem shows up in the opposite, much more common
# ordering mistake below.

✅ Fix: Order Instructions From Least-Changing to Most-Changing

  • Copy dependency manifests first and install dependencies BEFORE copying the rest of the source: `COPY package.json package-lock.json ./` then `RUN npm install`, and only THEN `COPY . .` – now changing application code invalidates only the final, fast layer, while `npm install` stays cached whenever dependencies haven’t changed.
  • This ordering is the single biggest lever for Docker build speed in most projects – going from “reinstall all dependencies on every code change” to “reinstall only when package.json actually changes” is often a 10x-or-more difference in build time.

⚠️ When You Genuinely Need to Bust the Cache

  • `docker build –no-cache` forces every layer to rebuild from scratch – useful for confirming a suspected cache issue, but too slow to use as your default build command.
  • For CI pipelines specifically, `docker build –build-arg CACHEBUST=$(date +%s)` (with a corresponding unused `ARG CACHEBUST` line right before the step you want to force) invalidates the cache from exactly one point onward, without throwing away the whole cache.

A Docker layer isn’t checked against what you meant to change – it’s checked against what its own instruction’s inputs actually were, and a badly ordered COPY can hide the difference from it entirely.

— DevOps Engineer

Related posts:

Docker: Fix a Healthcheck That Reports unhealthy Forever Because Its Exec Form Command Needs a Shell...

Docker: Fix a Healthcheck That Reports unhealthy Forever Because Its Exec Form Command Needs a Shell...

Docker: Use Swarm for Container Orchestration

Docker: Use Swarm for Container Orchestration

Docker Image Is Huge and Slow

Docker Image Is Huge and Slow

Views: 11

Post navigation

Kubernetes: Fix a Service That Routes Traffic to Pods That Aren’t Ready Yet
Git: Recover a Branch Deleted Before It Was Merged

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

November 2026
M T W T F S S
 1
2345678
9101112131415
16171819202122
23242526272829
30  
« Oct    

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,068)
  • Get the User Name and Domain Name from an Email Address in SQL (990)
  • How to add default value for Entity Framework migrations for DateTime and Bool (986)
  • Get the First and Last Word from a String or Sentence in SQL (865)
  • How to select distinct rows in a datatable in C# (859)
  • How to enable, disable and check if Service Broker is enabled on a database in SQL Server (661)
  • Add Constraint to SQL Table to ensure email contains @ (619)
  • Average of all values in a column that are not zero in SQL (577)
  • How to use Map Mode for Vertical Scroll Mode in Visual Studio (553)
  • Find numbers with more than two decimal places in SQL (481)

Recent Posts

  • Network Speed Monitor Windows Application v2.5.1
  • Ağ Hızı İzleyici Windows Uygulaması v2.5.1
  • How to make theater mode the default for Youtube
  • The AI Prompt That Audits a Function for Thread-Safety Gaps
  • Ajax: Fix a Fetch Request Caching a Response Despite No-Store
  • WordPress: Fix a Navigation Block Losing Submenu Items After Sync
  • Visual Studio: Fix CodeLens Reference Counts Stuck at Stale Numbers
  • C#: Fix a UTF-8 String Literal Behaving Differently in a Switch
  • Photoshop: Fix a Liquify Mesh Snapping Back on a Smart Object
  • The AI Prompt That Turns a Crash Dump Into a Short Repro Script

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,068)
  • Get the User Name and Domain Name from an Email Address in SQL (990)
  • How to add default value for Entity Framework migrations for DateTime and Bool (986)
  • Get the First and Last Word from a String or Sentence in SQL (865)
  • How to select distinct rows in a datatable in C# (859)

Recent Posts

  • Network Speed Monitor Windows Application v2.5.1
  • Ağ Hızı İzleyici Windows Uygulaması v2.5.1
  • How to make theater mode the default for Youtube
  • The AI Prompt That Audits a Function for Thread-Safety Gaps
  • Ajax: Fix a Fetch Request Caching a Response Despite No-Store

Social

  • ErcanOPAK.com
  • GoodReads
  • LetterBoxD
  • Linkedin
  • The Blog
  • Twitter
© 2026 Bits of .NET | Built with Xblog Plus free WordPress theme by wpthemespace.com