Dockerfile 概念

一种类似有 shell 脚本的东西，方便开发者或运维可以一键生成所需要镜像。

Dockerfile文件格式

  1. ##  Dockerfile文件格式
  3. # This dockerfile uses the ubuntu image
  4. # VERSION 2 - EDITION 1
  5. # Author: docker_user
  6. # Command format: Instruction [arguments / command] ..
  8. # 1、第一行必须指定 基础镜像信息
  9. FROM ubuntu
  11. # 2、维护者信息
  12. MAINTAINER docker_user docker_user@email.com
  14. # 3、镜像操作指令
  15. RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe" >> /etc/apt/sources.list
  16. RUN apt-get update && apt-get install -y nginx
  17. RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf
  19. # 4、容器启动执行指令
  20. CMD /usr/sbin/nginx

Dockerfile 分为四部分：基础镜像信息、维护者信息、镜像操作指令、容器启动执行指令。一开始必须要指明所基于的镜像名称，接下来一般会说明维护者信息；后面则是镜像操作指令，例如 RUN 指令。每执行一条RUN 指令，镜像添加新的一层，并提交；最后是 CMD 指令，来指明运行容器时的操作命令。

构建镜像

docker build 命令会根据 Dockerfile 文件及上下文构建新 Docker 镜像。构建上下文是指 Dockerfile 所在的本地路径或一个URL（Git仓库地址）。

将当前目录做为构建上下文时，可以像下面这样使用docker build命令构建镜像

  1. $ docker build .
  2. $ Sending build context to Docker daemon  6.51 MB
  3. ...
  • 大多情况下，应该将一个空目录作为构建上下文环境，并将 Dockerfile 文件放在该目录下。
  • 为了提高构建性能，可以通过.dockerignore文件排除上下文目录下不需要的文件和目录。


Dockerfile 一般位于构建上下文的根目录下，也可以通过-f指定该文件的位置：

  1. $ docker build -f /path/to/a/Dockerfile .   //最后有个点表示当前目录

构建时，还可以通过-t参数指定构建成镜像的仓库、标签。

  1. $ docker build -t nginx/v3 .
  3. //如果存在多个仓库下，或使用多个镜像标签，就可以使用多个-t参数：
  4. $ docker build -t nginx/v3:1.0.2 -t nginx/v3:latest .

Dockerfile 指令

FROM 指定基础镜像

FROM 指令用于指定其后构建新镜像所使用的基础镜像。FROM 指令必是 Dockerfile 文件中的首条命令，启动构建流程后，Docker 将会基于该镜像构建新镜像，FROM 后的命令也会基于这个基础镜像。

语法格式：

  1. FROM <image>
  3. 或
  5. FROM <image>:<tag>
  7. 或
  9. FROM <image>:<digest>
  • FROM 必须 是 Dockerfile 中第一条非注释命令
  • 在一个 Dockerfile 文件中创建多个镜像时，FROM 可以多次出现。只需在每个新命令 FROM 之前，记录提交上次的镜像 ID。
  • tag 或 digest 是可选的，如果不使用这两个值时，会使用 latest 版本的基础镜像

RUN 执行命令

在镜像的构建过程中执行特定的命令，并生成一个中间镜像

语法格式：

  1. #shell格式
  2. RUN <command>
  4. #exec格式
  5. RUN ["executable", "param1", "param2"]
  • RUN 命令将在当前 image 中执行任意合法命令并提交执行结果。命令执行提交后，就会自动执行 Dockerfile 中的下一个指令。
  • 层级 RUN 指令和生成提交是符合 Docker 核心理念的做法。它允许像版本控制那样，在任意一个点，对 image 镜像进行定制化构建。

RUN 指令创建的中间镜像会被缓存，并会在下次构建中使用。如果不想使用这些缓存镜像，可以在构建时指定 --no-cache 参数，如：docker build --no-cache。

COPY 复制文件

COPY 指令将从构建上下文目录中 <源路径> 的文件/目录复制到新的一层的镜像内的<目标路径>位置。

语法格式：

  1. COPY <源路径>... <目标路径>
  3. COPY ["<源路径1>",... "<目标路径>"]
  5. //示例
  6. COPY package.json /usr/src/app/
  8. //<源路径>可以是多个，甚至可以是通配符，其通配符规则要满足 Go 的 filepath.Match 规则，如：
  9. COPY hom* /mydir/
  10. COPY hom?.txt /mydir/
  • <目标路径>可以是容器内的绝对路径，也可以是相对于工作目录的相对路径（工作目录可以用 WORKDIR 指令来指定）。目标路径不需要事先创建，如果目录不存在会在复制文件前先行创建缺失目录。
  • 使用 COPY 指令，源文件的各种元数据都会保留。比如读、写、执行权限、文件变更时间等

ADD 更高级的复制文件

ADD 指令和 COPY 的格式和性质基本一致。但是在 COPY 基础上增加了一些功能。比如<``源路径>可以是一个 URL，这种情况下，Docker 引擎会试图去下载这个链接的文件放到<目标路径>去。

语法格式：

  1. //格式一
  2. ADD <源路径>... <目标路径>
  4. //格式二
  5. ADD ["<源路径>",... "<目标路径>"]

ENV 设置环境变量

这个指令很简单，就是设置环境变量而已，无论是后面的其它指令，如 RUN，还是运行时的应用，都可以直接使用这里定义的环境变量。

语法格式：

  1. //格式一
  2. ENV <key> <value>
  4. //格式二
  5. ENV <key1>=<value1> <key2>=<value2>...
  7. //示例（换行）
  8. ENV VERSION=1.0 DEBUG=on \
  9.     NAME="Happy Feet"

