Browse code

docs: warn about build data tx & ADD w/o context

This updates the documentation to mention that:
1. a lot of data may get sent to the docker daemon if there is a lot of
data in the directory passed to docker build
2. ADD doesn't work in the absence of the context
3. running without a context doesn't send file data to the docker
daemon
4. explain that the data sent to the docker daemon will be used by ADD
commands

unclejack authored on 2013/06/07 04:06:12
Showing 1 changed files
... ...
@@ -19,10 +19,14 @@ Examples
19 19
 
20 20
     docker build .
21 21
 
22
-This will take the local Dockerfile
22
+| This will read the Dockerfile from the current directory. It will also send any other files and directories found in the current directory to the docker daemon.
23
+| The contents of this directory would be used by ADD commands found within the Dockerfile.
24
+| This will send a lot of data to the docker daemon if the current directory contains a lot of data.
25
+|
23 26
 
24 27
 .. code-block:: bash
25 28
 
26 29
     docker build -
27 30
 
28
-This will read a Dockerfile form Stdin without context
31
+| This will read a Dockerfile from Stdin without context. Due to the lack of a context, no contents of any local directory will be sent to the docker daemon.
32
+| ADD doesn't work when running in this mode due to the absence of the context, thus having no source files to copy to the container.