Docker(二)----Dockerfile文件详解

113 阅读11分钟
原文链接: blog.csdn.net

一、什么是Dockerfile?

Dockerfile是一个包含用于组合映像的命令的文本文档。可以使用在命令行中调用任何命令。 Docker通过读取Dockerfile中的指令自动生成映像。

docker build命令用于从Dockerfile构建映像。可以在docker build命令中使用-f标志指向文件系统中任何位置的Dockerfile。

例:

[html] view plain copy print?
  1. docker build -f /home/fendo/Dockerfile  
docker build -f /home/fendo/Dockerfile

二、Dockerfile的基本结构

Dockerfile 一般分为四部分:基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令,’#’ 为 Dockerfile 中的注释。

三、Dockerfile格式

1. FROM   指定基于哪个基础镜像,必须为第一个命令

[html] view plain copy print?
  1. 格式:  
  2.   FROM <image>  
  3.   FROM <image>:<tag>  
  4.   FROM <image>@<digest>  
  5. 示例:  
  6.   FROM mysql:5.6  
  7. 注:  
  8.   tag或digest是可选的,如果不使用这两个值时,会使用latest版本的基础镜像  
格式:
  FROM <image>
  FROM <image>:<tag>
  FROM <image>@<digest>
示例:
  FROM mysql:5.6
注:
  tag或digest是可选的,如果不使用这两个值时,会使用latest版本的基础镜像

2. MAINTAINER 维护者信息

[html] view plain copy print?
  1. 格式:  
  2.     MAINTAINER <name>  
  3. 示例:  
  4.     MAINTAINER fendo fendo  
  5.     MAINTAINER fendo.com  
  6.     MAINTAINER fendo fendo <fendo@163.com>  
格式:
    MAINTAINER <name>
示例:
    MAINTAINER fendo fendo
    MAINTAINER fendo.com
    MAINTAINER fendo fendo <fendo@163.com>

3.RUN 构建镜像时执行的命令

[html] view plain copy print?
  1. RUN用于在镜像容器中执行命令,其有以下两种命令执行方式:  
  2.   
  3. 3.1、shell执行  
  4. 格式:  
  5.     RUN <command>  
  6.       
  7. 3.2、exec执行  
  8. 格式:  
  9.     RUN ["executable", "param1", "param2"]  
  10. 示例:  
  11.     RUN ["executable", "param1", "param2"]  
  12.     RUN yum update  
  13.     RUN ["/etc/execfile", "arg1", "arg1"]  
  14. 注:  
  15.   RUN指令创建的中间镜像会被缓存,并会在下次构建中使用。如果不想使用这些缓存镜像,可以在构建时指定--no-cache参数,如:docker build --no-cache  
RUN用于在镜像容器中执行命令,其有以下两种命令执行方式:

3.1、shell执行
格式:
    RUN <command>
	
3.2、exec执行
格式:
    RUN ["executable", "param1", "param2"]
示例:
    RUN ["executable", "param1", "param2"]
    RUN yum update
    RUN ["/etc/execfile", "arg1", "arg1"]
注:
  RUN指令创建的中间镜像会被缓存,并会在下次构建中使用。如果不想使用这些缓存镜像,可以在构建时指定--no-cache参数,如:docker build --no-cache

4.CMD 构建容器后调用,也就是在容器启动时才进行调用。

[html] view plain copy print?
  1. 格式:  
  2.     CMD ["executable","param1","param2"] (执行可执行文件,优先)  
  3.     CMD ["param1","param2"] (设置了ENTRYPOINT,则直接调用ENTRYPOINT添加参数)  
  4.     CMD command param1 param2 (执行shell内部命令)  
  5. 示例:  
  6.     CMD ["/bin/bash", "/usr/local/nginx/sbin/nginx", "-c", "/usr/local/nginx/conf/nginx.conf"]  
  7. 注:  
  8.    CMD不同于RUN,CMD用于指定在容器启动时所要执行的命令,而RUN用于指定镜像构建时所要执行的命令,只能有一条。  
格式:
    CMD ["executable","param1","param2"] (执行可执行文件,优先)
    CMD ["param1","param2"] (设置了ENTRYPOINT,则直接调用ENTRYPOINT添加参数)
    CMD command param1 param2 (执行shell内部命令)
示例:
	CMD ["/bin/bash", "/usr/local/nginx/sbin/nginx", "-c", "/usr/local/nginx/conf/nginx.conf"]