EXPOSE 暴露端口

为构建的镜像设置监听端口，使容器在运行时监听

语法格式

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

EXPOSE 指令并不会让容器监听 host 的端口，如果需要，需要在 docker run 时使用 -p、-P 参数来发布容器端口到 host 的某个端口上。

VOLUME 定义匿名卷

VOLUME用于创建挂载点，即向基于所构建镜像创始的容器添加卷。VOLUME 让我们可以将源代码、数据或其它内容添加到镜像中，而又不并提交到镜像中，并使我们可以多个容器间共享这些内容

语法格式：

  1. VOLUME ["/data"]
  • 卷可以容器间共享和重用
  • 容器并不一定要和其它容器共享卷
  • 修改卷后会立即生效
  • 对卷的修改不会对镜像产生影响
  • 卷会一直存在，直到没有任何容器在使用它

    WORKDIR 指定工作目录

WORKDIR用于在容器内设置一个工作目录：

  1. WORKDIR /path/to/workdir

通过WORKDIR设置工作目录后，Dockerfile 中其后的命令 RUN、CMD、ENTRYPOINT、ADD、COPY 等命令都会在该目录下执行。 如，使用WORKDIR设置工作目录：

  1. WORKDIR /a
  2. WORKDIR b
  3. WORKDIR c
  4. RUN pwd
  6. //在以上示例中，pwd 最终将会在 /a/b/c 目录中执行

在使用 docker run 运行容器时，可以通过-w参数覆盖构建时所设置的工作目录。

USER 指定当前用户

USER 用于指定运行镜像所使用的用户，使用USER指定用户后，Dockerfile 中其后的命令 RUN、CMD、ENTRYPOINT 都将使用该用户

  1. USER daemon

使用USER指定用户时，可以使用用户名、UID 或 GID，或是两者的组合。以下都是合法的指定试：

  1. USER user
  2. USER user:group
  3. USER uid
  4. USER uid:gid
  5. USER user:gid
  6. USER uid:group

镜像构建完成后，通过 docker run 运行容器时，可以通过 -u 参数来覆盖所指定的用户。

CMD

CMD用于指定在容器启动时所要执行的命令

语法格式

  1. //格式一
  2. CMD ["executable","param1","param2"]
  4. //格式二
  5. CMD ["param1","param2"]
  7. //格式三
  8. CMD command param1 param2

与 RUN 指令的区别：RUN 在构建的时候执行，并生成一个新的镜像，CMD 在容器运行的时候执行，在构建时不进行任何操作。
**

ENTRYPOINT

ENTRYPOINT 用于给容器配置一个可执行程序。也就是说，每次使用镜像创建容器时，通过 ENTRYPOINT 指定的程序都会被设置为默认程序

语法格式：

  1. //格式一
  2. ENTRYPOINT ["executable", "param1", "param2"]
  4. //格式二
  5. ENTRYPOINT command param1 param2
  • ENTRYPOINT 与 CMD 非常类似，不同的是通过docker run执行的命令不会覆盖 ENTRYPOINT，而docker run命令中指定的任何参数，都会被当做参数再次传递给 ENTRYPOINT。
  • Dockerfile 中只允许有一个 ENTRYPOINT 命令，多次出现 ENTRYPOIT 的话只执行最后的 ENTRYPOINT 指令。


LABEL

LABEL用于为镜像添加元数据，元数以键值对的形式指定：

  1. LABEL <key>=<value> <key>=<value> <key>=<value> ...

使用LABEL指定元数据时，一条LABEL指定可以指定一或多条元数据，指定多条元数据时不同元数据之间通过空格分隔。推荐将所有的元数据通过一条LABEL指令指定，以免生成过多的中间镜像。

  1. LABEL version="1.0" description="这是一个Web服务器" by="IT笔录"

指定后可以通过docker inspect查看

  1. $ docker inspect itbilu/test
  3. "Labels": {
  4.     "version": "1.0",
  5.     "description": "这是一个Web服务器",
  6.     "by": "IT笔录"
  7. },

ARG

ARG用于指定传递给构建运行时的变量

  1. ARG <name>[=<default value>]

示例

  1. ARG site
  2. ARG build_user=IT笔录
  4. //以上我们指定了 site 和 build_user 两个变量，其中 build_user 指定了默认值

在使用 docker build 构建镜像时，可以通过 —build-arg = 参数来指定或重设置这些变量的值。

  1. docker build --build-arg site=itiblu.com -t itbilu/test .

这样我们构建了 itbilu/test 镜像，其中site会被设置为 itbilu.com，由于没有指定 build_user，其值将是默认值 IT 笔录。

SHELL

SHELL用于设置执行命令（shell式）所使用的的默认 shell 类型

语法格式：

  1. SHELL ["executable", "parameters"]
  1. FROM microsoft/windowsservercore
  3. # Executed as cmd /S /C echo default
  4. RUN echo default
  6. # Executed as cmd /S /C powershell -command Write-Host default
  7. RUN powershell -command Write-Host default
  9. # Executed as powershell -command Write-Host hello
  10. SHELL ["powershell", "-command"]
  11. RUN Write-Host hello
  13. # Executed as cmd /S /C echo hello
  14. SHELL ["cmd", "/S"", "/C"]
  15. RUN echo hello

SHELL在Windows环境下比较有用，Windows 下通常会有 cmd 和 powershell 两种 shell，可能还会有 sh。这时就可以通过 SHELL 来指定所使用的 shell 类型。