Dockerfile 是一個文字格式的配置檔案，使用者可以使用 Dockerfile 快速建立自定義的映象。我們會先介紹 Dockerfile 的基本結構及其支援的眾多指令，並具體講解通過執行指令來編寫定製映象的 Dockerfile。
基本結構
Dockerfile 由一行行命令語句組成，並且支援已 # 開頭的註釋行。一般而言，Dockerfile 的內容分為四個部分：基礎映象資訊、維護者資訊、映象操作指令和容器啟動時執行指令。例如：
# This dockerfile uses the Ubuntu image # VERSION 2 # Author: docker_user # Command format: Instruction [arguments / command] … # 第一行必須指定基於的容器映象 FROM ubuntu # 維護者資訊 MAINTAINER docker_user docker_user@email.com # 映象的操作指令 RUN echo “deb http://archive.ubuntu.com/ubuntu/ raring main universe” >> /etc/apt/sources.list RUN apt-get update && apt-get install -y nginx RUN echo “\ndaemon off;” >> /etc/nginx/nginx.conf # 容器啟動時執行指令 CMD /usr/sbin/nginx
其中，一開始必須指明所基於的映象名稱，接下來一般會說明維護者的資訊。後面則是映象操作指令，例如 RUN 指令，RUN 指令將對映象執行跟隨的命令。每執行一條 RUN 指令，映象新增新的一層，並提交。最後是 CMD 指令，來指定執行容器時的操作命令。
下面是兩個 dockerhub 上的例子，同學們可以對 Dockerfile 結構有個基本的感知。
第一個是在 Ubuntu 映象的基礎上安裝 inotify-tools、nginx、apache2、openssh-server 等軟體，從而建立一個新的 nginx 映象：
# nginx
# VERSION 0.0.1
FROM ubuntu
MAINTAINER Victor Vieus <victor@docker.com>
RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server
第二個也是基於 ubuntu 映象，安裝 firefox 和 vnc 軟體，啟動後，使用者可以通過 5900 埠通過 vnc 方式使用 firefox：
# Firefox over VNC # VERSION 0.3 FROM Ubuntu # Install vnc, xvfb in order to create a ‘fake’ display and firefox RUN apt-get update && apt-get install -y x11vnc xvfb firefox RUN mkdir /.vnc # setup a password RUN x11vnc -storepasswd 1234 ~/.vnc/passwd # Autostart firefox RUN bash -c ‘echo “firefox” >> /.bashrc’ EXPOSE 5900 CMD [“x11vnc”, “-forever”, “-usepw”, “-create”]
指令
指令的一般格式為 INSTRUCTION arguments，指令包括 FROM、MAINTAINER、RUN 等，下面分別介紹。
FROM
格式為 FROM <image> 或 FROM<image>:<tag>。
Dockerfile 的第一條指令必須為 FROM 指令。並且，如果在同一個 Dockerfile 中建立多個映象時，可以使用多個 FROM 指令。
MAINTAINER
格式為 MAINTAINER <name>，指定維護者資訊。
注意：MAINTAINER 指令已經被拋棄，建議使用 LABEL 指令。
LABEL
格式為:
LABEL <key>=<value> <key>=<value> <key>=<value> ...
LABEL 指令為映象新增標籤。一個 LABEL 就是一個鍵值對。
下面是一些例子:
LABEL "com.example.vendor"="ACME Incorporated" LABEL com.example.label-with-value="foo" LABEL version="1.0" LABEL description="This text illustrates \that label-values can span multiple lines."
我們可以給映象新增多個 LABEL，需要注意的是，每條 LABEL 指令都會生成一個新的層。所以最好是把新增的多個 LABEL 合併為一條命令：
LABEL multi.label1="value1" multi.label2="value2" other="value3"
也可以寫成這樣：
LABEL multi.label1="value1" \ multi.label2="value2" \ other="value3"
如果新新增的 LABEL 和已有的 LABEL 同名，則新值會覆蓋掉舊值。
我們可以使用 docker inspect 命令檢視映象的 LABEL 資訊。
RUN
有兩種格式，分別為：
RUN <command>
RUN [“executable”, “param1”, “param2”]。
前者將在 shell 終端中執行命令，即 /bin/sh -c，後者則使用 exec 執行。指定使用其他終端可以通過第二種方式實現，例如 RUN [“/bin/bash”, “-c”, “echo hello”]。
每條 RUN 指令將在當前映象的基礎上執行指定命令，並提交為新的映象。當命令較長時可以使用 \ 來換行。
CMD
支援三種格式：
CMD [“executable”, “param1”, “param2”] 使用 exec 執行，推薦方式。 CMD command param1 param2 在 /bin/sh 中執行，提供給需要互動的應用。 CMD [“param1”, “param2”] 提供給 ENTRYPOINT 的預設引數。
指定啟動容器時執行的命令，每個 Dockerfile 只能有一條 CMD 命令。如果指定了多條 CMD 命令，只有最後一條會被執行。如果使用者在啟動容器時指定了要執行的命令，則會覆蓋掉 CMD 指定的命令。
EXPOSE
格式為：
EXPOSE <port> [<port>…]
例如：EXPOSE 22 80 8443
告訴 Docker 服務，容器需要暴露的埠號，供互聯絡統使用。在啟動容器時需要通過 -P 引數讓 Docker 主機分配一個埠轉發到指定的埠。使用 -p 引數則可以具體指定主機上哪個埠對映過來。
ENV
格式為 ENV <key> <value>。指定一個環境變數，會被後續 RUN 指令使用，並在容器執行時保持。例如：
ENV PG_MAJOR 9.3 ENV PG_VERSION 9.3.4 RUN curl -SL http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC /usr/src/postgress && … ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH
ADD
格式為：
ADD <src> <dest>
該命令將複製指定的 <src> 到容器中的 <dest>。其中 <src> 可以是 Dockerfile 所在目錄的一個相對路徑(檔案或目錄)；也可以是一個 URL；還可以是一個 tar 檔案(自動解壓為目錄)。
COPY
格式為：
COPY <src> <dest>
複製本地主機的 <src> (為 Dockerfile 所在目錄的相對路徑，檔案或目錄) 為容器中的 <dest>。目標路徑不存在時，會自動建立。當使用本地目錄為源目錄時，推薦使用 COPY。
ENTRYPOINT
有兩種格式：
ENTRYPOINT [“executable”, “param1”, “param2”]
ENTRYPOINT command param1 param2 (shell 中執行)
配置容器啟動後執行的命令，並且不可被 docker run 提供的引數覆蓋。
每個 Dockerfile 中只能有一個 ENTRYPOINT，當指定多個 ENTRYPOINT 時，只有最後一個生效。
VOLUME
格式為：
VOLUME ["/data"]
也可以使用 VOLUME 指令新增多個資料卷：
VOLUME ["/data1", "/data2"]
建立一個可以從本地或其他容器掛載的掛載點，一般用來存放資料庫和需要保持的資料等。
USER
格式為：
USER daemon
指定執行容器時的使用者名稱或 UID，後續的 RUN 也會使用指定使用者。當服務不需要管理員許可權時，可以通過該命令指定執行使用者。並且可以在之前建立所需要的使用者，例如：RUN groupadd -r postgres && useradd -r -g postgres postgres。
WORKDIR
格式為：
WORKDIR /path/to/workdir
為後續的 RUN、CMD、ENTRYPOINT 指令配置工作目錄。可以使用多個 WORKDIR 指令，後續命令如果引數是相對路徑，則會基於之前命令指定的路徑。例如：
WORKDIR /a WORKDIR b WORKDIR c RUN pwd
則最終路徑為 /a/b/c。
ONBUILD
格式為：
ONBUILD [INSTRUCTION]
配置當所建立的映象作為其他新建立映象的基礎映象時，所執行的操作指令。例如，Dockerfile 使用如下的內容建立了映象 image-A。
… ONBUILD ADD . /app/src ONBUILD RUN /usr/local/bin/python-build –dir /app/src …
如果基於 image-A 建立新的映象時，新的 Dockerfile 中使用 FROM image-A 指定基礎映象時，會自動執行 ONBUILD 指令內容，等價於在後面新增了兩條指令。
FROM image-A #automatically run the following ADD . /app/src RUN /usr/local/bin/python-build –dir /app/src
建立映象
編寫完成 Dockerfile 之後，可以通過 docker build 命令來建立映象。
基本的格式為 docker build [選項] 路徑，該命令將讀取指定路徑下(包括子目錄)的 Dockerfile ，並將該路徑下所有內容傳送給 docker 服務端，由服務端來建立映象。因此一般建議放置 Dockerfile 的目錄為空目錄。
另外，可以通過 .dockerignore 檔案來讓 docker 忽略路徑下的目錄和檔案。 要指定映象的標籤資訊，可以通過 -t 選項來實現。
例如，指定 Dockerfile 所在路徑為 /tmp/docker_builder/，並且希望生成映象標籤為 build_repo/first_image，可以使用下面的命令：
$ sudo docker build -t build_repo/first_image /tmp/docker_builder/
# 如果不想使用上次 build 過程中產生的 cache 可以新增 --no-cache 選項
$ sudo docker build --no-cache -t build_repo/first_image /tmp/docker_builder