注:
   CMD不同于RUN,CMD用于指定在容器启动时所要执行的命令,而RUN用于指定镜像构建时所要执行的命令,只能有一条。
5.ADD 将本地文件添加到容器中,tar类型文件会自动解压,可以访问网络资源,类似wget [html] view plain copy print?
  1. 格式:  
  2.     ADD <src>... <dest >  
  3.     ADD ["<src>",... "<dest >"] 用于支持包含空格的路径  
  4. 示例:  
  5.     ADD hom* /fendo/          # 添加所有以"hom"开头的文件到/fendo目录  
  6.     ADD hom?.txt /fendo/      # ? 替代一个单字符,例如:"home.txt"  
  7.     ADD test relativeDir/     # 添加 "test" 到 `WORKDIR`/relativeDir/  
  8.     ADD test /absoluteDir/    # 添加 "test" 到 /absoluteDir/  
格式:
    ADD <src>... <dest>
    ADD ["<src>",... "<dest>"] 用于支持包含空格的路径
示例:
    ADD hom* /fendo/          # 添加所有以"hom"开头的文件到/fendo目录
    ADD hom?.txt /fendo/      # ? 替代一个单字符,例如:"home.txt"
    ADD test relativeDir/     # 添加 "test" 到 `WORKDIR`/relativeDir/
    ADD test /absoluteDir/    # 添加 "test" 到 /absoluteDir/

6.COPY 功能类似ADD,但是是不会自动解压文件,也不能访问网络资源URL

7.ENTRYPOINT  配置容器,容器启动时要执行的命令,它和CMD很像,也是只有一条生效,如果写多个只有最后一条有效。和CMD不同是:CMD 是可以被 docker run 指令覆盖的,而ENTRYPOINT不能覆盖

[html] view plain copy print?
  1. 格式:  
  2.     ENTRYPOINT ["executable", "param1", "param2"] (可执行文件, 优先)  
  3.     ENTRYPOINT command param1 param2 (shell内部命令)  
  4. 示例:  
  5.     FROM ubuntu  
  6.     ENTRYPOINT ["top", "-b"]  
  7.     CMD ["-c"]  
  8. 注:  
  9.    ENTRYPOINT与CMD非常类似,不同的是通过docker run执行的命令不会覆盖ENTRYPOINT,  
  10.      而docker run命令中指定的任何参数,都会被当做参数再次传递给ENTRYPOINT。  
  11.      Dockerfile中只允许有一个ENTRYPOINT命令,多指定时会覆盖前面的设置,而只执行最后的ENTRYPOINT指令。  
格式:
    ENTRYPOINT ["executable", "param1", "param2"] (可执行文件, 优先)
    ENTRYPOINT command param1 param2 (shell内部命令)
示例:
    FROM ubuntu
    ENTRYPOINT ["top", "-b"]
    CMD ["-c"]
注:
   ENTRYPOINT与CMD非常类似,不同的是通过docker run执行的命令不会覆盖ENTRYPOINT,
     而docker run命令中指定的任何参数,都会被当做参数再次传递给ENTRYPOINT。
	 Dockerfile中只允许有一个ENTRYPOINT命令,多指定时会覆盖前面的设置,而只执行最后的ENTRYPOINT指令。

8.LABEL 用于为镜像添加元数据

[html] view plain copy print?
  1. 格式:  
  2.     LABEL <key>=<value > <key>=<value>  <key>=<value> ...  
  3. 示例:  
  4.   LABEL version="1.0" description="这是描述"  by="fendo"  
  5. 注:  
  6.   使用LABEL指定元数据时,一条LABEL指定可以指定一或多条元数据,  
  7.     指定多条元数据时不同元数据之间通过空格分隔。推荐将所有的元数据通过一条LABEL指令指定,以免生成过多的中间镜像。  
格式:
    LABEL <key>=<value> <key>=<value> <key>=<value> ...
示例:
  LABEL version="1.0" description="这是描述" by="fendo"
注:
  使用LABEL指定元数据时,一条LABEL指定可以指定一或多条元数据,
    指定多条元数据时不同元数据之间通过空格分隔。推荐将所有的元数据通过一条LABEL指令指定,以免生成过多的中间镜像。

9.ENV 设置环境变量,它主要是为后续的RUN指令提供一个环境变量

[html] view plain copy print?
  1. 格式:  
  2.     ENV <key> <value >  
  3.     ENV <key>=<value > ...  
  4. 示例:  
  5.     ENV myName fendo  
  6.     ENV myDog fendo Dog  
  7.     ENV myCat fendo  
