Dockerfile ENV 使用指南

超、凢脫俗 2023-01-10 13:28 188阅读 0赞

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tlbjE1ODMwOTY2ODM_size_16_color_FFFFFF_t_70]  
当使用 Dockerfile 进行构建镜像时，有时会需要设置容器内的环境变量。

`ENV` 指令的格式如下：

ENV <key>=<value> ...

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

例如：

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

原文链接：[https://goworker.cn/posts/dockerfile-env/][https_goworker.cn_posts_dockerfile-env]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tlbjE1ODMwOTY2ODM_size_16_color_FFFFFF_t_70]: /images/20221119/895dc8bebaef4c7796fad320a2064812.png
[Link 1]: https://docs.docker.com/engine/reference/builder/#environment-replacement
[https_goworker.cn_posts_dockerfile-env]: https://goworker.cn/posts/dockerfile-env/