Dockerfile 文件详解

Dockerfile是一个文本格式的文件,我们可以通过它来快速创建自定义的镜像,没错,是镜像。

我们在创建Dockerfile时,要有几个注意事项:其一,要把它建立在空文件夹下;其二,Dockerfile的“D”一定要大写,下面给出一个实例。

# 设置镜像,本机要存在的镜像
FROM centos:7.2

# 备注一下作者信息
MAINTAINER lixh (admin@lixh.cn)

# 开始下载 passwd openssh-server
RUN yum -y install passwd openssh-server;yum clean all

# 修改root密码
RUN echo "1234567" | passwd --stdin root

# 开放22号端口
EXPOSE 22

# 启动SSH
CMD /usr/sbin/sshd -D

Dockerfile由一行一行的命令语句组成,#开头的为注释行。Dockerfile文件内容分为四个部分:基础镜像信息、维护者信息、镜像操作指令以及容器启动执行指令。

接下来给大家列出Dockerfile中主要命令的说明。

FROM,指定所创建镜像的基础镜像。

1. FROM

指定所创建镜像的基础镜像,如果本地不存在,则默认会去Docker Hub下载指定镜像。

格式为FORM<image>,或FORM<image>:<tag>,或FROM<image>@<digest>。

任何Dockerile中的第一条指令必须为FROM指令,并且,如果在同一个Dockerfile中创建多个镜像,可以使用多个FROM指令(每个镜像一次)。

 

2.MAINTAINER

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

该信息会写人生成镜像的Author属性域中。

 

3.RUN

运行指定命令。

格式为RUN<command>或RUN [“executable”, “param1″, ” param 2″]。 注意,后一个指令会被解析为Json数组,因此必须用双引号。

前者默认将在shell终端中运行命令,即/bin/sh -c; 后者则使用exec执行,不会启动shell环境。

指定使用其他终端类型可以通过第二种方式实现,例如RUN (” /bin/bash”, “-c”,”echo hello”]。

每条RUN指令将在当前镜像的基础上执行指定命令,并提交为新的镜像。当命令较长时可以使用\来换行。例如:

RUN yum update \

&& yum install -y libsnappy -dev zliblg-dev 1ibz2 dev

 

4.CMD

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

CMD[“executable”,” param1″,”param2” ]使用exec执行,是推存使用的方式;

CMD command param1 param2在/bin/sh中执行,提供给需要交互的应用;

CMD[“param1″, ” param 2″]提供给ENTRYPOINT的默认参数。

每个Dockerfile只能有一条CMD命令,如果指定了多条命令,只有最后一条会被执。

如果用户启动容器时手动指定了运行的命令(作为run的参数),则会覆盖掉CMD指定的命令。

 

5.LABEL

LABEL指令用来指定生成镜像的元数据标签信息。

格式为LABEL <key>=<value> <key>=<value> <key>=<value> ..。

例如:

LABEL version= ”1.0”

LABEL description= “This text illustrates \ that label-values can span multiple lines.”

 

6.EXPOSE

声明镜像内服务所监听的端口。

格式为EXPOSE <port> [<port>…]

例如:

EXPOSE 22 80 8443

注意,该指令只是起到声明作用,并不会自动完成端口映射。

在启动容器时需要使用-P,Docker 主机会自动分配一个宿主机的临时端口转发到指定的端口;使用-P,则可以具体指定哪个宿主机的本地端口会映射过来。

 

7.ENV

指定环境变量,在镜像生成过程中会被后续RUN指令使用,在镜像启动的容器中也会存在

格式为ENV<key><value>或ENV<key>=<value>….。

例如:

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

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

 

8.ADD

该命令将复制指定的<src>路径下的内容到容器中的<dest>路径下。

格式为ADD<src> <dest>。

其中<src>可以是Dockerfile所在目录的一个相对路径 (文件或目录),也可以是一个URL,还可以是一个tar文件(如果为tar文件,会自动解压到<dest>路径下)。<dest>可以是镜像的绝时路径,或者相对于工作目录(WORKDIR)的相对路径。

路径支持正则格式,例如:

ADD *.c /code/

 

9.COPY

格式为COPY  <src>  <dest>。

复制本地主机的<src> (为Dockerfile所在目录的相对路径、文件或目录)下的内容到镜像中的<dest>下。目标路径不存在时,会自动创建。

路径同样支持正则格式。

当使用本地目录为源目录时,推荐使用COPY。

 

10.ENTRYPOINT

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

支持两种格式:

ENTRYPOINT [“executable”, “param1”, “param2”] (exec 调用执行);

ENTRYPOINT command param1  param2 (shell 中执行)。

此时,CMD指令指定值将作为根命令的参数。

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

 

11.VOLUME

创建一个数据卷挂载点。

格式为VOLUME   [“/data”]。

可以从本地主机或其他容器挂载数据卷,一般用来存放数据库和需要保存的数据等。

 

12.USER

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

格式为USER daemon。

当服务不需要管理员权限时,可以通过该命令指定运行用户,并且可以在之前创建所需要的用户。例如:

RUN groupadd -r postgres && useradd -r -g postgres postgres

要临时获取管理员权限可以使用su或sudo。

 

13.WORKDIR

为后续的RUN、CMD和ENTRYPOINT指令配置工作目录。

格式为WORKDIR /path/to/workdir。

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

WORKDIR /a

WORKDIR /b

WORKDIR /c

RUN pwd

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

 

14.ARG

指定一些镜像内使用的参数(例如版本号信息等),这些参数在执行docker build命令时才以–build-arg<varname>=<value>格式传人。

格式为ARG<name> [=<default  value> ]。

则可以用docker build –build-arg<name>=<value>.来指定参数值。

 

15.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。

 

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”]。

转载请附上原文出处链接及本声明
李老师的博客 » Dockerfile 文件详解

发表评论

提供最优质的文章集合

立即查看 了解详情