Dockerfile学习

Dockerfile学习

参考链接: https://docs.docker.com/engine/reference/builder/

---

Dockerfile

• Dockerfile 可以自定义镜像。
• 用户可以使用docker build命令，自动构建一个镜像。
• Dockerfile是由一行行命令语句组成，并且支持以 # 开头的注释行。

---

Dockerfile基本结构

Dockerfile一般分为四部分：

• 基础镜像：以哪个镜像作为基础进行制作。用法 FROM [基础镜像名称]
• 维护者信息：需要写下该Dockerfile编写人的姓名或邮箱。用法 MANITAINER [名字/邮箱]
• 镜像操作命令：对基础镜像要进行的改造命令，比如安装新的软件，进行哪些特殊配置等。RUN 、EVN 、ADD 、WORKDIR 等。
• 容器启动命令：当基于该镜像的容器启动时需要执行哪些命令。CMD 、ENTRYPOINT 、USER 等。

（示例）：

创建一个nginx目录，里面包含两个文件：dockerfile、index.html.

sbw@sbw:~ mkdir nginx
sbw@sbw:~ cd nginx
sbw@sbw:~/nginx$ cat index.html 
<h1>hello!!!!<h1>
sbw@sbw:~/dockerfile$ cat dockerfile
#基础镜像
FROM nginx

#指定工作路径
WORKDIR /usr/share/nginx/html

#将当前目录下的所有文件COPY到工作目录下
COPY . . 

#EXPOSE 指定对外开放的端口
EXPOSE 80

# 第一行必须指定基于的基础镜像
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

docker build 创建镜像
docker build --tag <镜像名称> <运行的路径>

docker sbw@sbw:~nginx$ docker build --tag firstdemo:v1 /home/sbw/docker
Sending build context to Docker daemon  3.072kB
Step 1/4 : FROM nginx
 ---> c39a868aad02
Step 2/4 : WORKDIR /usr/share/nginx/html
 ---> Running in bb614f27b963
Removing intermediate container bb614f27b963
 ---> 9c609c8d0422
Step 3/4 : COPY . .
 ---> 467d45faf512
Step 4/4 : EXPOSE 80
 ---> Running in d3502fcc9ba7
Removing intermediate container d3502fcc9ba7
 ---> f0ab2f8447f4
Successfully built f0ab2f8447f4
Successfully tagged firstdemo:v1

---

Dockerfile指令解析

指令	说明
FROM	指定创建镜像的基础镜像
WORKDIR	指定工作目录
RUN	运行指定命令，对镜像进行构建、配置
ADD	源文件可以是压缩文件或添加，用于将压缩包、连接，解压、下载至指定目录
COPY	复制内容到镜像，目标路径不存在时会自动创建
CMD	启动容器时指定默认执行的命令
LABEL	为生产的镜像添加元数据标签信息
VOLUME	指定创建数据卷挂载点
ENV	指定环境变量
ARG	定义镜像创建过程中的变量
EXPOSE	镜像内服务监听的端口，并对外进行暴露
ENTRYPOINT	指定镜像默认的入口命令
USER	指定运行容器的用户名和UID

• FROM 指定基础镜像
  FROM 指令用于指定其后构建新镜像所使用的基础镜像。FROM 必须 是 Dockerfile 中第一条非注释命令，启动构建流程后，Docker 将会基于该镜像构建新镜像，FROM 后的命令也会基于这个基础镜像。
  在一个 Dockerfile 文件中创建多个镜像时，FROM 可以多次出现，只需在每个新命令 FROM 之前，记录提交上次的镜像 ID。

  FROM语法格式为 ：

  FROM <image>
  

  或

  FROM <image>  <tag> 
  

  或

  FROM  <image> <digest> 
  

  tag 或 digest 是可选的，如果不使用这两个值时，会使用 latest 版本的基础镜像

