Dockerfile 分析

Dockerfile 是docker镜像制作的主要配置文件，由一组指令构成，用户使用该文件构建docker镜像，
Dockerfile的指令是忽略大小写的，建议使用大写，使用 # 作为注释，每一行只支持一条指令，每条指令可以携带多个参数。
Dockerfile的指令根据作用可以分为两种，构建指令和设置指令。构建指令用于构建image，其指定的操作不会在运行image的容器上执行；设置指令用于设置image的属性，其指定的操作将在运行image的容器中执行。

下面看看Dockerfile指令的详细解释：

1，FROM                  

FROM指令必须是Dockerfile中的第一个指令，可以多次出现，用来创建多个容器，如果在FROM指令后面没有指定tag，则默认是最新版的。

模式：FROM <image> or FROM <image>:<tag> 

2，MAINTAINER           

 介绍作者等信息

模式：MAINTAINER <name>

3，RUN                   

RUN可以运行任何被基础image支持的命令,RUN指令用来执行任何命令并提交结果，提交的结果可以在Dockerfile的下一步中使用。

RUN有两种模式：1 RUN <COMMAND>  2 RUN ["executable","param1","param2"]

4，CMD                   

在Dockerfile中只能有一个CMD，如果有多个CMD指令，只有最后一个CMD指令生效，当你在CMD执行shell格式的命令，命令默认会在/bin/sh -c中执行，

该指令有三种格式：
CMD ["executable","param1","param2"] (like an exec, this is the preferred form)  
CMD command param1 param2 (as a shell)  
当Dockerfile指定了ENTRYPOINT，那么使用下面的格式：
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)

5，EXPOSE                  

 该指令通知docker，容器监听在一个指定的端口上。使用EXPOSE设置需要映射的容器端口，然后在运行容器的时候指定-p选项加上EXPOSE设置的端口，这样EXPOSE设置的端口号会被随机映射成宿主机器中的一个端口号.

# 映射一个端口  
EXPOSE port1  
# 相应的运行容器使用的命令  
docker run -p port1 image  
  
# 映射多个端口  
EXPOSE port1 port2 port3  
# 相应的运行容器使用的命令  
docker run -p port1 -p port2 -p port3 image  
# 还可以指定需要映射到宿主机器上的某个端口号  

docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 image 

6，ENV                        

ENV指令设置一个环境变量，这些值会传递到RUN指令执行时的环境上

模式：ENV <key> <value> 

ENV JAVA_HOME /path/to/java/dirent

也可以通过在docker run --env key=value时设置或修改环境变量。

7，ADD                            

该指令会从源地址拷贝一个文件到容器里面。ADD  <src> <dest> 。src是一个文件或者相关目录，dest是容器里面的一个绝对路径。所有文件及目录权限都是0755，UID/GID都是0。 

                1  <src>的路径必须在build的上下文环境中 
                2  如果<src>是URL，并且<dest>不是以“/”结尾的，则URL下载的文件会被复制为<dest> 
                3  如果<src>是URL，并且<dest>是以“/”结尾的，则URL下载的文件会被复制为<dest>/<filename> 
                4  如果<src>是目录，则整个目录会被复制，包括文件系统的元数据 
                5  如果<src>是一个本地的tar包格式(gzip，bzip2，xz)，并且可识别，则复制时会自动解压成目录。  
                6  如果<src>是一个文件，并且<dest>是以“/”结尾，则会被认为是目录，<src>会被复制成<dest>/base 
                7  如果<dest>不是以“/”结尾的，则会被认为是文件

8，ENTRYPOINT           

只能有一个ENTRYPOINT指令在Dockerfile文件中，如果有多个该指令，则最后一个指令生效。

当独自使用时，如果你还使用了CMD命令且CMD是一个完整的可执行的命令，那么CMD指令和ENTRYPOINT会互相覆盖只有最后一个CMD或者ENTRYPOINT有效。
# CMD指令将不会被执行，只有ENTRYPOINT指令被执行  
CMD echo “Hello, World!”  
ENTRYPOINT ls -l  
另一种用法和CMD指令配合使用来指定ENTRYPOINT的默认参数，这时CMD指令不是一个完整的可执行命令，仅仅是参数部分；ENTRYPOINT指令只能使用JSON方式指定执行命令，而不能指定参数。

ENTRYPOINT ["executable","param1","param2"]

9，VOLUME                 

该参数会根据指定的名称创建一个挂载点，并且从自然主机上挂载volumes卷。

设置指令，使容器中的一个目录具有持久化存储数据的功能，该目录可以被容器本身使用，也可以共享给其他容器使用。我们知道容器使用的是AUFS，这种文件系统不能持久化数据，当容器关闭后，所有的更改都会丢失。当容器中的应用有持久化数据的需求时可以在Dockerfile中使用该指令。
格式:VOLUME ["<mountpoint>"]  
FROM base  
VOLUME ["/tmp/data"]  
运行通过该Dockerfile生成image的容器，/tmp/data目录中的数据在容器关闭后，里面的数据还存在。例如另一个容器也有持久化数据的需求，且想使用上面容器共享的/tmp/data目录，那么可以运行下面的命令启动一个容器：
docker run -t -i -rm -volumes-from container1 image2 bash  
container1为第一个容器的ID，image2为第二个容器运行image的名字。

10，USER                   

设置指令，设置启动容器的用户，默认是root用户。

# 指定memcached的运行用户  
ENTRYPOINT ["memcached"]  
USER daemon  
或  ENTRYPOINT ["memcached", "-u", "daemon"] 

11，WORKDIR                    

该参数设置RUN、CMD、ENTRYPOINT等参数的工作目录。该参数可以被多次使用，如果提供的目录是相对目录，他会在上一个WORKDIR的基础上进行设置 

WORKDIR /path/to/workdir  

12，ONBUILD

（在子镜像中执行）

[plain] view plaincopy
ONBUILD <Dockerfile关键字>  
ONBUILD 指定的命令在构建镜像时并不执行，而是在它的子镜像中执行。

详细资料可参考https://www.dockboard.org/docker-quicktip-3-onbuild

ref-link:http://blog.csdn.net/we_shell/article/details/38445979

http://docs.docker.com/reference/builder/

https://docs.docker.com/articles/dockerfile_best-practices/