Docker 可以通過讀取 Dockerfile 中的指令自動構(gòu)建鏡像。Dockerfile 是一個文本文檔，其中包含了用戶創(chuàng)建鏡像的所有命令和說明。

[[434144]]

一、 變量

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

•  ${variable:-word} 表示如果 variable 設(shè)置，則結(jié)果將是該值。如果 variable 未設(shè)置，word 則將是結(jié)果。
•  ${variable:+word} 表示如果 variable 設(shè)置則為 word 結(jié)果，否則為空字符串。

變量前加 \可以轉(zhuǎn)義成普通字符串：\$foo or \${foo}，表示轉(zhuǎn)換為 $foo 和 ${foo}文字。

二、FROM

初始化一個新的構(gòu)建階段，并設(shè)置基礎(chǔ)鏡像： 

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

單個 Dockfile 可以多次出現(xiàn) FROM，以使用之前的構(gòu)建階段作為另一個構(gòu)建階段的依賴項。超詳細280頁Docker實戰(zhàn)文檔！開放下載

AS name 表示為構(gòu)建階段命名，在后續(xù) FROM 和 COPY --from=<name>說明中可以使用這個名詞，引用此階段構(gòu)建的映像

digest 其實就是就是根據(jù)鏡像內(nèi)容產(chǎn)生的一個 ID，只要鏡像的內(nèi)容不變 digest 也不會變

tag 或 digest 值是可選的。如果您省略其中任何一個，構(gòu)建器默認使用一個 latest 標簽。如果找不到該 tag 值，構(gòu)建器將返回錯誤。

--platform 標志可用于在 FROM 引用多平臺鏡像的情況下指定平臺。例如，linux/amd64、linux/arm64、 或 windows/amd64。

三、RUN

將在當前鏡像之上的新層中執(zhí)行命令，在 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"]（執(zhí)行形式） 

說明： 

可以使用 \（反斜杠）將單個 RUN 指令延續(xù)到下一行  
RUN 在下一次構(gòu)建期間，指令緩存不會自動失效?？梢允褂?nbsp;--no-cache 標志使指令緩存無效  
Dockerfile 的指令每執(zhí)行一次都會在 Docker 上新建一層。所以過多無意義的層，會造成鏡像膨脹過大，可以使用 && 符號連接命令，這樣執(zhí)行后，只會創(chuàng)建 1 層鏡像  

四、CMD

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

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

支持三種格式： 

CMD ["executable","param1","param2"] 使用 exec 執(zhí)行，推薦方式；  
CMD command param1 param2 在 /bin/sh 中執(zhí)行，提供給需要交互的應(yīng)用；  
CMD ["param1","param2"] 提供給 ENTRYPOINT 的默認參數(shù)。 

指定啟動容器時執(zhí)行的命令，每個 Dockerfile 只能有一條 CMD 命令。如果指定了多條命令，只有最后一條會被執(zhí)行。徹夜怒肝！Docker 常見疑難雜癥解決方案已擼完，快要裂開了。。。

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

五、LABEL

添加元數(shù)據(jù)： 

LABEL multi.label1="value1" \  
      multi.label2="value2" \  
      other="value3" 

六、EXPOSE

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

Docker 容器在運行時偵聽指定的網(wǎng)絡(luò)端口?？梢灾付ǘ丝谑潜O(jiān)聽TCP還是UDP，如果不指定協(xié)議，默認為TCP。

該 EXPOSE 指令實際上并未發(fā)布端口。要在運行容器時實際發(fā)布端口，docker run -P來發(fā)布和映射一個或多個端口。

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

EXPOSE 80/udp 

七、ENV

設(shè)置環(huán)境變量： 

ENV <key>=<value> ... 

設(shè)置的環(huán)境變量將持續(xù)存在，您可以使用 docker inspect 來查看。使用docker run --env <key>=<value>來更改環(huán)境變量的值。Docker 入門終極指南！邊學(xué)邊用

如果環(huán)境變量只在構(gòu)建期間需要，請考慮為單個命令設(shè)置一個值： 

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

復(fù)制新文件、目錄或遠程文件 URL <src>,并將它們添加到 <dest>中。

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

每個都 <src>可能包含通配符，匹配將使用 Go 的 filepath.Match 規(guī)則。例如：

