Docker的ARG、ENV和.env配置完整指南

常見的誤解

• .env 檔案僅在使用docker-compose.yml 檔案時的預處理步驟中使用。美元符號變數（如 $HI）被替換為同一目錄中名為“.env”的檔案中包含的值。
• ARG僅在構建 Docker 映像（RUN 等）期間可用，而不是在建立映像並從其啟動容器之後（ENTRYPOINT、CMD）。您可以使用 ARG 值來設定 ENV 值來解決這個問題。
• ENV值可用於容器，但在 Docker 構建期間也可使用 RUN 樣式的命令，從引入它們的行開始。
• 如果您使用 bash (RUN export VARI=5 && …) 在中間容器中設定環境變數，它將不會在下一個命令中持續存在。有辦法解決這個問題。
• env_file是一種將許多環境變數一次性傳遞給單個命令的便捷方式。這不應與.env檔案混淆。
• 設定 ARG 和 ENV 值會在 Docker 映像中留下痕跡。不要將它們用於不打算保留的秘密（好吧，您可以使用多階段構建）。

• The Dot-Env File (.env)
• ARG 和 ENV 可用性
• 設定 ARG 值
• 設定 ENV 值
• 覆蓋 ENV 值

The Dot-Env File (.env)
如果您的專案中有一個名為.env的檔案，它僅用於將值放入同一資料夾中的 docker-compose.yml 檔案中。這些與 Docker Compose 和 Docker Stack 一起使用。它與 ENV、ARG 或上面解釋的任何 Docker 特定無關。這完全是 docker-compose.yml 的事情。
檔案中的值.env用以下表示法編寫：

VARIABLE_NAME=some value
OTHER_VARIABLE_NAME=some other value, like 5

version: '3'

services:
  plex:
    image: linuxserver/plex
      environment:
        - env_var_name=${VARIABLE_NAME} # here it is

ARG 和 ENV 可用性
在使用Docker時，我們區分了兩種不同型別的變數--ARG和ENV。

ARG也被稱為構建時變數。它們只在Docker檔案中用ARG指令 "宣佈 "的那一刻起可用，直到映象被構建。執行中的容器不能訪問ARG變數的值。這也適用於CMD和ENTRYPOINT指令，它們只是告訴容器在預設情況下應該執行什麼。如果你告訴Dockerfile期待各種ARG變數（沒有預設值），但在執行構建指令時卻沒有提供任何ARG變數，就會出現錯誤資訊。
然而，ARG值可以在映象建立後，透過檢視映象的docker歷史，很容易被檢查出來。因此，他們是敏感資料的一個糟糕選擇。
 
ENV變數在構建過程中也是可用的，只要你用ENV指令引入它們。然而，與ARG不同的是，它們也可以被從最終映象中啟動的容器所訪問。在啟動一個容器時，ENV值可以被覆蓋，下面會有更多的介紹。
 
下面是圍繞從Docker檔案構建Docker映象和執行容器的過程中，對ARG和ENV可用性的簡化概述。它們是重疊的，但ARG不能從容器內部使用。

設定ARG值
所以，你有你的Docker檔案，其中定義了ARG和ENV值。如何設定它們，以及在哪裡設定？你可以在Docker檔案中留空，或者設定預設值。如果你沒有為預期的ARG變數提供一個值，而這些變數沒有預設值，你會得到一個錯誤資訊。

這裡有一個Dockerfile的例子，既有預設值，也有沒有預設值的。

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}

Oh dang look at that a_value

version: '3'

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

設定ENV值
那麼，如何設定ENV值呢？你可以在啟動容器時設定（我們將在下面討論這個問題），但你也可以透過硬編碼在Docker檔案中直接提供預設ENV值。此外，你還可以為環境變數設定動態的預設值!

在構建映象時，你能提供的唯一東西是ARG值，如上所述。你不能直接提供ENV變數的值。然而，ARG和ENV都可以一起工作。你可以使用ARG來設定ENV變數的預設值。下面是一個基本的Docker檔案，使用硬編碼的預設值。

# 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

# 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!

• 1. 逐一提供數值
  在命令列中，使用-e標誌。

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

version: '3'

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

• [b]2. 從你的主機傳遞環境變數值[/b]

這和上面的方法是一樣的。唯一的區別是，你不提供一個值，而只是命名這個變數。這將使Docker訪問主機環境中的當前值，並將其傳遞給容器。

version: '3'

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

• 3. 從一個檔案中取值(env_file)

version: '3'

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

 

 
在我們繼續之前：如果你是Docker的新手，並且不習慣考慮映象和容器，就會經常遇到一個問題：如果你試圖在RUN語句中設定一個環境變數的值，比如RUN export VARI=5 && ...，你將無法在接下來的RUN語句中訪問它。其原因是，對於每個RUN語句，一個新的容器會從一箇中間映像中啟動。命令結束後會儲存一個映象，但環境變數不會以這種方式持續存在。

如果你對一個映像感到好奇，想知道它是否在容器啟動前提供了預設的ENV變數值，你可以檢查Image映像，看看哪些ENV條目是預設設定的。

# first, get the images on your system and their ids
$ docker images
# use one of those ids to take a closer look
$ docker inspect image-id

# look out for the "Env" entries

覆蓋ENV值
假設你有一個由Dockerfile構建的映象，它提供了預設的ENV值。從它啟動的容器可以訪問Dockerfile中定義的ENV變數。然而，這些值可以透過提供單一的環境變數或env_files來覆蓋，環境變數被解析並傳入容器。

一旦一個程式在容器內執行，或者當一個命令被評估時，他們可以為自己改變環境值。像這樣的東西。
$docker run myimage SOME_VAR=hi python app.py
將完全覆蓋你可能為app.py指令碼設定的任何SOME_VAR，即使在最後命令之前有一些帶有-e標誌的值。
優先順序是，從強到弱：容器化應用程式集的東西，來自單一環境條目的值，來自env_file(s)的值，最後是Dockerfile預設值。