Dockerfile 是一個(gè)文本格式的配置文件，用戶可以使用 Dockerfile 快速創(chuàng)建自定義的鏡像。我們會(huì)先介紹 Dockerfile 的基本結(jié)構(gòu)及其支持的眾多指令，并具體講解通過(guò)執(zhí)行指令來(lái)編寫定制鏡像的 Dockerfile。

基本結(jié)構(gòu)

Dockerfile 由一行行命令語(yǔ)句組成，并且支持已 # 開(kāi)頭的注釋行。一般而言，Dockerfile 的內(nèi)容分為四個(gè)部分：基礎(chǔ)鏡像信息、維護(hù)者信息、鏡像操作指令和容器啟動(dòng)時(shí)執(zhí)行指令。例如：

# This dockerfile uses the Ubuntu image
# VERSION 2
# Author: docker_user
# Command format: Instruction [arguments / command] …

# 第一行必須指定基于的容器鏡像
FROM ubuntu

# 維護(hù)者信息
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

# 容器啟動(dòng)時(shí)執(zhí)行指令
CMD /usr/sbin/nginx

其中，一開(kāi)始必須指明所基于的鏡像名稱，接下來(lái)一般會(huì)說(shuō)明維護(hù)者的信息。后面則是鏡像操作指令，例如 RUN 指令，RUN 指令將對(duì)鏡像執(zhí)行跟隨的命令。每運(yùn)行一條 RUN 指令，鏡像添加新的一層，并提交。最后是 CMD 指令，來(lái)指定運(yùn)行容器時(shí)的操作命令。

下面是兩個(gè) dockerhub 上的例子，同學(xué)們可以對(duì) Dockerfile 結(jié)構(gòu)有個(gè)基本的感知。

第一個(gè)是在 Ubuntu 鏡像的基礎(chǔ)上安裝 inotify-tools、nginx、apache2、openssh-server 等軟件，從而創(chuàng)建一個(gè)新的 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

第二個(gè)也是基于 ubuntu 鏡像，安裝 firefox 和 vnc 軟件，啟動(dòng)后，用戶可以通過(guò) 5900 端口通過(guò) 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 指令。并且，如果在同一個(gè) Dockerfile 中創(chuàng)建多個(gè)鏡像時(shí)，可以使用多個(gè) FROM 指令。

MAINTAINER

格式為 MAINTAINER <name>，指定維護(hù)者信息。

注意：MAINTAINER 指令已經(jīng)被拋棄，建議使用 LABEL 指令。

LABEL

格式為:

LABEL <key>=<value> <key>=<value> <key>=<value> ...

LABEL 指令為鏡像添加標(biāo)簽。一個(gè) LABEL 就是一個(gè)鍵值對(duì)。

下面是一些例子:

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."

我們可以給鏡像添加多個(gè) LABEL，需要注意的是，每條 LABEL 指令都會(huì)生成一個(gè)新的層。所以最好是把添加的多個(gè) LABEL 合并為一條命令：

LABEL multi.label1="value1" multi.label2="value2" other="value3"

也可以寫成這樣：

LABEL multi.label1="value1" \
   multi.label2="value2" \
   other="value3"

如果新添加的 LABEL 和已有的 LABEL 同名，則新值會(huì)覆蓋掉舊值。

我們可以使用 docker inspect 命令查看鏡像的 LABEL 信息。

RUN

有兩種格式，分別為：

RUN <command>

RUN [“executable”, “param1”, “param2”]

前者將在 shell 終端中運(yùn)行命令，即 /bin/sh -c，后者則使用 exec 執(zhí)行。指定使用其他終端可以通過(guò)第二種方式實(shí)現(xiàn)，例如 RUN  [“/bin/bash”, “-c”, “echo hello”]。

每條 RUN 指令將在當(dāng)前鏡像的基礎(chǔ)上執(zhí)行指定命令，并提交為新的鏡像。當(dāng)命令較長(zhǎng)時(shí)可以使用 \ 來(lái)?yè)Q行。

CMD

支持三種格式：

CMD [“executable”, “param1”, “param2”] 使用 exec 執(zhí)行，推薦方式。

CMD command param1 param2 在 /bin/sh 中執(zhí)行，提供給需要交互的應(yīng)用。

CMD [“param1”, “param2”] 提供給 ENTRYPOINT 的默認(rèn)參數(shù)。

指定啟動(dòng)容器時(shí)執(zhí)行的命令，每個(gè) Dockerfile 只能有一條 CMD 命令。如果指定了多條 CMD 命令，只有最后一條會(huì)被執(zhí)行。如果用戶在啟動(dòng)容器時(shí)指定了要運(yùn)行的命令，則會(huì)覆蓋掉 CMD 指定的命令。

EXPOSE

格式為：

EXPOSE <port> [<port>…]

例如：EXPOSE 22 80 8443

