使用Dockerfile创建镜像

Dockerfile 是一个文本格式的配置文件,用户可以使用 Dockerfile 来快速创建自定义的镜像。

基本结构

Dockerfile 由一行行命令语句组成,并且支持以 # 开头的注释行。
一般而言,Dockerfile 分为四部分:基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令。
下面是一个 Dockerfile 文件的基本结构:

# 基础镜像信息
FROM ubuntu:14.04
# 维护者信息
MAINTAINER WangYong wangyong1@yidian-inc.com
# 镜像操作指令
ENV JAVA_HOME /usr/local/java
RUN echo "Hello World"
# 容器启动时执行指令
CMD /user/sbin/nginx

指令说明

指令说明

FROM 指定所创建镜像的基础镜像
MAINTAINER 指定维护者信息
RUN 运行命令
CMD 指定启动容器时默认执行的命令
LABEL 指定生成镜像的元数据标签信息
EXPOSE 声明镜像内服务所监听的端口
ENV 指定环境变量
ADD 赋值指定的< src > 路径下的内容到容器中的<dest>路径下,<src>可以为URL;如果为tar文件,会自动解压到<dest>路径下
COPY 复制本地主机的<src>路径下的内容到镜像中的<dest>路径下;一般情况下推荐使用COPY,而不是ADD
ENTRYPOINT 指定镜像的默认入口
VOLUME 创建数据卷挂在点
USER 指定运行容器时的用户名或UID
WORKDIR 配置工作目录
ARG 指定镜像内使用的参数(例如版本号信息等)
ONBUILD 配置当前所创建的镜像作为其他镜像的基础镜像时,所执行的创建操作指令
STOPSIGNAL 容器退出的信号值
HEALTHCHECK 如何进行健康检查
SHELL 指定使用shell时默认shell类型

1. FROM

指定所创建镜像的基础镜像,如果本地不存在,则默认会去Docker Hub下载指定镜像。
格式:FROM <image>,或 FROM <image>:<tag>,或 FROM <image>@<digest>

任何 Dockerfile 中第一条指令必须为 FROM 指令。

2. MAINTAINER

指定维护者信息,格式为 MAINTAINER <name>。例如:
MAINTAINER image_creator@docker.com

3. RUN

运行指定命令。
格式为 RUN <command> 或 RUN ["executable", "param1", "param2"]。
前者默认将在 shell 终端中运行命令,即 /bin/sh -c;
后者则使用 exec 执行,不会启动 shell 环境。

RUN 指令会在执行 docker build 时执行,当命令较长时,可以使用\来换行。

RUN apt-get update \
    && apt-get install -y libsnappy-dev \
    && rf -rf /var/cache/apt

4. CMD

CMD 指令用例指定启动容器时默认执行的命令。它支持三种格式:

  • CMD ["executable", "param1", "param2"] 使用exec执行,推荐方式
  • CMD command param1 param2 在 /bin/sh 中执行,提供给需要交互的应用
  • CMD ["param1", "param2"] 提供给ENTRYPOINT的默认参数。

每个 Dockerfile 只能有一条 CMD 命令。如果指定了多条命令,只有最后一条会被执行
如果启动容器时手动指定了运行的命令(作为run的参数),则会覆盖掉 CMD 指定的命令。

5. LABEL

LABEL指令用例指定生成镜像的元数据标签信息。
格式为:LABEL <key>=<value> <key>=<value> ......。

6. EXPOSE

声明镜像内服务所监听的端口。
格式为:EXPOSE <port> [<port> ...]
注意,该指令只是起到生命作用,并不会自动完成端口映射。
在启动容器时需要使用-P,Docker 主机会自动分配一个宿主机的临时端口转发到指定的端口;使用-p,则可以具体指定哪个宿主机的本地端口会映射过来。

7. ENV

指定环境变量,在镜像生成过程中会被后续 RUN 指令使用,在镜像启动的容器中也会存在。
格式为:ENV <key> <value> 或 ENV <key>=<value>...。
例如:

