docker_practice/image/dockerfile/arg.md

### ARG 构建参数

格式：`ARG <参数名>[=<默认值>]`

构建参数和 `ENV` 的效果一样，都是设置环境变量。所不同的是，`ARG` 所设置的构建环境的环境变量，在将来容器运行时是不会存在这些环境变量的。但是不要因此就使用 `ARG` 保存密码之类的信息，因为 `docker history` 还是可以看到所有值的。

`Dockerfile` 中的 `ARG` 指令是定义参数名称，以及定义其默认值。该默认值可以在构建命令 `docker build` 中用 `--build-arg <参数名>=<值>` 来覆盖。

在 1.13 之前的版本，要求 `--build-arg` 中的参数名，必须在 `Dockerfile` 中用 `ARG` 定义过了，换句话说，就是 `--build-arg` 指定的参数，必须在 `Dockerfile` 中使用了。如果对应参数没有被使用，则会报错退出构建。从 1.13 开始，这种严格的限制被放开，不再报错退出，而是显示警告信息，并继续构建。这对于使用 CI 系统，用同样的构建流程构建不同的 `Dockerfile` 的时候比较有帮助，避免构建命令必须根据每个 Dockerfile 的内容修改。
-												重写定制镜像章节

由于定制镜像是 Docker 使用环境的重中之重，因此将原来的 `image/create.md` 扩展为4篇：`image/commit.md`, `image/build.md`, `image/dockerfile/*`, `image/other.md`。其中 `dockerfile` 进一步扩展，包括大部分指令详解。

由于 `image/dockerfile/*` 已经涵盖了 `dockefile/*` 的内容，并且增加了很多。因此去掉了原有的 `dockerfile/` 章节。从另一个角度来看，相当于是将后续 `dockerfile` 章节前移。
Dockerfile 是镜像构建必须掌握的技能，在介绍镜像定制的时候，就应该将其详细讲解。

将 `image/save_load.md` 合并到 `image/other.md` 并重写。docker import, export, save, load 是不常使用的命令，他们是早期 Docker 生态环境不完善的时候留下来的东西，现在已经不推荐使用，因此将这些方法合并到一篇里作为了解即可。

Signed-off-by: Tao Wang <twang2218@gmail.com>

											
										
										
											2016-11-26 02:02:43 +08:00
+								### ARG 构建参数
 								格式：`ARG <参数名>[=<默认值>]`
-												是用 -> 使用

											
										
										
											2017-02-18 21:02:39 +08:00
+								构建参数和 `ENV` 的效果一样，都是设置环境变量。所不同的是，`ARG` 所设置的构建环境的环境变量，在将来容器运行时是不会存在这些环境变量的。但是不要因此就使用 `ARG` 保存密码之类的信息，因为 `docker history` 还是可以看到所有值的。
-												重写定制镜像章节

由于定制镜像是 Docker 使用环境的重中之重，因此将原来的 `image/create.md` 扩展为4篇：`image/commit.md`, `image/build.md`, `image/dockerfile/*`, `image/other.md`。其中 `dockerfile` 进一步扩展，包括大部分指令详解。

由于 `image/dockerfile/*` 已经涵盖了 `dockefile/*` 的内容，并且增加了很多。因此去掉了原有的 `dockerfile/` 章节。从另一个角度来看，相当于是将后续 `dockerfile` 章节前移。
Dockerfile 是镜像构建必须掌握的技能，在介绍镜像定制的时候，就应该将其详细讲解。

将 `image/save_load.md` 合并到 `image/other.md` 并重写。docker import, export, save, load 是不常使用的命令，他们是早期 Docker 生态环境不完善的时候留下来的东西，现在已经不推荐使用，因此将这些方法合并到一篇里作为了解即可。

Signed-off-by: Tao Wang <twang2218@gmail.com>

											
										
										
											2016-11-26 02:02:43 +08:00
-												修正 --build-arg 的参数的说明以适应 Docker 1.13 的变化

Signed-off-by: Tao Wang <twang2218@gmail.com>

											
										
										
											2016-11-28 07:53:44 +08:00
+								`Dockerfile` 中的 `ARG` 指令是定义参数名称，以及定义其默认值。该默认值可以在构建命令 `docker build` 中用 `--build-arg <参数名>=<值>` 来覆盖。
 								在 1.13 之前的版本，要求 `--build-arg` 中的参数名，必须在 `Dockerfile` 中用 `ARG` 定义过了，换句话说，就是 `--build-arg` 指定的参数，必须在 `Dockerfile` 中使用了。如果对应参数没有被使用，则会报错退出构建。从 1.13 开始，这种严格的限制被放开，不再报错退出，而是显示警告信息，并继续构建。这对于使用 CI 系统，用同样的构建流程构建不同的 `Dockerfile` 的时候比较有帮助，避免构建命令必须根据每个 Dockerfile 的内容修改。