告訴 Docker 服務(wù)，容器需要暴露的端口號(hào)，供互聯(lián)系統(tǒng)使用。在啟動(dòng)容器時(shí)需要通過(guò) -P 參數(shù)讓 Docker 主機(jī)分配一個(gè)端口轉(zhuǎn)發(fā)到指定的端口。使用 -p 參數(shù)則可以具體指定主機(jī)上哪個(gè)端口映射過(guò)來(lái)。

ENV

格式為 ENV <key> <value>。指定一個(gè)環(huán)境變量，會(huì)被后續(xù) RUN 指令使用，并在容器運(yùn)行時(shí)保持。例如：

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>

該命令將復(fù)制指定的 <src> 到容器中的 <dest>。其中 <src> 可以是 Dockerfile 所在目錄的一個(gè)相對(duì)路徑(文件或目錄)；也可以是一個(gè) URL；還可以是一個(gè) tar 文件(自動(dòng)解壓為目錄)。

COPY

格式為：

COPY <src> <dest>

復(fù)制本地主機(jī)的 <src> (為 Dockerfile 所在目錄的相對(duì)路徑，文件或目錄) 為容器中的 <dest>。目標(biāo)路徑不存在時(shí)，會(huì)自動(dòng)創(chuàng)建。當(dāng)使用本地目錄為源目錄時(shí)，推薦使用 COPY。

ENTRYPOINT

有兩種格式：

ENTRYPOINT [“executable”, “param1”, “param2”]

ENTRYPOINT command param1 param2 (shell 中執(zhí)行)

配置容器啟動(dòng)后執(zhí)行的命令，并且不可被 docker run 提供的參數(shù)覆蓋。

每個(gè) Dockerfile 中只能有一個(gè) ENTRYPOINT，當(dāng)指定多個(gè) ENTRYPOINT 時(shí)，只有最后一個(gè)生效。

VOLUME

格式為：

 VOLUME ["/data"]

創(chuàng)建一個(gè)可以從本地或其他容器掛載的掛載點(diǎn)，一般用來(lái)存放數(shù)據(jù)庫(kù)和需要保持的數(shù)據(jù)等。

USER

格式為：

USER daemon

指定運(yùn)行容器時(shí)的用戶名或 UID，后續(xù)的 RUN 也會(huì)使用指定用戶。當(dāng)服務(wù)不需要管理員權(quán)限時(shí)，可以通過(guò)該命令指定運(yùn)行用戶。并且可以在之前創(chuàng)建所需要的用戶，例如：RUN groupadd -r postgres && useradd -r -g postgres postgres。

WORKDIR

格式為：

WORKDIR /path/to/workdir

為后續(xù)的 RUN、CMD、ENTRYPOINT 指令配置工作目錄?？梢允褂枚鄠€(gè) WORKDIR 指令，后續(xù)命令如果參數(shù)是相對(duì)路徑，則會(huì)基于之前命令指定的路徑。例如：

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd

則最終路徑為 /a/b/c。

ONBUILD

格式為：

ONBUILD [INSTRUCTION]

配置當(dāng)所創(chuàng)建的鏡像作為其他新創(chuàng)建鏡像的基礎(chǔ)鏡像時(shí)，所執(zhí)行的操作指令。例如，Dockerfile 使用如下的內(nèi)容創(chuàng)建了鏡像 image-A。

…
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build –dir /app/src
…

如果基于 image-A 創(chuàng)建新的鏡像時(shí)，新的 Dockerfile 中使用 FROM image-A 指定基礎(chǔ)鏡像時(shí)，會(huì)自動(dòng)執(zhí)行 ONBUILD 指令內(nèi)容，等價(jià)于在后面添加了兩條指令。

FROM image-A
#automatically run the following
ADD . /app/src
RUN /usr/local/bin/python-build –dir /app/src

創(chuàng)建鏡像

編寫完成 Dockerfile 之后，可以通過(guò) docker build 命令來(lái)創(chuàng)建鏡像。

基本的格式為 docker build [選項(xiàng)] 路徑，該命令將讀取指定路徑下(包括子目錄)的 Dockerfile ，并將該路徑下所有內(nèi)容發(fā)送給 docker 服務(wù)端，由服務(wù)端來(lái)創(chuàng)建鏡像。因此一般建議放置 Dockerfile 的目錄為空目錄。

另外，可以通過(guò) .dockerignore 文件來(lái)讓 docker 忽略路徑下的目錄和文件。 要指定鏡像的標(biāo)簽信息，可以通過(guò) -t 選項(xiàng)來(lái)實(shí)現(xiàn)。
例如，指定 Dockerfile 所在路徑為 /tmp/docker_builder/，并且希望生成鏡像標(biāo)簽為 build_repo/first_image，可以使用下面的命令：

$ sudo docker build -t build_repo/first_image /tmp/docker_builder/

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論