moby/docs/reference/commandline
Madhav Puri 54240f8da9 Support for passing build-time variables in build context
- The build-time variables are passed as environment-context for command(s)
run as part of the RUN primitve. These variables are not persisted in environment of
intermediate and final images when passed as context for RUN. The build environment
is prepended to the intermediate continer's command string for aiding cache lookups.
It also helps with build traceability. But this also makes the feature less secure from
point of view of passing build time secrets.

- The build-time variables also get used to expand the symbols used in certain
Dockerfile primitves like ADD, COPY, USER etc, without an explicit prior definiton using a
ENV primitive. These variables get persisted in the intermediate and final images
whenever they are expanded.

- The build-time variables are only expanded or passed to the RUN primtive if they
are defined in Dockerfile using the ARG primitive or belong to list of built-in variables.
HTTP_PROXY, HTTPS_PROXY, http_proxy, https_proxy, FTP_PROXY and NO_PROXY are built-in
variables that needn't be explicitly defined in Dockerfile to use this feature.

Signed-off-by: Madhav Puri <madhav.puri@gmail.com>
2015-09-16 03:31:15 -07:00
..
attach.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
build.md Support for passing build-time variables in build context 2015-09-16 03:31:15 -07:00
cli.md Remove -h flag from completion and daemon reference 2015-08-11 07:30:58 -07:00
commit.md Align 'docker commit' docs with the code 2015-07-09 13:17:47 -07:00
cp.md Typo in cp.md 2015-09-07 18:19:54 -07:00
create.md Add support for DNS options 2015-09-16 14:06:45 -07:00
daemon.md Add support for DNS options 2015-09-16 14:06:45 -07:00
diff.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
docker_images.gif retooling for hugo 2015-06-15 13:19:38 -07:00
events.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
exec.md Updated test to check for exec --privileged side-effects 2015-08-13 16:37:20 +10:00
export.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
history.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
images.md Update filtering chapters on ps/images references 2015-08-27 08:47:03 +02:00
import.md adding message option to the import subcommand 2015-08-25 02:55:04 +00:00
info.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
inspect.md Flag Addition: --type flag added for docker inspect command 2015-07-01 12:14:01 -04:00
kill.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
load.md Document that load supports compressed tarballs. 2015-07-14 15:51:06 -07:00
login.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
logout.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
logs.md Add log reading to the journald log driver 2015-09-11 16:50:03 -04:00
pause.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
port.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
ps.md Add missing ps placeholder to the docs. 2015-09-08 16:12:26 -04:00
pull.md Rename to flags and environment variables to content trust 2015-07-24 16:31:18 -07:00
push.md Rename to flags and environment variables to content trust 2015-07-24 16:31:18 -07:00
rename.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
restart.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
rm.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
rmi.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
run.md Add support for DNS options 2015-09-16 14:06:45 -07:00
save.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
search.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
start.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
stats.md Docker stats: display Block IO stats 2015-07-31 21:26:32 +08:00
stop.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
tag.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
top.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
unpause.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00
version.md add --format flag to docker version 2015-07-13 19:10:56 -04:00
volume_create.md Fix minor typo in docs 2015-09-07 21:16:47 +02:00
volume_inspect.md update docker volume man pages 2015-09-09 19:16:39 +02:00
volume_ls.md Add volume API/CLI 2015-08-26 13:37:52 -04:00
volume_rm.md Fix usage for docker volume inspect and docker volume rm 2015-09-08 09:14:57 -07:00
wait.md Splitting out the cli command into parts. 2015-06-25 12:02:41 -07:00