Improve documentation on the -e flag to the 'run' cli command. The ability to import the current vale of an environment variable by simply naming the variable didn't seem to be documented anywhere. (see opts/env.go)

Signed-off-by: John V. Martinez <jvmatl@gmail.com>
This commit is contained in:
John V. Martinez 2017-05-01 02:08:03 -04:00 committed by Tibor Vass
parent 62d0309d24
commit a316bc3895
1 changed files with 6 additions and 2 deletions

View File

@ -1408,13 +1408,17 @@ The following environment variables are set for Linux containers:
Additionally, the operator can **set any environment variable** in the Additionally, the operator can **set any environment variable** in the
container by using one or more `-e` flags, even overriding those mentioned container by using one or more `-e` flags, even overriding those mentioned
above, or already defined by the developer with a Dockerfile `ENV`: above, or already defined by the developer with a Dockerfile `ENV`. If the
operator names an environment variable without specifying a value, then the
current value of the named variable is propagated into the container's environment:
```bash ```bash
$ docker run -e "deep=purple" --rm alpine env $ export today=Wednesday
$ docker run -e "deep=purple" -e today --rm alpine env
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOSTNAME=d2219b854598 HOSTNAME=d2219b854598
deep=purple deep=purple
today=Wednesday
HOME=/root HOME=/root
``` ```