1、基本結構
Dockerfile 由一行行命令語句組成,並且支持以 #
開頭的註釋行。
一般的,Dockerfile 分爲四部分:基礎鏡像信息、維護者信息、鏡像操作指令和容器啓動時執行指令。
例如
# This dockerfile uses the ubuntu image # VERSION 2 - EDITION 1# Author: docker_user # Command format: Instruction [arguments / command] .. # Base image to use, this must be set as the first line FROM ubuntu # Maintainer: docker_user <docker_user at email.com> (@docker_user) MAINTAINER docker_user [email protected] # Commands to update the imageRUN 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 # Commands when creating a new containerCMD /usr/sbin/nginx
其中,一開始必須指明所基於的鏡像名稱,接下來推薦說明維護者信息。
後面則是鏡像操作指令,例如 RUN
指令,RUN
指令將對鏡像執行跟隨的命令。每運行一條 RUN
指令,鏡像添加新的一層,並提交。
最後是 CMD
指令,來指定運行容器時的操作命令。
下面是一個更復雜的例子
# Nginx # VERSION 0.0.1 FROM ubuntu MAINTAINER Victor Vieux <[email protected]> RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server # 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"] # Multiple images example ## VERSION 0.1 FROM ubuntu RUN echo foo > bar # Will output something like ===> 907ad6c2736f FROM ubuntu RUN echo moo > oink # Will output something like ===> 695d7793cbe4 # Youll now have two images, 907ad6c2736f with /bar, and 695d7793cbe4 with # /oink.
2、指令
指令的一般格式爲 INSTRUCTION arguments
,指令包括 FROM
、MAINTAINER
、RUN
等。
2.1 FROM
格式爲 FROM <image>
或FROM <image>:<tag>
。
第一條指令必須爲 FROM
指令。並且,如果在同一個Dockerfile中創建多個鏡像時,可以使用多個 FROM
指令(每個鏡像一次)。
2.2 MAINTAINER
格式爲 MAINTAINER <name>
,指定維護者信息。
2.3 RUN
格式爲 RUN <command>
或 RUN ["executable", "param1", "param2"]
。
前者將在 shell 終端中運行命令,即 /bin/sh -c
;後者則使用 exec
執行。指定使用其它終端可以通過第二種方式實現,例如 RUN ["/bin/bash", "-c", "echo hello"]
。
每條 RUN
指令將在當前鏡像基礎上執行指定命令,並提交爲新的鏡像。當命令較長時可以使用 \
來換行。
2.4 CMD
支持三種格式
CMD ["executable","param1","param2"]
使用exec
執行,推薦方式;CMD command param1 param2
在/bin/sh
中執行,提供給需要交互的應用;CMD ["param1","param2"]
提供給ENTRYPOINT
的默認參數;
指定啓動容器時執行的命令,每個 Dockerfile 只能有一條 CMD
命令。如果指定了多條命令,只有最後一條會被執行。
如果用戶啓動容器時候指定了運行的命令,則會覆蓋掉 CMD
指定的命令。
2.5 EXPOSE
格式爲 EXPOSE <port> [<port>...]
。
告訴 Docker 服務端容器暴露的端口號,供互聯繫統使用。在啓動容器時需要通過 -P,Docker 主機會自動分配一個端口轉發到指定的端口。
2.6 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
2.7 ADD
格式爲 ADD <src> <dest>
。
該命令將複製指定的 <src>
到容器中的 <dest>
。 其中 <src>
可以是Dockerfile所在目錄的一個相對路徑;也可以是一個 URL;還可以是一個 tar 文件(自動解壓爲目錄)。
2.8 COPY
格式爲 COPY <src> <dest>
。
複製本地主機的 <src>
(爲 Dockerfile 所在目錄的相對路徑)到容器中的 <dest>
。
當使用本地目錄爲源目錄時,推薦使用 COPY
。
ENTRYPOINT
兩種格式:
ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2
(shell中執行)。
配置容器啓動後執行的命令,並且不可被 docker run
提供的參數覆蓋。
每個 Dockerfile 中只能有一個 ENTRYPOINT
,當指定多個時,只有最後一個起效。
2.9 VOLUME
格式爲 VOLUME ["/data"]
。
創建一個可以從本地主機或其他容器掛載的掛載點,一般用來存放數據庫和需要保持的數據等。
2.10 USER
格式爲 USER daemon
。
指定運行容器時的用戶名或 UID,後續的 RUN
也會使用指定用戶。
當服務不需要管理員權限時,可以通過該命令指定運行用戶。並且可以在之前創建所需要的用戶,例如:RUN groupadd -r postgres && useradd -r -g postgres postgres
。要臨時獲取管理員權限可以使用 gosu
,而不推薦sudo
。
2.11 WORKDIR
格式爲 WORKDIR /path/to/workdir
。
爲後續的 RUN
、CMD
、ENTRYPOINT
指令配置工作目錄。
可以使用多個 WORKDIR
指令,後續命令如果參數是相對路徑,則會基於之前命令指定的路徑。例如
WORKDIR /a WORKDIR b WORKDIR c RUN pwd
則最終路徑爲 /a/b/c
。
2.12 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
使用 ONBUILD
指令的鏡像,推薦在標籤中註明,例如 ruby:1.9-onbuild
。
3、創建鏡像
編寫完成 Dockerfile 之後,可以通過 docker build
命令來創建鏡像。
基本的格式爲 docker build [選項] 路徑
,該命令將讀取指定路徑下(包括子目錄)的 Dockerfile,並將該路徑下所有內容發送給 Docker 服務端,由服務端來創建鏡像。因此一般建議放置 Dockerfile 的目錄爲空目錄。也可以通過 .dockerignore
文件(每一行添加一條匹配模式)來讓 Docker 忽略路徑下的目錄和文件。
要指定鏡像的標籤信息,可以通過 -t
選項,例如
$ sudo docker build -t myrepo/myapp /tmp/test1/
轉載地址:http://www.dockerinfo.net/dockerfile%E4%BB%8B%E7%BB%8D
知行辦公,專業移動辦公平臺
【總監】十二春秋之,[email protected];
【Master】zelo,[email protected];
【運營】運維艄公,[email protected];
【產品設計】流浪貓,[email protected];
【體驗設計】兜兜,[email protected];
【iOS】淘碼小工,[email protected];iMcG33K,[email protected];
【Android】人猿居士,[email protected];思路的頓悟,[email protected];
【java】首席工程師MR_W,[email protected];
【測試】土鏡問道,[email protected];
【數據】喜樂多,[email protected];
【安全】保密,你懂的。