Dockerfile ENV 使用指南

当使用 Dockerfile 进行构建镜像时，有时会需要设置容器内的环境变量。

ENV 指令的格式如下：

ENV <key>=<value> ...

ENV 指令将环境变量 <key> 设置为值 <value>。这个值将在构建阶段的所有后续指令的环境中， 也可以被替换使用在其他指令中。 该值将被解释为其他环境变量，因此如果引号字符没有转义，它们将被删除。像命令行解析一样，引号和反斜杠可以用于在值中包含空格。

例如：

ENV MY_NAME="John Doe"
ENV MY_DOG=Rex\ The\ Dog
ENV MY_CAT=fluffy

ENV 指令允许多个 <key>=<value> ... 变量同时设置，下面的例子将在生成的镜像中产生相同的结果：

ENV MY_NAME="John Doe" MY_DOG=Rex\ The\ Dog \
    MY_CAT=fluffy

当使用生成的镜像运行容器时，使用 ENV 设置的环境变量将持久存在于容器内。 你可以使用 docker inspect 查看这些值，并使用 docker run --env <key>=<value> 修改它们。

环境变量持久性可能会导致意想不到的副作用。 例如，设置 ENV DEBIAN_FRONTEND=noninteractive 会改变 apt-get 的行为，并可能让使用镜像的用户感到困惑。

如果只在构建过程中需要环境变量，而不是在最终镜像中，请考虑为单个命令设置一个值：

RUN DEBIAN_FRONTEND=noninteractive apt-get update && apt-get install -y ...

或者使用 ARG，它不会在最终镜像中持久存在：

ARG DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install -y ...

替代语法

ENV 指令还允许另一种语法 ENV <key> <value>，省略了中间的等号。例如：

ENV MY_VAR my-value

这种语法不允许在一条 ENV 指令中设置多个环境变量，可能会造成混淆。例如，下面的代码设置了一个值为“TWO= THREE=world”的环境变量（ONE）：

ENV ONE TWO= THREE=world

支持这种替代语法为了向后兼容，但由于上述原因不鼓励使用，可能会在将来的版本中删除。