瀏覽代碼

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>
John V. Martinez 8 年之前
父節點
當前提交
be2ba8f791
共有 1 個文件被更改,包括 6 次插入2 次删除
  1. 6 2
      docs/reference/run.md

+ 6 - 2
docs/reference/run.md

@@ -1408,13 +1408,17 @@ The following environment variables are set for Linux containers:
 
 Additionally, the operator can **set any environment variable** in the
 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
-$ 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
 HOSTNAME=d2219b854598
 deep=purple
+today=Wednesday
 HOME=/root
 ```