Dockerfile是一個(gè)文本格式的配置文件催烘,用戶可以使用Dockerfile快速創(chuàng)建自定義的鏡像炕吸。
基本結(jié)構(gòu)
Dockerfile由一行行命令語(yǔ)句構(gòu)成,并且支持以#開頭的注釋行。一般而言旧噪,Dockerfile分為四部分:基礎(chǔ)鏡像信息、維護(hù)者信息脓匿、鏡像操作指令和容器啟動(dòng)時(shí)執(zhí)行指令淘钟,例如:
#This dockerfile uses the ubuntu image
#VERSION 2 - EDITION 1
#Author:docker_user
#Command format:Instruction [arguments / command]
# 第一行必須制定基于的基礎(chǔ)鏡像
FROM ubuntu
# 維護(hù)者信息
MAINTAINER docker_user docker_user@email.com
# 鏡像的操作指令
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
# 容器啟動(dòng)時(shí)執(zhí)行指令
CMD /usr/sbin/nginx
以上例子中,一開始必須指明所基于的鏡像名稱陪毡,接下來一般會(huì)說明維護(hù)者信息米母。后面則是鏡像操作指令,例如RUN指令毡琉,RUN指令將對(duì)鏡像執(zhí)行跟隨的命令铁瞒。每運(yùn)行一條RUN指令,鏡像添加新的一層桅滋,并提交慧耍。最后是CMD指令,來指定運(yùn)行容器時(shí)的操作命令丐谋。
下面是DockerHub上的兩個(gè)Dockerfile例子
# Nginx
#
# VERSION 0.0.1
FROM ubuntu
MAINTAINER Victor Vieux <victor@docker.com>
RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server
該示例是在ubuntu父鏡像基礎(chǔ)上安裝inotify-tools芍碧、Nginx、Apache2号俐、openssh-server等軟件泌豆,從而創(chuàng)建一個(gè)新的Nginx鏡像。
# 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 (might not be the best way,but it does the trick)
RUN bash -c 'echo "firefox" >> /.bashrc'
EXPOSE 5900
CMD ["x11vnc", "-forever", "-usepw", "-create"]
該示例也是基于ubuntu父鏡像吏饿,安裝Firefoxvnc踪危,啟動(dòng)后,用戶可以通過5900端口通過vnc方式使用Firefox猪落。
指令
指令的一般格式為INSTRUCTION arguments贞远,指令包括FROM、MAINTAINER许布、RUN
1.FROM
格式為FROM<image> 或 FROM<image>:<tag>
第一條指令必須為FROM指令兴革,并且,如果在同一個(gè)Dockerfile中創(chuàng)建多個(gè)鏡像時(shí)蜜唾,可以使用多個(gè)FROM指令(每個(gè)鏡像一次)杂曲。
2.MAINTAINER
格式為MAINTAINER<name>,指定維護(hù)者信息袁余。
3.RUN
格式為RUN<command>或RUN["executable", "param1", "param2"]
前者將在shell終端中運(yùn)行命令擎勘,即/bin/sh -C;后者則使用exec執(zhí)行颖榜。指定使用其他終端可以通過第二種方式實(shí)現(xiàn)棚饵,例如RUN ["/bin/bash", "-C", "echo hello"]
每條RUN指令將在當(dāng)前鏡像基礎(chǔ)上執(zhí)行指定命令煤裙,并提交為新的鏡像。當(dāng)命令較長(zhǎng)時(shí)可以使用\來?yè)Q行噪漾。
4.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指定的命令。
5.EXPOSE
格式為EXPOSE [port] [<port>...]缓熟,例如:EXPOSE 22 80 8443
告訴Docker服務(wù)端容器暴露的端口號(hào)累魔,供互聯(lián)容器使用。在啟動(dòng)容器時(shí)需通過-P荚虚,Docker主機(jī)會(huì)自動(dòng)分配一個(gè)端口轉(zhuǎn)發(fā)到指定的端口薛夜;使用-p,則可以具體指定哪個(gè)本地端口映射過來
6.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/postgres &&...
ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH
7.ADD
格式為ADD<src> <dest>
該命令將復(fù)制指定的<src>到容器的<dest>。其中<src>可以是Dockerfile所在目錄的一個(gè)相對(duì)路徑(文件或目錄)吮龄;也可以是一個(gè)URL俭茧;還可以是一個(gè)tar文件(自動(dòng)解壓為目錄)
8.COPY
格式為COPY <src> <dest>
復(fù)制本地主機(jī)的<src>(為Dockerfile所在目錄的相對(duì)路徑,文件或目錄)為容器中的<dest>漓帚。目標(biāo)路徑不存在時(shí)母债,會(huì)自動(dòng)創(chuàng)建。
當(dāng)使用本地目錄為源目錄時(shí)尝抖,推薦使用COPY毡们。
9.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è)生效搅荞。
10.VOLUME
格式為VOLUME["/data"]
創(chuàng)建一個(gè)可以從本地主機(jī)或其他容器掛載的掛載點(diǎn)红氯,一般用來存放數(shù)據(jù)庫(kù)和需要保持的數(shù)據(jù)等框咙。
11.USER
格式為USER daemon
指定運(yùn)行容器時(shí)的用戶名或UID,后續(xù)的RUN也會(huì)使用指定用戶痢甘。
當(dāng)服務(wù)不需要管理員權(quán)限時(shí)喇嘱,可以通過該命令指定運(yùn)行用戶。并且可以在之前創(chuàng)建所需要的用戶塞栅,例如:RUN groupadd -r postgres && useradd -r -g postgres postgres者铜。要臨時(shí)獲取管理員權(quán)限可以使用gosu,而不推薦sudo构蹬。
12.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
13.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
ADD ./app/src
RUN /usr/local/bin/python-build --dir /app/src
使用ONBUILD指令的鏡像期吓,推薦在標(biāo)簽中注明,例如ruby:1.9-onbuild
創(chuàng)建鏡像
編寫完成Dockerfile之后倾芝,可以通過docker build命令來創(chuàng)建鏡像讨勤。
基本格式為docker build[選項(xiàng)]路徑,該命令將讀取指定路徑下(包括子目錄)的Dockerfile晨另,并將該路徑下所有內(nèi)容發(fā)送給Docker服務(wù)端潭千,由服務(wù)端來創(chuàng)建鏡像。因此一般建議放置Dockerfile的目錄為空目錄借尿。
另外刨晴,可以通過.dockerignore文件(每一行添加一條匹配模式)來讓Docker忽略路徑下的目錄和文件
要指定鏡像的標(biāo)簽信息,可以使用-t選項(xiàng)路翻。
例如狈癞,指定Dockerfile所在路徑為/tmp/docker_builder/,并且希望生成鏡像標(biāo)簽為build_repo/first_image帚桩,可以使用以下命令:
docker build -t build_repo/first_image /tmp/docker_builder