docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #2681 from SvenDowideit/add-instruction-path-limitations 

add a little more info about the limitations of ADD wrt ../ and docker build
This commit is contained in:
Andy Rothfusz 2013-11-13 10:56:35 -08:00
parent b94e9ed0de af0b2e38c3
commit 077c2496ed
1 changed files with 8 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/sources/use/builder.rst
View File

@ -221,8 +221,16 @@ destination container.
All new files and directories are created with mode 0755, uid and gid All new files and directories are created with mode 0755, uid and gid
0. 0.
.. note::
if you build using STDIN (``docker build - < somefile``), there is no build
context, so the Dockerfile cannot contain an ADD statement.
The copy obeys the following rules: The copy obeys the following rules:
* The ``<src>`` path must be inside the *context* of the build; you cannot
``ADD ../something /something``, because the first step of a
``docker build`` is to send the context directory (and subdirectories) to
the docker daemon.
* If ``<src>`` is a URL and ``<dest>`` does not end with a trailing slash, * If ``<src>`` is a URL and ``<dest>`` does not end with a trailing slash,
then a file is downloaded from the URL and copied to ``<dest>``. then a file is downloaded from the URL and copied to ``<dest>``.
* If ``<src>`` is a URL and ``<dest>`` does end with a trailing slash, * If ``<src>`` is a URL and ``<dest>`` does end with a trailing slash,