• RUN 执行命令
  RUN 命令将在当前 image 中执行任意合法命令并提交执行结果。命令执行提交后，就会自动执行 Dockerfile 中的下一个指令。
  层级 RUN 指令和生成提交是符合 Docker 核心理念的做法。它允许像版本控制那样，在任意一个点，对 image 镜像进行定制化构建。
  RUN 指令创建的中间镜像会被缓存，并会在下次构建中使用。如果不想使用这些缓存镜像，可以在构建时指定 --no-cache 参数，如：docker build --no-cache。

  #shell格式
  RUN <command>
  #exec格式
  RUN ["executable", "param1", "param2"]
  

• COPY复制文件
  格式：

   COPY <源路径>... <目标路径>
  COPY ["<源路径1>",... "<目标路径>"] 
  

  和 RUN 指令一样，也有两种格式，一种类似于命令行，一种类似于函数调用。COPY 指令将从构建上下文目录中 <源路径> 的文件/目录复制到新的一层的镜像内的"<目标路径>"位置。比如：

  COPY package.json /usr/src/app/
  

  <源路径>可以是多个，甚至可以是通配符，其通配符规则要满足 Go 的 filepath.Match 规则，如：

  COPY hom* /mydir/
  COPY hom?.txt /mydir/
  

  <目标路径>可以是容器内的绝对路径，也可以是相对于工作目录的相对路径（工作目录可以用 WORKDIR 指令来指定）。目标路径不需要事先创建，如果目录不存在会在复制文件前先行创建缺失目录。

  此外，还需要注意一点，使用 COPY 指令，源文件的各种元数据都会保留。比如读、写、执行权限、文件变更时间等。这个特性对于镜像定制很有用。特别是构建相关文件都在使用 Git 进行管理的时候。

• ADD 更高级的复制文件
  ADD 指令和 COPY 的格式和性质基本一致。但是在 COPY 基础上增加了一些功能。比如<源路径>可以是一个 URL，这种情况下，Docker 引擎会试图去下载这个链接的文件放到<目标路径>去。
  在构建镜像时，复制上下文中的文件到镜像内，格式：

  ADD <源路径>... <目标路径>
  ADD ["<源路径>",... "<目标路径>"]
  

  注意
  如果 docker 发现文件内容被改变，则接下来的指令都不会再使用缓存。关于复制文件时需要处理的/，基本跟正常的 copy 一致

• ENV 设置环境变量
  格式有两种：

  ENV <key> <value>
  ENV <key1>=<value1> <key2>=<value2>...
  

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

  ENV VERSION=1.0 DEBUG=on \
  	NAME="get out"
  

  这个例子中演示了如何换行，以及对含有空格的值用双引号括起来的办法，这和 Shell 下的行为是一致的。

• EXPOSE暴露端口
  为构建的镜像设置监听端口，使容器在运行时监听。格式：

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

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

• VOLUME 定义匿名卷
  VOLUME用于创建挂载点，即向基于所构建镜像创始的容器添加卷：

  VOLUME ["/data"]
  

  一个卷可以存在于一个或多个容器的指定目录，该目录可以绕过联合文件系统，并具有以下功能：

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

  VOLUME 让我们可以将源代码、数据或其它内容添加到镜像中，而又不并提交到镜像中，并使我们可以多个容器间共享这些内容。

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

  WORKDIR /path/to/workdir
  

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

  WORKDIR /a
  WORKDIR b
  WORKDIR c
  RUN pwd
  

  在以上示例中，pwd 最终将会在 /a/b/c 目录中执行。在使用 docker run 运行容器时，可以通过-w参数覆盖构建时所设置的工作目录。

• USER 指定当前用户
  USER 用于指定运行镜像所使用的用户：

  USER daemon
  

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

  USER user
  USER user:group
  USER uid	
  USER uid:gid
  USER user:gid
  USER uid:group
  

  使用USER指定用户后，Dockerfile 中其后的命令 RUN、CMD、ENTRYPOINT 都将使用该用户。镜像构建完成后，通过 docker run 运行容器时，可以通过 -u 参数来覆盖所指定的用户。