添加所有以“hom”開頭的文件： 

ADD hom* /mydir/ 

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

ADD hom?.txt /mydir/ 

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

九、COPY

語法同ADD一致，復(fù)制拷貝文件。

COPY 指令和 ADD 指令的唯一區(qū)別在于：是否支持從遠程URL獲取資源。COPY 指令只能從執(zhí)行 docker build 所在的主機上讀取資源并復(fù)制到鏡像中。而 ADD 指令還支持通過 URL 從遠程服務(wù)器讀取資源并復(fù)制到鏡像中。

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

十、ENTRYPOINT

ENTRYPOINT 和 CMD 一樣，都是在指定容器啟動程序及參數(shù)，不過它不會被 docker run 的命令行參數(shù)指定的指令所覆蓋。如果要覆蓋的話，需要通過 docker run --entrypoint 來指定。

它有2種格式： 

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

指定了 ENTRYPOINT 后， CMD 的內(nèi)容作為參數(shù)傳給 ENTRYPOINT 指令，實際執(zhí)行時，將變?yōu)椋?/p>

<ENTRYPOINT> <CMD> 

十一、VOLUME

創(chuàng)建一個具有指定名稱的掛載數(shù)據(jù)卷。 

VOLUME ["/var/log/"]  
VOLUME /var/log 

它的主要作用是：

•  避免重要的數(shù)據(jù)，因容器重啟而丟失
•  避免容器不斷變大

十二、ARG

定義變量，與 ENV 作用相同，不過 ARG 變量不會像 ENV 變量那樣持久化到構(gòu)建好的鏡像中。 

ARG <name>[=<default value>] 

Docker 有一組預(yù)定義的 ARG 變量，您可以在 Dockerfile 中沒有相應(yīng)指令的情況下使用這些變量。 

HTTP_PROXY  
http_proxy  
HTTPS_PROXY  
https_proxy  
FTP_PROXY  
ftp_proxy  
NO_PROXY  
no_proxy 

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

docker build --build-arg HTTPS_PROXY=https://my-proxy.example.com .

十三、ONBUILD

將一個觸發(fā)指令添加到鏡像中，以便稍后在該鏡像用作另一個構(gòu)建的基礎(chǔ)時執(zhí)行。也就是另外一個 dockerfile FROM 了這個鏡像的時候執(zhí)行。 

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

十四、STOPSIGNAL

設(shè)置將發(fā)送到容器退出的系統(tǒng)調(diào)用信號。該信號可以是與內(nèi)核系統(tǒng)調(diào)用表中的位置匹配的有效無符號數(shù)，例如 9，或格式為 SIGNAME 的信號名稱，例如 SIGKILL。STOPSIGNAL signal

默認的 stop-signal 是 SIGTERM，在 docker stop 的時候會給容器內(nèi) PID 為 1 的進程發(fā)送這個 signal，通過 --stop-signal 可以設(shè)置自己需要的 signal，主要目的是為了讓容器內(nèi)的應(yīng)用程序在接收到 signal 之后可以先處理一些事物，實現(xiàn)容器的平滑退出，如果不做任何處理，容器將在一段時間之后強制退出，會造成業(yè)務(wù)的強制中斷，默認時間是 10s。

十五、HEALTHCHECK

用于指定某個程序或者指令來監(jiān)控 Docker 容器服務(wù)的運行狀態(tài)。該 HEALTHCHECK 指令有兩種形式： 

HEALTHCHECK [OPTIONS] CMD command（通過在容器內(nèi)運行命令來檢查容器健康狀況）  
或者  
HEALTHCHECK NONE（禁用從基礎(chǔ)鏡像繼承的任何健康檢查）  

十六、SHELL

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

SHELL ["executable", "parameters"] 

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

十七、WORKDIR

工作目錄，如果 WORKDIR 不存在，即使它沒有在后續(xù) Dockerfile 指令中使用，它也會被創(chuàng)建。

docker build 構(gòu)建鏡像過程中，每一個 RUN 命令都會新建一層。只有通過 WORKDIR 創(chuàng)建的目錄才會一直存在。

可以設(shè)置多個 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

設(shè)置用戶名（或 UID）和可選的用戶組（或 GID）。 

USER <user>[:<group>]  
USER <UID>[:<GID>]