Dockerfile檔案全面詳解

工具與資源中心

幫助開發者更加高效的工作，提供圍繞開發者全生命週期的工具與資源

https://developer.aliyun.com/tool/?spm=a1z389.11499242.0.0.65452413RKbu6I&utm_content=g_1000295017

一、 變數

變數用 $variable_name 或者 ${variable_name} 表示。

• ${variable:-word} 表示如果 variable 設定，則結果將是該值。如果 variable 未設定，word 則將是結果。
  
• ${variable:+word} 表示如果 variable 設定則為 word 結果，否則為空字串。
  

變數前加 \ 可以轉義成普通字串：\$foo or \${foo}，表示轉換為 $foo 和 ${foo} 文字。

二、FROM

初始化一個新的構建階段，並設定基礎映象：

FROM [--platform=<platform>] <image> [AS <name>]

FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]

FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]

• 單個 Dockfile 可以多次出現 FROM，以使用之前的構建階段作為另一個構建階段的依賴項
  
• AS name 表示為構建階段命名，在後續 FROM 和 COPY --from=<name> 說明中可以使用這個名詞，引用此階段構建的映像
  
• digest 其實就是就是根據映象內容產生的一個 ID，只要映象的內容不變 digest 也不會變
  
• tag 或 digest 值是可選的。如果您省略其中任何一個，構建器預設使用一個 latest 標籤。如果找不到該 tag 值，構建器將返回錯誤。
  
• --platform 標誌可用於在 FROM 引用多平臺映象的情況下指定平臺。例如，linux/amd64、linux/arm64、 或 windows/amd64。
  

三、RUN

將在當前映象之上的新層中執行命令，在 docker build時執行。

RUN /bin/bash -c 'source $HOME/.bashrc; \
echo $HOME'

RUN 有兩種形式：

• RUN<command>（shell 形式，命令在 shell 中執行，預設 /bin/sh -c 在 Linux 或 cmd /S /CWindows 上）
  
• RUN ["executable", "param1", "param2"]（執行形式）
  

說明：

• 可以使用 \（反斜槓）將單個 RUN 指令延續到下一行
  
• RUN 在下一次構建期間，指令快取不會自動失效。可以使用 --no-cache 標誌使指令快取無效
  
• Dockerfile 的指令每執行一次都會在 Docker 上新建一層。所以過多無意義的層，會造成映象膨脹過大，可以使用 && 符號連線命令，這樣執行後，只會建立 1 層映象
  

四、CMD

執行程式，在 docker run 時執行，但是和 run 命令不同，RUN 是在 docker build 時執行。

FROM ubuntu

CMD [ "/usr/bin/wc", "--help"]

支援三種格式：

• CMD ["executable","param1","param2"] 使用 exec 執行，推薦方式；
  
• CMD command param1 param2 在 /bin/sh 中執行，提供給需要互動的應用；
  
• CMD ["param1","param2"] 提供給 ENTRYPOINT 的預設引數。
  

指定啟動容器時執行的命令，每個 Dockerfile 只能有一條 CMD 命令。如果指定了多條命令，只有最後一條會被執行。

如果使用者啟動容器時候指定了執行的命令，則會覆蓋掉 CMD 指定的命令。

五、LABEL

新增後設資料：

LABEL multi.label1= "value1" \

     multi.label2= "value2" \

     other= "value3"

六、EXPOSE

EXPOSE <port> [<port>/<protocol>...]

Docker 容器在執行時偵聽指定的網路埠。可以指定埠是監聽TCP還是UDP，如果不指定協議，預設為TCP。

該 EXPOSE 指令實際上並未釋出埠。要在執行容器時實際釋出埠，docker run -P 來發布和對映一個或多個埠。

預設情況下，EXPOSE 假定 TCP。您還可以指定 UDP：

EXPOSE 80/udp

七、ENV

設定環境變數：

ENV <key>=<value> ...

設定的環境變數將持續存在，您可以使用 docker inspect 來檢視。使用 docker run --env <key>=<value> 來更改環境變數的值。

如果環境變數只在構建期間需要，請考慮為單個命令設定一個值：

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

或者使用 ARG，它不會保留在最終映象中：

ARG DEBIAN_FRONTEND=noninteractive

RUN apt-get update && apt-get install -y ...

八、ADD

複製新檔案、目錄或遠端檔案 URL <src> ，並將它們新增到 <dest> 中。

<src> 可以指定多個資源，但如果它們是檔案或目錄，則它們的路徑被解釋為相對於構建上下文的源，也就是 WORKDIR。

每個都 <src> 可能包含萬用字元，匹配將使用 Go 的 filepath.Match 規則。例如：

新增所有以“hom”開頭的檔案：

ADD hom* /mydir/

在下面的示例中，? 被替換為任何單個字元，例如“home.txt”。

ADD hom?.txt /mydir/

<dest> 是一個絕對路徑，或相對 WORKDIR 的相對路徑。

九、COPY

語法同ADD一致，複製複製檔案。

