Dockerfile 是一個用來構建鏡像的文本文件，文本內(nèi)容包含了一條條構建鏡像所需的指令和說明。

COPY

復制指令，從上下文目錄中復制文件或者目錄到容器里指定路徑。

格式：

COPY [--chown=:] <源路徑1>... <目標路徑>

COPY [--chown=:] ["<源路徑1>",... "<目標路徑>"]

[--chown=:]：可選參數(shù)，用戶改變復制到容器內(nèi)文件的擁有者和屬組。

<源路徑>：源文件或者源目錄，這里可以是通配符表達式，其通配符規(guī)則要滿足 Go 的 filepath.Match 規(guī)則。例如：

COPY hom* /mydir/

COPY hom?.txt /mydir/

<目標路徑>：容器內(nèi)的指定路徑，該路徑不用事先建好，路徑不存在的話，會自動創(chuàng)建。

ADD

ADD 指令和 COPY 的使用格式一致（同樣需求下，官方推薦使用 COPY）。功能也類似，不同之處如下：

ADD 的優(yōu)點：在執(zhí)行 <源文件> 為 tar 壓縮文件的話，壓縮格式為 gzip, bzip2 以及 xz 的情況下，會自動復制并解壓到 <目標路徑>。

ADD 的缺點：在不解壓的前提下，無法復制 tar 壓縮文件。會令鏡像構建緩存失效，從而可能會令鏡像構建變得比較緩慢。具體是否使用，可以根據(jù)是否需要自動解壓來決定。

CMD

類似于 RUN 指令，用于運行程序，但二者運行的時間點不同:

CMD 在docker run 時運行。

RUN 是在 docker build。

作用：為啟動的容器指定默認要運行的程序，程序運行結束，容器也就結束。CMD 指令指定的程序可被 docker run 命令行參數(shù)中指定要運行的程序所覆蓋。

注意：如果 Dockerfile 中如果存在多個 CMD 指令，僅最后一個生效。

格式：

CMD

CMD ["<可執(zhí)行文件或命令>","","",...]

CMD ["","",...]

推薦使用第二種格式，執(zhí)行過程比較明確。第一種格式實際上在運行的過程中也會自動轉換成第二種格式運行，并且默認可執(zhí)行文件是 sh。

ENTRYPOINT

類似于 CMD 指令，但其不會被 docker run 的命令行參數(shù)指定的指令所覆蓋，而且這些命令行參數(shù)會被當作參數(shù)送給 ENTRYPOINT 指令指定的程序。

但是, 如果運行 docker run 時使用了 --entrypoint 選項，此選項的參數(shù)可當作要運行的程序覆蓋 ENTRYPOINT 指令指定的程序。

優(yōu)點：在執(zhí)行 docker run 的時候可以指定 ENTRYPOINT 運行所需的參數(shù)。

注意：如果 Dockerfile 中如果存在多個 ENTRYPOINT 指令，僅最后一個生效。

格式：

ENTRYPOINT ["","","",...]

可以搭配 CMD 命令使用：一般是變參才會使用 CMD ，這里的 CMD 等于是在給 ENTRYPOINT 傳參，以下示例會提到。

示例：

假設已通過 Dockerfile 構建了 nginx:test 鏡像：

FROM nginx

ENTRYPOINT ["nginx", "-c"] # 定參

CMD ["/etc/nginx/nginx.conf"] # 變參

1、不傳參運行

$ docker run nginx:test

容器內(nèi)會默認運行以下命令，啟動主進程。

nginx -c /etc/nginx/nginx.conf

2、傳參運行

$ docker run nginx:test -c /etc/nginx/new.conf

容器內(nèi)會默認運行以下命令，啟動主進程(/etc/nginx/new.conf:假設容器內(nèi)已有此文件)

nginx -c /etc/nginx/new.conf

ENV

設置環(huán)境變量，定義了環(huán)境變量，那么在后續(xù)的指令中，就可以使用這個環(huán)境變量。

格式：

ENV

ENV==...

以下示例設置 NODE_VERSION = 7.2.0 ， 在后續(xù)的指令中可以通過 $NODE_VERSION 引用：

ENV NODE_VERSION 7.2.0

RUN curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION-linux-x64.tar.xz" \

&& curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/SHASUMS256.txt.asc"

ARG

構建參數(shù)，與 ENV 作用一至。不過作用域不一樣。ARG 設置的環(huán)境變量僅對 Dockerfile 內(nèi)有效，也就是說只有 docker build 的過程中有效，構建好的鏡像內(nèi)不存在此環(huán)境變量。

構建命令 docker build 中可以用 --build-arg <參數(shù)名>=<值> 來覆蓋。

格式：

ARG <參數(shù)名>[=<默認值>]

VOLUME

定義匿名數(shù)據(jù)卷。在啟動容器時忘記掛載數(shù)據(jù)卷，會自動掛載到匿名卷。

作用：

避免重要的數(shù)據(jù)，因容器重啟而丟失，這是非常致命的。

避免容器不斷變大。

格式：

VOLUME ["<路徑1>", "<路徑2>"...]

VOLUME <路徑>

在啟動容器 docker run 的時候，我們可以通過 -v 參數(shù)修改掛載點。

EXPOSE

僅僅只是聲明端口。

作用：

幫助鏡像使用者理解這個鏡像服務的守護端口，以方便配置映射。

在運行時使用隨機端口映射時，也就是 docker run -P 時，會自動隨機映射 EXPOSE 的端口。

格式：

EXPOSE <端口1> [<端口2>...]

WORKDIR

指定工作目錄。用 WORKDIR 指定的工作目錄，會在構建鏡像的每一層中都存在。（WORKDIR 指定的工作目錄，必須是提前創(chuàng)建好的）。

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

格式：

WORKDIR <工作目錄路徑>

USER

用于指定執(zhí)行后續(xù)命令的用戶和用戶組，這邊只是切換后續(xù)命令執(zhí)行的用戶（用戶和用戶組必須提前已經(jīng)存在）。

格式：

USER <用戶名>[:<用戶組>]

HEALTHCHECK

用于指定某個程序或者指令來監(jiān)控 docker 容器服務的運行狀態(tài)。

格式：

HEALTHCHECK [選項] CMD <命令>：設置檢查容器健康狀況的命令

HEALTHCHECK NONE：如果基礎鏡像有健康檢查指令，使用這行可以屏蔽掉其健康檢查指令

HEALTHCHECK [選項] CMD <命令> : 這邊 CMD 后面跟隨的命令使用，可以參考 CMD 的用法。

ONBUILD

用于延遲構建命令的執(zhí)行。簡單的說，就是 Dockerfile 里用 ONBUILD 指定的命令，在本次構建鏡像的過程中不會執(zhí)行（假設鏡像為 test-build）。當有新的 Dockerfile 使用了之前構建的鏡像 FROM test-build ，這是執(zhí)行新鏡像的 Dockerfile 構建時候，會執(zhí)行 test-build 的 Dockerfile 里的 ONBUILD 指定的命令。

格式：

ONBUILD <其它指令>