如何在 docker 中构建期间设置环境变量

Question

我试图在构建过程中设置docker容器中的环境变量，但没有成功。使用运行命令时设置它们有效，但我需要在构建过程中设置它们。

Dockerfile文件

FROM ubuntu:latest
ARG TEST_ENV=something

我用来构建的命令

docker build -t --build-arg TEST_ENV="test" myimage .

运行

docker run -dit myimage

我正在检查可用的环境变量，通过使用

docker exec containerid printenv

结果是

PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOSTNAME=e49c1abfd58b
TERM=xterm
no_proxy=*.local, 169.254/16
HOME=/root

TEST_ENV不在场

Answer 1

我将总结这篇伟大文章的亮点。

1）简短解释：
ARG仅在Docker映像构建期间（RUN等）可用，而不是在创建映像并从中启动容器之后（ENTRYPOINT，CMD）。

ENV值可用于容器，但也可用于Docker构建过程中的RUN样式命令（从引入它们的行开始）。如果使用bash在中间容器中设置环境变量（RUNexportVARI=5

2）更长的解释：
ARG也称为构建时间变量。它们只在Dockerfile中使用ARG指令“宣布”的那一刻起，直到构建图像时才可用。正在运行的容器无法访问ARG变量的值。这也适用于CMD和ENTRYPOINT指令，它们只告诉默认情况下容器应该运行什么。如果您告诉Dockerfile需要各种ARG变量（没有默认值），但在运行build命令时没有提供任何变量，则会出现错误html" target="_blank">消息。

然而，ARG值可以在构建映像后通过查看映像的docker历史记录轻松检查。因此，对于敏感数据来说，它们是一个糟糕的选择。

在构建过程中，只要您使用ENV指令引入ENV变量，就可以使用ENV变量。然而，与ARG不同，它们也可以由从最终图像开始的容器访问。启动容器时可以重写ENV值，下面将详细介绍。

3）使用diagrem：
这里是ARG和ENV可用性的简化概述，围绕从Dockerfile构建Docker映像和运行容器的过程。

它们重叠，但是ARG不能从容器内部使用。

因此，您有您的Dockerfile，它定义了ARG和ENV值。如何设置它们，以及在哪里设置？您可以在Dockerfile中将它们留空，或者设置默认值。如果您没有为没有默认值的预期ARG变量提供值，您将收到错误消息。

下面是一个＜code＞Dockerfile＜/code＞示例，包括默认值和不使用默认值：

ARG some_variable_name
# or with a hard-coded default:
#ARG some_variable_name=default_value

RUN echo "Oh dang look at that $some_variable_name"
# you could also use braces - ${some_variable_name}

从命令行构建Docker映像时，您可以使用-Build-arg设置ARG值：

$ docker build --build-arg some_variable_name=a_value

使用上面的Dockerfile运行该命令，将导致打印以下行（除其他外）：哦，该死，看看那个a_value

那么，这如何转化为使用< code>docker-compose.yml文件呢？< br >使用docker-compose时，可以在args块中为< code>ARG指定要传递的值:< br> (docker-compose.yml文件)

version: '3'

services:
  somename:
    build:
      context: ./app
      dockerfile: Dockerfile
      args:
        some_variable_name: a_value

当你尝试设置一个 Dockerfile 中没有提到 ARG 的变量时，Docker 会抱怨。

那么，如何设置< code>ENV值呢？您可以在启动您的容器时这样做(我们将在下面讨论这一点)，但是您也可以通过硬编码直接在< code>Dockerfile中提供默认的< code>ENV值。此外，您可以为环境变量设置动态默认值！

在构建图像时，您可以提供的唯一内容是ARG值，如上所述。不能直接为ENV变量提供值。然而，ARG和ENV都可以一起工作。您可以使用ARG设置ENVvars的默认值
这里有一个基本的Dockerfile，使用硬编码的默认值：

# no default value
ENV hey
# a default value
ENV foo /bar
# or ENV foo=/bar

# ENV values can be used during the build
ADD . $foo
# or ADD . ${foo}
# translates to: ADD . /bar

下面是< code>Dockerfile的一个片段，它使用了动态构建环境值:

# expect a build-time variable
ARG A_VARIABLE
# use the value to set the ENV var default
ENV an_env_var=$A_VARIABLE
# if not overridden, that value of an_env_var will be available to your containers!

生成映像后，可以通过命令行或使用 docker-compose.yml 文件以三种不同的方式启动容器并为 ENV 变量提供值。
所有这些都将覆盖 Docker 文件中的任何默认 ENV 值。
与 ARG 不同，您可以将各种环境变量传递给容器。即使是那些没有在 Dockerfile 中明确定义的。
但是，这取决于您的应用程序是否会执行任何操作。

选项1：逐个提供值
在命令行中，使用-e标志：

$ docker run -e "env_var_name=another_value" alpine env

从 docker-compose.yml 文件：

version: '3'

services:
  plex:
    image: linuxserver/plex
      environment:
        - env_var_name=another_value

选项 2：从主机传递环境变量值
它与上述方法相同。
唯一的区别是，您不提供值，而只是命名变量。这将使 Docker 访问主机环境中的当前值并将其传递给容器。

$ docker run -e env_var_name alpine env

对于docker-compose.yml文件，省略等式符号及其后的所有内容以获得相同的效果。

version: '3'

services:
  plex:
    image: linuxserver/plex
      environment:
        - env_var_name

选项3:从文件(env_file)中取值< br >我们可以指定一个文件来从中读取值，而不是写出变量或对它们进行硬编码(根据12因素的说法，这不是一个好主意)。此类文件的内容如下所示:

env_var_name=another_value

上面的文件名为env_file_name（名称任意），位于当前目录中
您可以引用文件名，该文件名被解析以提取要设置的环境变量：

$ docker run --env-file=env_file_name alpine env

使用＜code＞docker compose。yml文件，我们只引用一个env_file，Docker解析它以设置变量。

version: '3'

services:
  plex:
    image: linuxserver/plex
    env_file: env_file_name

这是一个小备忘单，结合了ARG和ENV可用性的概述以及从命令行设置它们的常见方法。

Answer 2

< code>ARG用于设置在< code>docker构建过程中使用的环境变量，它们不会出现在最终的映像中，这就是为什么当您使用< code>docker run时看不到它们。

您可以使用ARG进行设置，这些设置仅在构建映像时才相关，而从映像运行的容器不需要这些设置。您可以使用ENV作为环境变量，以便在构建期间和容器中使用。

使用此Dockerfile：

FROM ubuntu                                                                                                            
ARG BUILD_TIME=abc                                                                                                     
ENV RUN_TIME=123                                                                                                       
RUN touch /env.txt                                                                                                     
RUN printenv > /env.txt 

您可以重写构建arg，就像您使用docker构建-t temp--Build-argBUILD_TIME=def所做的那样。。然后你会得到你想要的：

> docker run temp cat /env.txt                                                                                         
HOSTNAME=b18b9cafe0e0                                                                                                  
RUN_TIME=123                                                                                                           
HOME=/root                                                                                                             
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin                                                      
BUILD_TIME=def                                                                                                         
PWD=/