ENV JAVA_HOME /usr/local/java_1.8
RUN echo $JAVA_HOME
ENV PATH $JAVA_HOME/bin:$PATH

指令指定的环境变量在运行时可以被覆盖掉,如 docker run --env <key>=<value> built_image

8. ADD

复制<src>路径下的文件到容器的<dest>路径下。
格式为:ADD <src> <dest>。
其中,<src>可以是 Dockerfile 所在目录的一个相对路径(文件或目录),也可以是一个 URL,还可以是一个 tar 文件(如果为tar文件,会自动解压到 <dest> 路径下)。
<dest>可以是镜像内的绝对路径,或者相对于工作目录(WORKDIR)的相对路径。
路径支持正则格式,例如:

ADD *.cpp /code/

9. COPY

复制本地主机的<src>(为 Dockerfile 所在目录的相对路径、文件或目录)下的内容到镜像中的 <dest> 下。目标路径不存在时,会自动创建。
格式为:COPY <src> <dest>
路径同样支持正则格式。
当使用本地目录为<src>时,推荐使用COPY。

10. ENTRYPOINT

指定镜像的默认入口命令,该入口命令会在启动容器时作为根命令执行,所有传入值作为该命令的参数。
支持两种格式:

  • ENTRYPOINT ["executable", "param1", "param2"](exec 调用执行);
  • ENTRYPOINT command param1 param2(shell中执行)。

每个 Dockerfile 中只能有一个 ENTRYPOINT,当指定多个时,只有最后一个有效。
在运行时,可以被--entrypoint参数覆盖掉。

11. VOLUME

创建一个数据卷挂载点。
格式为:VOLUME ["/data"]
可以从本地主机或其它容器挂载数据卷,一般用来存放数据库和需要保存的数据等。

12. USER

指定运行容器时的用户名或UID,后续的 RUN 等指令也会使用指定的用户身份。
格式为:USER daemon

13. WORKDIR

为后续的 RUN、CMD 和 ENTRYPOINT 指令配置工作目录。
格式为:WORKDIR /path/to/workdir

可以使用多个 WORKDIR 指令,后续命令如果是相对路径,则会基于之前命令指定的路径。例如:

WORKDIR /a
WORKDIR b
WORKDIR c

则最终路径为 /a/b/c。

14. ARG

指定一些镜像内使用的参数(例如版本号信息等),这些参数在执行 docker build 命令时才以--build-arg <varname>=<value> 格式传入。
格式为:ARG <name>[=<default value>]
也可以使用 docker build --build-arg <varname>=<value> 来指定参数值。

15. ONBUILD

配置当所创建的镜像作为其他镜像的基础镜像时,所执行的创建操作指令。
格式为:ONBUILD [INSTRCTION]

16. STOPSIGNAL

指定所创建镜像启动的容器接收退出的信号值。例如:

STOPSIGNAL signal

17. HEALTHCHECK

配置所启动容器如何进行健康检查(如何判断健康与否),自 Docker 1.12 开始支持。
格式有两种:

  • HEALTHCHECK [OPTIONS] CMD command:根据所执行命令返回值是否为0来判断;
  • HEALTHCHECK NONE:禁止基础镜像中的健康检查。

OPTION 支持:

  • --interval=DURATION(默认为30s):过多久检查一次;
  • --timeout=DURATION(默认为30s):每次检查等待结果的超时;
  • --retries=N(默认为3):如果失败了,重试几次才最终确定失败。

18. SHELL

指定其他命令使用 shell 时的默认 shell 类型。
格式为:SHELL ["executable", "parameters"]
默认值为["/bin/sh", "-c"]。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,417评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,921评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,850评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,945评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,069评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,188评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,239评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,994评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,409评论 1 304
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,735评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,898评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,578评论 4 336
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,205评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,916评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,156评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,722评论 2 363
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,781评论 2 351

推荐阅读更多精彩内容