Dockerfile的书写规则和指令的使用方法

Dockfile是一种被Docker程序解释的脚本，Dockerfile由一条一条的指令组成，每条指令对应Linux下面的一条命令。Docker程序将这些Dockerfile指令翻译真正的Linux命令。Dockerfile有自己书写格式和支持的命令，Docker程序解决这些命令间的依赖关系，类似于Makefile。Docker程序将读取Dockerfile，根据指令生成定制的image。相比image这种黑盒子，Dockerfile这种显而易见的脚本更容易被使用者接受，它明确的表明image是怎么产生的。有了Dockerfile，当我们需要定制额外的需求时，只需Dockerfile上添加或者修改指令，重新生成image即可，省去了敲命令的麻烦。

Dockerfile的书写规则和指令的使用方法

# 注释

INSTRUCTION  argument     12

指令忽略大小写，建议使用大写；每一行只支持一条指令，每条指令可以携带多个参数。Dockerfile的指令根据作用可以分为两种：构建指令和设置指令。

构建指令（用于构建镜像，其指定的操作不会在由镜像运行的容器上执行）

（1） FROM（指定基础镜像）

FROM必须是第一条非注释指令，它指定基础镜像且指定的镜像是已存在的。

格式：

FROM <image>                       # 指定基础镜像

FROM <image>:<tag>                 # 指定一个tag版本的基础镜像123

例子：

FROM ubuntu:14.041

（2）MAINTAINER（指定镜像创建者信息）

指定镜像的作者和联系方式信息。

格式：

MAINTAINER <author> "e-mail"      # 指定作者名和E-mail1

例子：

MAINTAINER locutus "locutus@foxmail.com"   

# 执行 #docker inspect image，输出中有相应的字段记录该信息123

（3）RUN（安装软件用）

RUN可以运行任何被基础镜像支持的命令。如基础镜像选择了ubuntu，那么软件管理部分只能使用ubuntu的命令。

格式：

RUN <command> 

# shell模式，以#/bin/sh -c command 形式执行, 如RUN echo hello

RUN ["executable", "param1", "param2" ... ] 

# exec模式，指定其他形式的shell来运行指令 ,如RUN ["/bin/bash" ,“-c”,“echo  hello" ]1234567

例子：

RUN apt-get update && apt-get install -y nginx     # 合并执行命令1

（4）ENV（用于设置环境变量）

在镜像中设置一个环境变量。

格式:

ENV  <key>  <value>      

# 设置后，后续RUN命令都可使用环境变量所输出的指令，容器启动ENV <key>=<value>后，通过#docker inspect查看环境变量，也可以通过

# docker run --env key=value设置或修改环境变量。                                                         123

例子：

ENV  JAVA_HOME  /path/to/java/dirent       

# 在容器中安装JAVA程序，设置JAVA_HOME123

（5）ADD COPY（将本地文件或目录复制到由dockerfile构建的镜像中）

所有拷贝到container中的文件和文件夹权限为0755，uid和gid为0；如果是一个目录，那么会将该目录下的所有文件拷贝到目录下，不包括目录；如果是文件且中不使用斜杠结束，则会将视为文件，的内容会写入；如果是文件且中使用斜杠结束，则会文件拷贝到目录下。

格式:

ADD  <src>  <dest>             

# <src>可以是文件或目录的本地地址（即Dockerfile所在目录的相对路径），也可以是一个远程的url（docker不推荐，更建议使用wget或curl获取文件）; <dest>是镜像中的绝对路径                                                                                                                 

ADD  ["<src>" "<dest>"]                

# 适用于文件路径中有空格的情况，同理有COPY的情况

COPY <src>  <dest> 

COPY ["<src>" "<dest>"] 1234567891011

ADD与COPY的区别：ADD指令包含类似tar的解压功能，而COPY只单纯复制文件。

例子：

# vim   index.html                          # 编辑一个index.html文件

<html>

      <head>

            <title>Page Added in Dockerfile</title>

      </head>

      <body>

            <h1>I'm page in nginx_test1</h1>

      </body>

</html>                  

# 在Dockfile中写下

COPY  index.html   /usr/share/nginx/html/           

# copy Dockerfile所在目录的文件到容器的绝对路径下，使用docker build 指令后，运行容器，查看端口映射，并# curl http：//127.0.0.1：host_port 可以看到index.html的内容                 123456789101112131415

设置指令（用于设置image的属性，其指定的操作将在由image运行的容器中执行）

（6）CMD（提供容器运行的默认命令）

提供容器运行的默认命令。与RUN类似，但RUN指定的命令是在容器构建过程中运行，而CMD指定的命令是在容器运行过程中运行。该指令只能在文件中存在一次，如果有多个，则只执行最后一条。

格式：

CMD   ["executable","param1","param2"]         # exec模式  

CMD   command param1 param2                    # shell模式 

CMD   ["param1","param2"]                      

# 当Dockerfile指定了ENTRYPOINT时使用，其作为ENTRYPOINT指令的默认参数 1234567

例子：

# docker  run  --name  test  -d   repository  cmd                   //构建容器中的CMD指令被run的cmd覆盖，不会执行

# docker  run  --name  test  -d   repository                         //执行构建容器中的CMD指令123

（7）ENTRYPOINT（提供容器运行的默认命令）

指定容器运行时执行的命令，可以多次设置，但是只有最后一个有效。

格式:

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

# exec模式

ENTRYPOINT command param1 param2                       

# shell模式  1234567

例子：

该指令的使用分为两种情况，一种是独自使用，另一种和CMD指令配合使用。

