Docker 可以通過讀取 Dockerfile 中的指令自動構建映象。Dockerfile 是一個文字文件,其中包含了使用者建立映象的所有命令和說明。
一、 變數
變數用 $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=https://my-proxy.example.com .
十三、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://zhuanlan.zhihu.com/p/...