Merge pull request #3095 from eriksjolund/document_buildkit_volume_be…

…haviour docs(dockerfile): BuildKit does not discard Volume edits
moby · Nov 11, 2024 · 0655923 · 0655923
2 parents c9a17ff + aee838c
commit 0655923
Showing 1 changed file with 2 additions and 1 deletion.
diff --git a/frontend/dockerfile/docs/reference.md b/frontend/dockerfile/docs/reference.md
@@ -2221,7 +2221,8 @@ Keep the following things in mind about volumes in the Dockerfile.
   - a drive other than `C:`
 
 - **Changing the volume from within the Dockerfile**: If any build steps change the
-  data within the volume after it has been declared, those changes will be discarded.
+  data within the volume after it has been declared, those changes will be discarded
+  when using the legacy builder. When using Buildkit, the changes will instead be kept.
 
 - **JSON formatting**: The list is parsed as a JSON array.
   You must enclose words with double quotes (`"`) rather than single quotes (`'`).