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 Cache Ignoring a Changed ARG Value

- 20.11.26 - ErcanOPAK

🐳 Fix a Build Cache Ignoring a Changed ARG Value

Docker’s layer cache keys a layer by the instruction text in the Dockerfile and the build context it consumes, not by the runtime value you pass with –build-arg – so an ARG that’s declared but not actually referenced inside the specific RUN or COPY instruction whose output should change leaves that layer’s cache key untouched even when you change the ARG’s value between builds. The build finishes fast, reports no errors, and tags a new image that’s quietly still running the previous version’s artifact underneath.

🐳 The Problem

ARG VERSION=2.0
FROM base-image:latest
# VERSION is declared above but never actually used inside this RUN line,
# so changing --build-arg VERSION=2.1 does not change this instruction's
# text or its cache key - the layer below is reused from the old build.
RUN curl -O https://example.com/releases/app-latest.tar.gz && \
    tar -xzf app-latest.tar.gz

✅ Fix: Make the ARG Actually Participate in the Cached Instruction

  • Interpolate the ARG directly inside the RUN or COPY instruction whose output needs to change (for example RUN curl -O https://example.com/releases/app-$VERSION.tar.gz), since Docker only busts a layer’s cache when that layer’s instruction text or consumed context actually differs.
  • When you need to force a rebuild of one specific layer without discarding the entire cache, build with –no-cache targeted at that stage, or restructure the Dockerfile so the ARG-dependent instruction runs as late as possible, after the other reliably cacheable steps.
  • Add a development-only RUN echo “$VERSION” step right before the layer in question so a stale cache hit shows the wrong value directly in the build log instead of baking in silently.

🚨 Why This Is Dangerous

  • An image tagged and shipped as a new release can still be running the previous version’s binary underneath, with nothing in the build log or the final image’s own metadata pointing at the mismatch.

Docker doesn’t cache what you told it to build – it caches the exact instructions you wrote, and an unused ARG never changes those.

— DevOps Engineer

Related posts:

Docker — latest Tag Breaks Reproducibility

Docker — latest Tag Breaks Reproducibility

Docker: Centralized Logging Pipeline for Production Containers

Docker: Centralized Logging Pipeline for Production Containers

Docker: Fix a Container That Can't Write to a Volume Mounted From the Host

Docker: Fix a Container That Can't Write to a Volume Mounted From the Host

Views: 4

Post navigation

WordPress: Fix the Site Health Check Flagging a Fake Cron Issue
Asp.Net Core: Fix Rate Limiting Counting Requests Per Instance

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