• CMD容器启动命令
  CMD用于指定在容器启动时所要执行的命令。CMD 有以下三种格式：

  CMD ["executable","param1","param2"]
  CMD ["param1","param2"]
  CMD command param1 param2
  

  省略可执行文件的 exec 格式，这种写法使 CMD 中的参数当做 ENTRYPOINT 的默认参数，此时 ENTRYPOINT 也应该是 exec 格式，具体与 ENTRYPOINT 的组合使用，参考 ENTRYPOINT。

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

• ENTRYPOINT入口点
  ENTRYPOINT 用于给容器配置一个可执行程序。也就是说，每次使用镜像创建容器时，通过 ENTRYPOINT 指定的程序都会被设置为默认程序。ENTRYPOINT 有以下两种形式：

  ENTRYPOINT ["executable", "param1", "param2"]
  ENTRYPOINT command param1 param2
  

  ENTRYPOINT 与 CMD 非常类似，不同的是通过 docker run 执行的命令不会覆盖ENTRYPOINT，而docker run 命令中指定的任何参数，都会被当做参数再次传递给 ENTRYPOINT。dockerfile 中只允许有一个 ENTRYPOINT 命令，多指定覆盖前面的设置，而只执行最后的 ENTRYPOINT 指令。

  docker run 运行容器时指定的参数都会被传递给 ENTRYPOINT ，而且会覆盖 CMD 指定的参数。
  如，执行docker run -d 时， -d 参数将被传递给入口点。

  也可以通过docker run -entrypoint重写 ENTRYPOINT 入口点。如：可以像下面这样指定一个容器执行程序：

  ENTRYPOINT ["/usr/bin/nginx"]
  

  完整构建代码：

  Version: 0.0.1
  FROM ubuntu:20.04
  MAINTAINER sunbw"12345@gmail.com"
  RUN apt-get update
  RUN apt-get install -y nginx
  RUN echo 'I'm very good' \ 
  		> /var/www/html/index.html
  ENTRYPOINT ["/usr/sbin/nginx"]
  EXPOSE 80
  

  使用docker build构建镜像，并将镜像指定为 ubuntu/test

  docker build -t ubuntu/test .
  

  构建完成后，使用 ubuntu/test 启动一个容器：

  docker run -i -t  nginx:v1 -g "daemon off"
  

  在运行容器时，我们使用了 -g “daemon off;”，这个参数将会被传递给 ENTRYPOINT，最终在容器中执行的命令为 /usr/sbin/nginx -g “daemon off;”。

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

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

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

   LABEL version="1.0" description="felord.cn" by="Felordcn"
  

  指定后可以通过docker inspect查看：

  docker inspect ubuntu/test
  "Labels": {
  	"version": "1.0",
  	"description": "felord.cn",
  	"by": "IT笔录"
  },
  

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

  ARG <name>[=<default value>]
  

  如，通过ARG指定两个变量：

  ARG site
  ARG build_user=Utest
  

  以上我们指定了 site 和 build_user 两个变量，其中 build_user 指定了默认值。在使用 docker build 构建镜像时，可以通过 --build-arg = 参数来指定或重设置这些变量的值。

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

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

• ONBUILD
  ONBUILD用于设置镜像触发器：

  ONBUILD [INSTRUCTION]
  

  当所构建的镜像被用做其它镜像的基础镜像，该镜像中的触发器将会被钥触发。 如，当镜像被使用时，可能需要做一些处理：

  [...]
  ONBUILD ADD . /app/src
  ONBUILD RUN /usr/local/bin/python-build --dir /app/src
  [...]
  

• STOPSIGNAL
  STOPSIGNAL用于设置停止容器所要发送的系统调用信号：

  STOPSIGNAL signal
  

  所使用的信号必须是内核系统调用表中的合法的值，如：SIGKILL。

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

  SHELL ["executable", "parameters"]
  

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

  FROM microsoft/windowsservercore
  
  # Executed as cmd /S /C echo default
  RUN echo default
  
  # Executed as cmd /S /C powershell -command Write-Host default
  RUN powershell -command Write-Host default
  
  # Executed as powershell -command Write-Host hello
  SHELL ["powershell", "-command"]
  RUN Write-Host hello
  
  # Executed as cmd /S /C echo hello
  SHELL ["cmd", "/S"", "/C"]
  RUN echo hello
  

---