a. 当独自使用时，如果你还使用了CMD命令且CMD是一个完整的可执行的命令，那CMD指令和ENTRYPOINT会互相覆盖，只有最后一个CMD或者ENTRYPOINT有效。构建容器中的ENTRYPOINT指令不会被run的cmd覆盖，ENTRYPOINT指令仍会执行。

CMD   echo “Hello, World!”                         

ENTRYPOINT  ls  -l                                                          

# CMD指令将不会被执行，只有ENTRYPOINT指令被执行12345

b. 与CMD指令配合使用来指定ENTRYPOINT的默认参数。ENTRYPOINT指令只能使用exec模式，指定执行命令，而不能指定参数；CMD指令不是一个完整的可执行命令，仅仅是参数部分。

在Dockerfile中，写如下内容：

FROM ubuntu  

ENTRYPOINT ["/usr/bin/nginx"]  

CMD ["-h"]       12345

在命令行中，执行以下命令

# docker build -t="locutus1/nginx"  .    # 构建docker镜像

# docker run -p 80 --name nginx_test2 -d locutus1/nginx -g "daemon  off;"                                                             

# docker ps -l                                                           12345

命令# docker run 的-g “daemon off;” 指令将CMD中的-h指令覆盖。

（8）USER（设置container容器的用户）

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

格式：

USER  user

USER  uid

USER  user：group

USER  uid：gid

USER  user：gid

USER  uid：group  123456

例子：

ENTRYPOINT ["memcached"]      # 指定指令memcached的运行用户为daemon

USER daemon  

或  

ENTRYPOINT ["memcached", "-u", "daemon"]  123456

（9）EXPOSE（指定容器需要映射到宿主机的端口）

该指令会将容器中的端口映射成宿主机中的某个端口。当你需要访问容器的时候，可以不使用容器的IP地址而是使用宿主机的IP地址和映射后的宿主机端口。要完成整个操作需要两个步骤：

\1. 在Dockerfile使用EXPOSE设置需要映射的容器端口

\2. 在运行容器的时候指定-p选项和EXPOSE设置的端口，这样EXPOSE设置的端口号会被随机映射成宿主机器中的一个端口号。

格式:

EXPOSE <port> [<port>...]  1

例子：

EXPOSE port1                         // 映射一个端口  

# docker run -p port1 image          // 运行容器使用的相应命令   123

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

                                                                                                                             //指定需要映射到宿主机上的某个端口号                                      

# docker port port1 containerID               

//对于一个运行的容器，可以使用docker port加上容器中需要映射的端口和容器的ID来查看该端口号在宿主机器上的映射端口123456789101112

端口映射是docker比较重要的一个功能，原因在于我们每次运行容器时容器IP地址不能指定而是在桥接网卡的地址范围内随机生成的。宿主机器的IP地址是固定的，我们可以将容器的端口的映射到宿主机的一个端口，免去每次访问容器中的某个服务时都要查看容器的IP的地址。

（10）VOLUME（指定挂载点）

使容器中的一个目录具有持久化存储数据的功能，该目录可以被容器本身使用，也可以共享给其他容器使用。我们知道容器使用的是AUFS，这种文件系统不能持久化数据，当容器关闭后，所有的更改都会丢失。当容器中的应用有持久化数据的需求时，可以在Dockerfile中使用该指令。

格式:

VOLUME ["<mountpoint>"]  1

例子：

VOLUME ["/tmp/data"]  1

运行通过该Dockerfile构建镜像的容器，/tmp/data目录中的数据在容器关闭后，里面的数据还存在。

如果另一个容器也有持久化数据的需求，且想使用上述容器共享的/tmp/data目录，那么可以运行下面的命令启动一个容器。

# docker run -it -rm -volumes-from container1 image2   /bin/bash       

//container1为第一个容器的ID，image2为第二个容器运行image的名字。    123

（11）WORKDIR（切换目录）

可以多次切换(相当于cd命令)，对RUN，CMD，ENTRYPOINT生效。

格式:

WORKDIR /path/to/workdir    

// 一定要使用绝对路径，如果使用相对路径，那么路径会传递下去

WORKDIR   a

WORKDIR   b

WORKDIR   c                                                                   

// 相当于#cd /a/b/c                       123456789

例子：在Dockerfile中写入以下

WORKDIR /path/to/p1

WORKDIR p2

RUN  vim a.txt                                                                

// 在/p1/p2下，执行# vim a.txt  12345

（12）ONBUILD（镜像触发器）

当一个镜像被其他镜像作为基础镜像执行时，新的镜像会在构建过程中插入ONBUILD触发器中的指令

格式：

ONBUILD <Dockerfile关键字>                    

// ONBUILD指定的命令在由Dockerfile构建原镜像时并不执行，而是在由原镜像被其他镜像作为基础镜像构建时执行 123

例子：

# vim Dockerfile

...

ONBUILD COPY index.html /usr/share/nginx/html/

...

# docker build -t="locutus1/nginx4"  .                                          //构建原镜像locutus1/nginx4

# docker run -p 81 --name nginx4 locutus1/nginx4

# curl http://127.0.0.1:host_port

// 依旧是原来nginx的内容，说明在构建时虽然显示，但没有                                                                                                                执行 ONBUILD  COPY  index.html   /usr/share/nginx/html/

# vim Dockerfile                                                                          

FROM locutus1/nginx4

// 原镜像locutus1/nginx4作为locutus1/nginx5的基础镜像

... 

# docker build -t="locutus1/nginx5" .

//在step0后，执行了触发器的指令COPY                                                                                         

# docker run -p 82 --name nginx4 locutus1/nginx5

# curl http://127.0.0.1:host_port

//是COPY指令所复制的index.html的内容了