COPY 指令和 ADD 指令的唯一區別在於：是否支援從遠端URL獲取資源。COPY 指令只能從執行 docker build 所在的主機上讀取資源並複製到映象中。而 ADD 指令還支援透過 URL 從遠端伺服器讀取資源並複製到映象中。

相同需求時，推薦使用 COPY 指令。ADD 指令更擅長讀取本地tar檔案並解壓縮。

十、ENTRYPOINT

ENTRYPOINT 和 CMD 一樣，都是在指定容器啟動程式及引數，不過它不會被 docker run 的命令列引數指定的指令所覆蓋。如果要覆蓋的話，需要透過 docker run --entrypoint 來指定。

它有2種格式：

ENTRYPOINT [ "executable", "param1", "param2"]

ENTRYPOINT command param1 param2

指定了 ENTRYPOINT 後， CMD 的內容作為引數傳給 ENTRYPOINT 指令，實際執行時，將變為：

<ENTRYPOINT> <CMD>

十一、VOLUME

建立一個具有指定名稱的掛載資料卷。

VOLUME [ "/var/log/"]

VOLUME /var/ log

它的主要作用是：

• 避免重要的資料，因容器重啟而丟失
  
• 避免容器不斷變大
  

十二、ARG

定義變數，與 ENV 作用相同，不過 ARG 變數不會像 ENV 變數那樣持久化到構建好的映象中。

ARG <name>[=<default value>]

Docker 有一組預定義的 ARG 變數，您可以在 Dockerfile 中沒有相應指令的情況下使用這些變數。

• HTTP_PROXY
  
• http_proxy
  
• HTTPS_PROXY
  
• https_proxy
  
• FTP_PROXY
  
• ftp_proxy
  
• NO_PROXY
  
• no_proxy
  

要使用這些，請使用 --build-arg 標誌在命令列上傳遞它們，例如：

docker build --build-arg HTTPS_PROXY= .

十三、ONBUILD

將一個觸發指令新增到映象中，以便稍後在該映象用作另一個構建的基礎時執行。也就是另外一個 dockerfile FROM 了這個映象的時候執行。

ONBUILD ADD . /app/src

ONBUILD RUN /usr/ local/bin/python-build --dir /app/src

十四、STOPSIGNAL

設定將傳送到容器退出的系統呼叫訊號。該訊號可以是與核心系統呼叫表中的位置匹配的有效無符號數，例如 9，或格式為 SIGNAME 的訊號名稱，例如 SIGKILL。

STOPSIGNAL signal

預設的 stop-signal 是 SIGTERM，在 docker stop 的時候會給容器內 PID 為 1 的程式傳送這個 signal，透過 --stop-signal 可以設定自己需要的 signal，主要目的是為了讓容器內的應用程式在接收到 signal 之後可以先處理一些事物，實現容器的平滑退出，如果不做任何處理，容器將在一段時間之後強制退出，會造成業務的強制中斷，預設時間是 10s。

十五、HEALTHCHECK

用於指定某個程式或者指令來監控 Docker 容器服務的執行狀態。該 HEALTHCHECK 指令有兩種形式：

• HEALTHCHECK [OPTIONS] CMD command（透過在容器內執行命令來檢查容器健康狀況）
  
• HEALTHCHECK NONE（禁用從基礎映象繼承的任何健康檢查）
  

十六、SHELL

覆蓋用於命令的 shell 形式的預設 shell。Linux 上的預設 shell 是 ["/bin/sh", "-c"]，Windows 上是 ["cmd", "/S", "/C"]。

SHELL [ "executable", "parameters"]

該 SHELL 指令在 Windows 上特別有用，因為 Windows 有兩種常用且截然不同的本機 SHELL：cmd 和 powershell，以及可用的備用 shell，包括 sh。該 SHELL 指令可以出現多次。每條 SHELL 指令都會覆蓋所有先前的 SHELL 指令，並影響所有後續指令。

十七、WORKDIR

工作目錄，如果 WORKDIR 不存在，即使它沒有在後續 Dockerfile 指令中使用，它也會被建立。

docker build 構建映象過程中，每一個 RUN 命令都會新建一層。只有透過 WORKDIR 建立的目錄才會一直存在。

可以設定多個 WORKDIR，如果提供了相對路徑，它將相對於前一條 WORKDIR 指令的路徑。例如：

WORKDIR /a

WORKDIR b

WORKDIR c

RUN pwd

最終 pwd 命令的輸出是 /a/b/c。

該 WORKDIR 指令可以解析先前使用 ENV，例如：

ENV DIRPATH=/path

WORKDIR $DIRPATH/ $DIRNAME

RUN pwd

最終 pwd 命令的輸出是 /path/$DIRNAME。

十八、USER

設定使用者名稱（或 UID）和可選的使用者組（或 GID）。

USER <user>[:<group>]

USER <UID>[:<GID>]

原文地址：https://developer.aliyun.com/article/792192?spm=a2c6h.12873581.0.0.6b4c767ddusYkc&groupCode=othertech