Dockerfile

Docker 之 Dockerfile

1. Dockerfile的基本结构

Dockerfile由一行行命令语句组成，并且支持用 “#” 开头作为注释，一般的，Dockerfile分为四部分：基础镜像信息，维护者信息，镜像操作指令和容器启动时执行的指令。例如：

# This dockerfile uses the ubuntu image
# VERSION 2 - EDITION 1
# Author: docker_user
# Command format: Instruction [arguments / command ] ..

# Base image to use, this nust be set as the first line
# 第一行必须指定基于的基础镜像
FROM ubuntu

# Maintainer: docker_user <docker_user at email.com> (@docker_user)
# 维护者信息
MAINTAINER docker_user docker_user@email.com

# Commands to update the image
# 镜像的操作指令
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

# Commands when creating a new container
# 容器启动时执行的指令
CMD /usr/sbin/nginx

案例：

# Nginx
#
# VERSION   0.0.1
FROM ubuntu
MAINTAINER docker_user docker_user@email.com
RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server
EXPOSE 80
CMD /usr/sbin/nginx

2.指令

指令的一般格式为INSTRUNCTION arguments，指令包括FROM、MAINTAINER、RUN等。具体指令及说明如下：

• FROM

  • 格式：FROM <image>或 FROM <image>:<tag>
  • 用途：第一条指令必须为FROM指令，并且，如果在同一个Dockerfile中创建多个镜像时，可以使用多个FROM指令（每个镜像一次）

• MAINTAINER

  • 格式：MAINTAINET <name>
  • 用途：指定维护者的信息

• RUN

  • 格式：RUN <command> 或 RUN ["", "", ""]

  • 用途：每条指令将在当前镜像基础上执行，并提交为新的镜像。（可以用“\”换行）

• CMD

  • 格式：CMD ["","",""]
  • 用途：指定启动容器时执行的命令，每个Dockerfile只能有一条CMD指令，如果指定了多条指令，则最后一条执行。（会被启动时指定的命令覆盖）

• EXPOSE

  • 格式：EXPOSE <port> [ <port> ...]
  • 例：EXPOSE 22 80 8443
  • 用途：告诉Docker服务端暴露端口，在容器启动时需要通过 -p 做端口映射

• ENV

  • 格式：ENV <key> <value>
  • 用途：指定环境变量，会被RUN指令使用，并在容器运行时保存

• ADD

  • 格式：ADD <src> <dest>
  • 用途：复制指定的<src>到容器的<dest>中，<src>可以是Dockerfile所在的目录的一个相对路径；可以是URL，也可以是tar.gz（自动解压）

• COPY

  • 格式：COPY <src> <dest>
  • 用途：复制本地主机的 <src> （ 为 Dockerfile 所在目录的相对路径）到容器中的 <dest> （当使用本地目录为源目录时，推荐使用 COPY）

• ENTRYPOINT

  • 格式1：ENTRYPOINT ["executable","param1","param2"]
  • 格式2：ENTRYPOINT command param1 param2(Shell中执行)
  • 用途：配置容器启动后执行的命令，并且不可被 docker run 提供的参数覆盖。（每个 Dockerfile 中只能有一个 ENTRYPOINT ，当指定多个时，只有最后一个起效）

• VOLUME

  • 格式：VOLUME ["/mnt"]
  • 用途：创建一个可以从本地主机或其他容器挂载的挂载点，一般用来存放数据库和需要保持的数据等

• USER

  • 格式：USER daemon
  • 用途：指定运行容器时的用户名或 UID，后续的 RUN 也会使用指定用户。

• WORKDIR

  • 格式：WORKDIR /path/to/workdir
  • 用途：为后续的 RUN 、 CMD 、 ENTRYPOINT 指令配置工作目录。（可以使用多个 WORKDIR 指令，后续命令如果参数是相对路径， 则会基于之前命令指定的路径）

• ONBUILD

  • 格式：ONBUILD [INSTRUCTION]
  • 用途：配置当所创建的镜像作为其它新创建镜像的基础镜像时，所执行的操作指令

3.创建镜像

编写玩Dockerfile之后，可以通过docker build命令来创建镜像。
基本的docker build [选项] 内容路径，该命令将读取指定路径下(包括子目录)的Dockerfile，并将该路径下的所有内容发送给Docker服务端，由服务端来创建镜像。因此除非生成镜像需要，否则一般建议放置Dockerfile的目录为空目录。

1.如果使用非内容路径下的Dockerfile，可以通过-f选项来指定其路径；
2.要指定生成镜像的标签信息，可以使用-t选项。

例如：指定Dockerfile所在路径为 /tmp/docker_builder/，并且希望生成镜像标签为build_repo/first_image，可以使用下面的命令：

docker build -t build_repo/first_image /tmp/docker_builder