（轉）Docker 基礎 : Dockerfile

全文來自 Docker 基礎 : Dockerfile

 

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、apache二、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"]

建立一個能夠從本地或其餘容器掛載的掛載點，通常用來存放數據庫和須要保持的數據等。

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/