Dockerfile

Dockerfile是一個文字格式的配置檔案，使用者可以使用Dockerfile快速建立自定義的映象。

基本結構

Dockerfile由一行行命令語句組成，並且支援以#開頭的註釋行。 一般而言，Dockerfile分為四個部分：基礎映象資訊、維護者資訊、映象操作指令和容器啟動時執行指令。例如：

#This dockerfile uses the ubuntu image
#VERSION - EDITION 1
#Author :docker_user
#Command format:Instruction [arguments/command] ..

#第一行必須指定基於的基礎映象
FROM ubuntu

#維護者資訊
MAINTAINER docker_user 
 
[email protected]

#映象的操作指令
RUN echo 'deb http://archive.ubuntu.com/ubuntu/ raring main universe' >> /etc/apt/source.list
RUN apt-get update && apt-get install -y nginx
RUN echo '\ndaemon off;'>> /etc/nginx/nginx.conf

#容器啟動時執行指令
CMD /usr/sbin/nginx

下面倆個例子是Dockerhub上面的 第一個實在ubuntu父映象基礎上安裝inotify-tools、nginx、apache2、openssh-server等軟體，從而建立一個新的Nginx映象：

# Nginx
#
#VERSION 0.0.1

FROM ubuntu
MAINTAINER Victor Vieux <[email protected]>

RUN apt-get update && apt-get install -yinotify-tools nginx apache2 openssh-server

第二個也是基於ubuntu父映象，安裝firefox和vnc軟體，啟動後，使用者可以通過5900埠通過vnc方式使用firefox：

#Firefox over VNC
#
#VERSION 0.3
FROM ubuntu
RUN apt-get update && apt-get install -y xllvnc xvfb firefox
RUN mkdir /.vnc
RUN xllvnc -storepasswd 1234 ~/.vnc/passwd
RUN bash -c 'echo "firefox">> /.bashrc'
EXPOSE 5900
CMD ['xllvnc','-forever','-usepw','-create']
 

指令

指令包括FROM、MAINTAINER、RUN等

FROM 格式為FROM <image> 或FROM<image>:<tag>。 第一條指令必須為FROM指令。並且，如果在同一個Dockerfile中建立多個映象時，可以使用多個FROM指令（每個映象一次）。

MAINTAINER 格式為MAINTAINER<name>，指定維護者資訊。

RUN 格式為RUN<command>或RUN [“executable”,“paraml”,“param2”]。 前者將在shell終端中執行命令，即/bin/sh -c;後者則使用exec執行。指定使用其他終端可以通過第二種方式實現，例如 RUN [’/bin/bash’,’-c’,‘echo hello’]。 每條RUN 指令將在當前映象基礎上執行指定命令，並提交為新的映象。當命令較長時可以使用\來換行。

CMD 支援三種格式：

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

指定啟動容器時執行的命令，每個Dockerfile只能有一條CMD命令。如果指定了多條命令，只有最後一條會被執行。 如果使用者啟動容器時候指定了執行的命令，則會覆蓋掉CMD指定的命令。

EXPOSE 格式為EXPOSE <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"] 建立一個可以從本地主機或其他容器掛載的掛載點，一般用來存放資料庫和需要保持的資料等。

USER 格式為USER daemon。 指定執行容器時的使用者名稱或UID，後續的RUN也會使用指定使用者。 當服務不需要管理員許可權時，可以通過該命令指定執行使用者。

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指令內容，等價於在後面添加了倆條指令。

建立映象

編寫完成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/