Quellcode durchsuchen

docs: explain when RUN cache gets invalidated

This adds a few lines to the RUN Dockerfile docs to explain how to
bypass the RUN caching and how ADD can also invalidate the cache for
these instructions.

Docker-DCO-1.1-Signed-off-by: Cristian Staretu <cristian.staretu@gmail.com> (github: unclejack)
unclejack vor 11 Jahren
Ursprung
Commit
239d1ef301
1 geänderte Dateien mit 10 neuen und 0 gelöschten Zeilen
  1. 10 0
      docs/sources/reference/builder.md

+ 10 - 0
docs/sources/reference/builder.md

@@ -131,6 +131,16 @@ any point in an image's history, much like source control.
 The *exec* form makes it possible to avoid shell string munging, and to `RUN`
 commands using a base image that does not contain `/bin/sh`.
 
+The cache for `RUN` instructions isn't invalidated automatically during the
+next build. The cache for an instruction like `RUN apt-get dist-upgrade -y`
+will be reused during the next build.
+The cache for `RUN` instructions can be invalidated by using the `--no-cache`
+flag, for example `docker build --no-cache`.
+
+The first encountered `ADD` instruction will invalidate the cache for all
+following instructions from the 'Dockerfile' if the contents of the context
+have changed. This will also invalidate the cache for `RUN` instructions.
+
 ### Known Issues (RUN)
 
 - [Issue 783](https://github.com/dotcloud/docker/issues/783) is about file