Dockerfile是由一系列命令和参数构成的脚本，这些命令应用于基础镜像并最终创建一个新的镜像。

常用的选项

例子：

FROM node:latestMAINTAINER my_nameADD ./my_project /codeVOLUME ["/data1", "/data2"]WORKDIR /codeRUN apt-get install mysqlEXPOSE 6777ENV SRC_URL www.xxxxxxxxxxx.com/xxxxxxxRUN wget $SRC_URLCMD ["node","bin/www"]

• FROM: 指定基础镜像，如果本地不存在基础镜像，会自动从远程仓库拉取。FROM必须是Dockerfile中除了注释外的第一行语句。
• MAINTAINER: 用于指定镜像的构建者，当发现坑的时候可以找他
• ADD： 将本机的文件或目录复制到镜像的某个目录下，在后续的构建命令和容器运行中可以在容器中访问该目录
• WORKDIR： 指定后续的构建命令的工作路径
• RUN: 在镜像中运行某条命令，如安装相关的依赖库
• CMD：用于指定镜像运行时的第一条命令。CMD只能出现一次，如果出现多次，前面的会被覆盖

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

• EXPOSE：暴露容器的端口，其他容器可以通过该端口访问本容器提供的服务，前提是这些容器在同一个网络中，例子中暴露了6777端口
• ENV: 设置环境变量。这些环境变量可以在后续的构建命令中使用，当运行容器时，也可以在容器中使用这些变量
• COPY: 将本机的文件或目录复制到镜像的某个目录下，在后续的构建命令和容器运行中可以在容器中访问该目录。该命令作用同ADD，只是ADD更加强大，如：当拷贝的是压缩包，ADD会自动解压
• ENTRYPOINT: 容器启动后执行的命令。每个 Dockerfile 中只能有一个ENTRYPOINT，当指定多个时，只有最后一个生效。(CMD指令指定的容器启动时命令可以被docker run指定的命令覆盖；而ENTRYPOINT指令指定的命令不能被覆盖，而是将docker run指定的参数当做ENTRYPOINT指定命令的参数。)

ENTRYPOINT ["executable", "param1", "param2"]    ENTRYPOINT command param1 param2（shell中执行）

• VOLUME: 容器卷是一个可供一个或多个容器使用的特殊目录，它绕过 UFS，将主机目录挂在到容器里面，可以提供很多有用的特性：

  • 数据卷 可以在容器之间共享和重用
  • 对 数据卷 的修改会立马生效
  • 对 数据卷 的更新，不会影响镜像
  • 数据卷 默认会一直存在，即使容器被删除，除非在删除容器的时候使用-v选项： docker rm -v container_id/container_name
  • 注意： 数据卷 的使用，类似于 Linux 下对目录或文件进行 mount，镜像中的被指定为挂载点的目录中的文件会隐藏掉，能显示看的是挂载的 数据卷 。因此你的容器目录dir有一个文件为temp.data，如果你在dir挂载了一个数据卷
  • 在Dockerfile中，无法指定主机上对应的目录

，那么你就再也不能读取temp.data，除非你移除该数据卷。

其他选项

USER

格式：

USER 
    <用户名>

USER 指令和 WORKDIR 相似，都是改变环境状态并影响以后的层。 WORKDIR 是改变工作目录， USER 则是改变之后层的执行 RUN , CMD 以及 ENTRYPOINT 这类命令的身份。

当然，和 WORKDIR 一样， USER 只是帮助你切换到指定用户而已，这个用户必须是事先建立好的，否则无法切换。

RUN groupadd -r redis && useradd -r -g redis redisUSER redisRUN [ "redis-server" ]

如果以 root 执行的脚本，在执行期间希望改变身份，比如希望以某个已经建立好的用户来运行某个服务进程，不要使用 su 或者 sudo ，这些都需要比较麻烦的配置，而且在 TTY 缺失的环境下经常出错。建议使用 gosu 。

# 建立 redis 用户，并使用 gosu 换另一个用户执行命令RUN groupadd -r redis && useradd -r -g redis redis# 下载 gosuRUN wget -O /usr/local/bin/gosu "https://github.com/tianon/gosu/releases/download/1.7/gosu-amd64" \&& chmod +x /usr/local/bin/gosu \&& gosu nobody true# 设置 CMD，并以另外的用户执行CMD [ "exec", "gosu", "redis", "redis-server" ]

ONBUILD

格式： ONBUILD <其它指令> 。

ONBUILD 是一个特殊的指令，它后面跟的是其它指令，比如 RUN , COPY 等，而这些指令，在当前镜像构建时并不会被执行。只有当以当前镜像为基础镜像，去构建下一级镜像的时候才会被执行。

Dockerfile 中的其它指令都是为了定制当前镜像而准备的，唯有 ONBUILD 是为了帮助别人定制自己而准备的。

fundamental/Dockerfile

FROM node:slimRUN mkdir /appWORKDIR /appONBUILD COPY ./package.json /appONBUILD RUN [ "npm", "install" ]ONBUILD COPY . /app/CMD [ "npm", "start" ]

project1/Dockerfile

FROM fundamentaldo other thing

在构建 project1 的时候 ONBUILD的命令才会生效。

例子

我们将基于官方的python镜像，搭建一个后端的环境镜像（需要用的库含redis、flask等）。

FROM python:3.6-alpine# 复制代码到镜像ADD the_path_of_project /code   # 设置后面的命令的pwdWORKDIR /code# 安装依赖RUN pip install redis flask# 运行服务的命令CMD ["python", "app.py"]

例子中：

• FROM：指定基础镜像为python:3.6-alpine
• ADD：项目代码被复制到容器的code目录下
• WORKDIR：指定后续命令的pwd为code
• RUN：安装依赖库
• CMD：指定启动容器时需要运行的命令，即启动我们的项目

参考

• 上一节：
• 下一节：