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

Mark notes and warnings, fix broken link renderings within. 

Docker-DCO-1.1-Signed-off-by: O.S. Tezer <ostezer@gmail.com> (github: ostezer)
This commit is contained in:
O.S.Tezer 2014-04-18 23:21:55 +03:00 committed by Tibor Vass
parent 57acc3cd5d
commit 34628fa8a4
1 changed files with 20 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
docs/sources/reference/builder.md
View File

@ -195,12 +195,10 @@ combination with `CMD`. See
If the user specifies arguments to `docker run` then If the user specifies arguments to `docker run` then
they will override the default specified in CMD. they will override the default specified in CMD.
Note > **Note**:
> Don’t confuse `RUN` with `CMD`. `RUN` actually runs a command and commits
Don’t confuse `RUN` with `CMD`. > the result; `CMD` does not execute anything at build time, but specifies
`RUN` actually runs a command and commits the > the intended command for the image.
result; `CMD` does not execute anything at build
time, but specifies the intended command for the image.
## `EXPOSE` ## `EXPOSE`
@ -228,12 +226,11 @@ persist when a container is run from the resulting image. You can view
the values using `docker inspect`, and change them the values using `docker inspect`, and change them
using `docker run --env <key>=<value>`. using `docker run --env <key>=<value>`.
Note > **Note**:
> One example where this can cause unexpected consequenses, is setting
One example where this can cause unexpected consequenses, is setting > `ENV DEBIAN_FRONTEND noninteractive`. Which will
`ENV DEBIAN_FRONTEND noninteractive`. Which will > persist when the container is run interactively; for example:
persist when the container is run interactively; for example: > `docker run -t -i image bash`
`docker run -t -i image bash`
## `ADD` ## `ADD`
@ -252,18 +249,16 @@ will be copied inside the destination container.
All new files and directories are created with mode 0755, uid and gid 0. All new files and directories are created with mode 0755, uid and gid 0.
Note > **Note**:
> If you build using STDIN (`docker build - < somefile`), there is no
> build context, so the Dockerfile can only contain an URL based ADD
> statement.
if you build using STDIN (`docker build - < somefile`), there is no > **Note**:
build context, so the Dockerfile can only contain an URL based ADD > If your URL files are protected using authentication, you will need to
statement. > use an `RUN wget` , `RUN curl`
> or other tool from within the container as ADD does not support
Note > authentication.
if your URL files are protected using authentication, you will need to
use an `RUN wget` , `RUN curl`
or other tool from within the container as ADD does not support
authentication.
The copy obeys the following rules: The copy obeys the following rules:
@ -450,13 +445,9 @@ For example you might add something like this:
ONBUILD RUN /usr/local/bin/python-build --dir /app/src ONBUILD RUN /usr/local/bin/python-build --dir /app/src
[...] [...]
Warning > **Warning**: Chaining ONBUILD instructions using ONBUILD ONBUILD isn’t allowed.
Chaining ONBUILD instructions using ONBUILD ONBUILD isn’t allowed. > **Warning**: ONBUILD may not trigger FROM or MAINTAINER instructions.
Warning
ONBUILD may not trigger FROM or MAINTAINER instructions.
## Dockerfile Examples ## Dockerfile Examples