Dockerfile 是一个文本格式的配置文件,用户可以使用 Dockerfile 快速创建自定义的镜像。
基本结构
Dockerfile 由一行行命令语句组成,并且支持以 # 开头的注释行。
Dockerfile 分为四部分:基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令。
例如:
# This dockerfile user the ubuntu image
# VERSION 2 - EDITON 1
# Author: docker_user
# Command format: Instruction [arguments / command] ..
# 第一行必须指定基于的基础镜像
FROM ubuntu
# 维护者信息
MAINTAINER docker_user docker_user@email.com
# 镜像的操作指令
RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe" >> /etc/apt/sources.list
RUN apt-get update && apt-get install -y nginx
RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf
# 容器启动时执行指令
CMD /usr/sbin/nginx
指令
指令的一般格式为 INSTRUCTION arguments, 指令包括 FROM、MAINTAINER、RUN 等。
1.FROM
格式为 FROM <image> 或 FROM<image>:<tag>。
例如: FROM ubuntu
2.MAINTAINER
格式为 MAINTAINER <name>, 指定维护者维息。
例如:MAINTAINER docker_user docker_user@email.com
3.RUN
格式为 RUN <command> 或 RUN ["executable", "param1", "param2"]。
每条RUN 指令将在当前镜像基础上执行指定命令,交提交为新的镜像。当命令较长时可以使用 \ 来换行。
4.CMD
支持三种格式:
- CMD ["executable","param1',"param2"] 使用 exec 执行,推荐方式。
- CMD command param1 param2 在 /bin/sh 中执行,提供给需要交互的应用。
- CMD ["param1","param2"] 提供给 ENTRYPOINT 的默认参数。
指定启动容器时执行的命令,每个Dockerfile 只能有一条 CMD命令。如果指定了多条命令,只有最后一条会被执行。
如果用户启动容器时指定了运行的命令,则会覆盖掉 CMD 指定的命令。
5.EXPOSE
格式为 EXPOSE <port> [<prot>...]
例如:
EXPOSE 22 80 8443
6.ENV
格式为 ENV <key> <value>。指定一个环境变量,会被后续 RUN 指令使用,并在容器运行时保持。例如:
ENV PG_MAJOR 9.3
ENV PG_VERSION 9.3.4
RUN curl -SL http://example.com/postgree-PG_VERSION.tar.xz | tar -xJC /usr/src/postgree && ...
ENV PATH /usr/local/postgree-$PG_MAJOR/bin:$PATH
7.ADD
格式为 ADD <src><dest>
该命令将复制指定的<src>到容器中的<dest>。其中<src>可以是Dockerfile 所在目录的一个相对路径(文件或目录);也可以是一个URL;还可以是一个 tar 文件(自动解压为目录)
8.COPY
格式为 COPY <src><dest>
复制本地主机的<src> 为容器中的<dest>。目标路径不存在时,会自动创建。
当使用本地目录为源目录时,推荐使用COPY
9 ENTRYPOINT
有两种格式:
ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2 (shell 中执行)
配置容器启动后执行的命令,并且不可被 docker run 提供的参数覆盖。
每个Dockerfile 中只能有一个 ENTRYPOINT, 当指定多个 ENTRYPOINT 时,只有最后一个生效。
创建镜像
编写完成 Dockerfile 之后,可以通过docker build 命令来创建镜像。
要指定镜像的标签信息,可以通过 -t 选项
例如,指定 Dockerfile 所在路径为 /tmp/docker_builder/, 并且生成镜像标签为 build_repo/first_images,可以使用下面的命令:
root@localhost:~# sudo docker build -t build_repo/first_image /tmp/docker_builder/
小结
本章主要介绍Dockerfile 配置文件的重要概念,包括基本结构、所支持的内部指令,以及使用它创建镜像的基本过程。
DockerHub 和 DockerPool 社区都提供了大量的 Dockerfile 范例供大家参考。