格式:
    ENV <key> <value>
    ENV <key>=<value> ...
示例:
    ENV myName fendo
    ENV myDog fendo Dog
    ENV myCat fendo

10.EXPOSE 指定于外界交互的端口

[html] view plain copy print?
  1. 格式:  
  2.     EXPOSE <port> [<port >...]  
  3. 示例:  
  4.     EXPOSE 80 443  
  5.     EXPOSE 8080  
  6. 说明:  
  7.     用来指定要映射出去的端口,比如容器内部我们启动了sshd和nginx,所以我们需要把22和80端口暴漏出去。这个需要配合-P(大写)来工作,  
  8.     也就是说在启动容器时,需要加上-P,让它自动分配。如果想指定具体的端口,也可以使用-p(小写)来指定。  
  9. 注:  
  10.   EXPOSE并不会让容器的端口访问到主机。要使其可访问,需要在docker run运行容器时通过-p来发布这些端口,或通过-P参数来发布EXPOSE导出的所有端口  
格式:
    EXPOSE <port> [<port>...]
示例:
    EXPOSE 80 443
    EXPOSE 8080
说明:
	用来指定要映射出去的端口,比如容器内部我们启动了sshd和nginx,所以我们需要把22和80端口暴漏出去。这个需要配合-P(大写)来工作,
	也就是说在启动容器时,需要加上-P,让它自动分配。如果想指定具体的端口,也可以使用-p(小写)来指定。
注:
  EXPOSE并不会让容器的端口访问到主机。要使其可访问,需要在docker run运行容器时通过-p来发布这些端口,或通过-P参数来发布EXPOSE导出的所有端口

11.VOLUME 用于指定持久化目录

[html] view plain copy print?
  1. 格式:  
  2.     VOLUME ["/path/to/dir"]  
  3. 示例:  
  4.     VOLUME ["/data"]  
  5.     VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"  
  6. 说明:  
  7.     创建一个可以从本地主机或其他容器挂载的挂载点。  
  8. 注:  
  9.   一个卷可以存在于一个或多个容器的指定目录,该目录可以绕过联合文件系统,并具有以下功能:  
  10.     1 卷可以容器间共享和重用  
  11.     2 容器并不一定要和其它容器共享卷  
  12.     3 修改卷后会立即生效  
  13.     4 对卷的修改不会对镜像产生影响  
  14.     5 卷会一直存在,直到没有任何容器在使用它  
格式:
    VOLUME ["/path/to/dir"]
示例:
    VOLUME ["/data"]
    VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"
说明:
    创建一个可以从本地主机或其他容器挂载的挂载点。
注:
  一个卷可以存在于一个或多个容器的指定目录,该目录可以绕过联合文件系统,并具有以下功能:
	1 卷可以容器间共享和重用
	2 容器并不一定要和其它容器共享卷
	3 修改卷后会立即生效
	4 对卷的修改不会对镜像产生影响
	5 卷会一直存在,直到没有任何容器在使用它

12.WORKDIR 工作目录,类似于cd命令

[html] view plain copy print?
  1. 格式:  
  2.     WORKDIR /fendo/nginx  
  3. 示例:  
  4.     WORKDIR /a  (这时工作目录为/a)  
  5.     WORKDIR b  (这时工作目录为/a/b)  
  6.     WORKDIR c  (这时工作目录为/a/b/c)  
  7. 说明:  
  8.     为后续的RUN、CMD或者ENTRYPOINT指定工作目录  
  9. 注:  
  10.   通过WORKDIR设置工作目录后,Dockerfile中其后的命令RUN、CMD、ENTRYPOINT、ADD、COPY等命令都会在该目录下执行。  
  11.     在使用docker run运行容器时,可以通过-w参数覆盖构建时所设置的工作目录。  
格式:
    WORKDIR /fendo/nginx
示例:
    WORKDIR /a  (这时工作目录为/a)
    WORKDIR b  (这时工作目录为/a/b)
    WORKDIR c  (这时工作目录为/a/b/c)
说明:
    为后续的RUN、CMD或者ENTRYPOINT指定工作目录
注:
  通过WORKDIR设置工作目录后,Dockerfile中其后的命令RUN、CMD、ENTRYPOINT、ADD、COPY等命令都会在该目录下执行。
    在使用docker run运行容器时,可以通过-w参数覆盖构建时所设置的工作目录。