介绍

Dockerfile是docker image构建脚本，是用于生成image。Dockerfile忽略大小写，使用‘#’注释，每行只执行一条指令。Dockerfile指令分为两种，构建指令和设置指令。

构建指令，用于构建image，不会在image的容器上执行
设置指令，用于设置image属性，会在image的容器上执行

Dockerfile指令

FROM

构建指令，用于指定基础image。该指令必须指定在Dockerfile其它指令的前面，后面的Dockerfile指令都依赖于该指令指定的image。FROM指令指定的基础image可以是官方docker hub仓库中的，也可以是位于本地仓库中的。

指令格式：FROM <image>[:<tag>]
若不指定:<tag>，默认使用:latest。

MAINTAINER

构建指令，用于将image的制作者相关信息写入到image中。

指令格式：MAINTAINER <name>

RUN

构建指令，可以运行任何被基础image支持的命令。

指令格式：RUN <command> 或 RUN ["executable","param 1","param n"]
一般用于软件安装

CMD

设置指令，用于container启动时指定的操作。该操作可以是执行自定义脚本，也可以是执行系统命令。该指令只能在文件中存在一次，如果有多个，则只执行最后一条。

指令格式：CMD <executable> <param 1> <param n> 或 CMD ["executable", "param 1", "param n"]

ENTRYPOINT

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

指令格式：ENTRYPOINT ["executable", "param 1", "param n"] 或 ENTRYPOINT <executable> <param 1> <param n>
CMD指令和ENTRYPOINT会互相覆盖只有最后一个CMD或者ENTRYPOINT有效。

和CMD指令配合使用来指定ENTRYPOINT的默认参数，这时CMD指令不是一个完整的可执行命令，仅仅是参数部分。ENTRYPOINT指令只能使用JSON方式指定执行命令，而不能指定参数。

1
2
3

FROM centos7
CMD ["-l"]
ENTRYPOINT ["/usr/bin/ls"]

USER

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

指令格式：USER <user name>

EXPOSE

设置指令，该指令会将容器中的端口映射成宿主机器中的某个端口。需要访问容器的时候，可以不是用容器的IP地址而是使用宿主机器的IP地址和映射后的端口。首先在Dockerfile使用EXPOSE设置需要映射的容器端口，然后在运行容器的时候指定-p选项加上EXPOSE设置的端口，这样EXPOSE设置的端口号会被随机映射成宿主机器中的一个端口号。也可以指定需要映射到宿主机器的那个端口，这时要确保宿主机器上的端口号没有被使用。EXPOSE指令可以一次设置多个端口号，相应的运行容器的时候，可以配套的多次使用-p选项。

指令格式：EXPOSE <port> [<port>...]

ENV

构建指令，在image中设置一个环境变量

指令格式：ENV <key> <value>
设置了后，后续的RUN命令都可以使用，container启动后，可以通过docker inspect查看这个环境变量，也可以通过在docker run –env key=value时设置或修改环境变量。

ADD

构建指令，从src复制文件到container的dest路径。

指令格式：ADD <src> <dest>

<src>是相对被构建的源目录的相对路径，可以是文件或目录的路径，也可以是一个远程的文件url
<dest>是container中的绝对路径
所有拷贝到container中的文件和文件夹权限为0755，uid和gid为0；如果是一个目录，那么会将该目录下的所有文件添加到container中，不包括目录；如果文件是可识别的压缩格式，则docker会帮忙解压缩（注意压缩格式）；如果<src>是文件且<dest>中不使用斜杠结束，则会将<dest>视为文件，<src>的内容会写入<dest>；如果<src>是文件且<dest>中使用斜杠结束，则会<src>文件拷贝到<dest>目录下。

VOLUME

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

指令格式：VOLUME ["<mount point path>"]

WORKDIR

设置指令，切换目录，可多次切换（相当于cd命令），对RUN、CMD、ENTRYPOINT生效

指令格式：WORKDIR <path>

ONBUILD

设置指令，在子镜像中执行，在构建镜像时并不执行，而是在它的子镜像中执行

指令格式：ONBUILD <Dockerfile指令>

示例

# 第一条有效指令必须指出基础镜像
FROM my_ubuntu_03:latest

# 作者
MAINTAINER zhou bo

# 环境变量
ENV BASE_IMAGE="ubuntu:16"
ENV CURRENT_IMAGE="Simple Image"

# 安装 ssh server 端程序
RUN apt-get update
RUN apt-get install -y openssh-server

# 映射端口22
EXPOSE 22

# 启动 ssh 守护进程
CMD ["-D"]
ENTRYPOINT ["/usr/sbin/sshd"]

# 在 / 目录下挂在一个 DataFolder 目录
VOLUME ["/DataFolder"]

# 在子镜像中执行的指令
ONBUILD ENV SON_IAMGE="你永远是我儿子"

Bolog

Dockerfile

介绍