乐趣区

关于docker:Docker六DockerFile构建镜像

jiezi

人生有涯，学海无涯

首先通过一张图来理解 Docker 镜像、容器和 Dockerfile 三者之间的关系。

通过上图能够看出应用 Dockerfile 定义镜像，运行镜像启动容器。

Dockerfile 概念

Docker 镜像是一个非凡的文件系统，除了提供容器运行时所需的程序、库、资源、配置等文件外，还蕴含了一些为运行时筹备的一些配置参数（如匿名卷、环境变量、用户等）。镜像不蕴含任何动态数据，其内容在构建之后也不会被扭转。

镜像的定制实际上就是定制每一层所增加的配置、文件。如果咱们能够把每一层批改、装置、构建、操作的命令都写入一个脚本，用这个脚本来构建、定制镜像，那么之前提及的无奈反复的问题、镜像构建透明性的问题、体积的问题就都会解决。这个脚本就是 Dockerfile。

Dockerfile 是一个文本文件，其内蕴含了一条条的指令(Instruction)，每一条指令构建一层，因而每一条指令的内容，就是形容该层该当如何构建。有了 Dockerfile，当咱们须要定制本人额定的需要时，只需在 Dockerfile 上增加或者批改指令，从新生成 image 即可，省去了敲命令的麻烦。

DockerFile 的指令

1、FROM 指定根底镜像

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

FROM 语法格局为：

FROM <image>
FROM <image>:<tag>
FROM <image>:<digest>

通过 FROM 指定的镜像，能够是任何无效的根底镜像。FROM 有以下限度：

  • FROM 必须 是 Dockerfile 中第一条非正文命令
  • 在一个 Dockerfile 文件中创立多个镜像时，FROM 能够屡次呈现。只需在每个新命令 FROM 之前，记录提交上次的镜像 ID。
  • tag 或 digest 是可选的，如果不应用这两个值时，会应用 latest 版本的根底镜像

2、RUN 执行命令

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

#shell 格局
RUN <command>
#exec 格局
RUN ["executable", "param1", "param2"]
  • RUN 命令将在以后 image 中执行任意非法命令并提交执行后果。命令执行提交后，就会主动执行 Dockerfile 中的下一个指令。
  • 层级 RUN 指令和生成提交是合乎 Docker 核心理念的做法。它容许像版本控制那样，在任意一个点，对 image 镜像进行定制化构建。
  • RUN 指令创立的两头镜像会被缓存，并会在下次构建中应用。如果不想应用这些缓存镜像，能够在构建时指定 --no-cache 参数，如：docker build --no-cache。

3、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 进行治理的时候。

4、ADD 更高级的复制文件

ADD 指令和 COPY 的格局和性质基本一致。

在 Docker 官网的 [Dockerfile 最佳实际文档]() 中要求，尽可能的应用 COPY，因为 COPY 的语义很明确，就是复制文件而已，而 ADD 则蕴含了更简单的性能，其行为也不肯定很清晰。最适宜应用 ADD 的场合，就是所提及的须要主动解压缩的场合。

另外须要留神的是，ADD 指令会令镜像构建缓存生效，从而可能会令镜像构建变得比拟迟缓。

因而在 COPY 和 ADD 指令中抉择的时候，能够遵循这样的准则，所有的文件复制均应用 COPY 指令，仅在须要主动解压缩的场合应用 ADD。

在构建镜像时，复制上下文中的文件到镜像内，格局：

ADD < 源门路 >... < 指标门路 >
ADD ["< 源门路 >",... "< 指标门路 >"]

5、ENV 设置环境变量

格局有两种：

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

这个指令很简略，就是设置环境变量而已，无论是前面的其它指令，如 RUN，还是运行时的利用，都能够间接应用这里定义的环境变量。

ENV VERSION=1.0 DEBUG=on \
    NAME="Happy Feet"

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

6、EXPOSE

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

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

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

7、VOLUME 定义匿名卷

VOLUME 用于创立挂载点，即向基于所构建镜像开创的容器增加卷：

VOLUME ["/data"]

一个卷能够存在于一个或多个容器的指定目录，该目录能够绕过联结文件系统，并具备以下性能：

  • 卷能够容器间共享和重用
  • 容器并不一定要和其它容器共享卷
  • 批改卷后会立刻失效
  • 对卷的批改不会对镜像产生影响
  • 卷会始终存在，直到没有任何容器在应用它

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

8、CMD 容器启动命令

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

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

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

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

9、ENTRYPOINT 入口点

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 <image> -d 时，-d 参数将被传递给入口点。

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

ENTRYPOINT ["/usr/bin/nginx"]

10、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 参数来笼罩所指定的用户。

11、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 参数笼罩构建时所设置的工作目录。

12、LABEL 为镜像增加元数据

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

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

应用 LABEL 指定元数据时，一条 LABEL 指定能够指定一或多条元数据，指定多条元数据时不同元数据之间通过空格分隔。举荐将所有的元数据通过一条 LABEL 指令指定，免得生成过多的两头镜像。如，通过 LABEL 指定一些元数据：

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

指定后能够通过 docker inspect 查看：

docker inspect itbilu/test
"Labels": {
    "version": "1.0",
    "description": "这是一个 Web 服务器",
    "by": "IT 笔录"
},

13、ARG 构建参数

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

ARG <name>[=<default value>]

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

ARG site
ARG build_user=IT 笔录

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

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

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

14、ONBUILD 为别人作嫁衣裳

ONBUILD 用于设置镜像触发器：

ONBUILD [INSTRUCTION]

当所构建的镜像被用做其它镜像的根底镜像，该镜像中的触发器将会被钥触发。如，当镜像被应用时，可能须要做一些解决：

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

15、STOPSIGNAL

STOPSIGNAL 用于设置进行容器所要发送的零碎调用信号：

STOPSIGNAL signal

所应用的信号必须是内核零碎调用表中的非法的值，如：SIGKILL。

16、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

DockerFile 文件格式

##  Dockerfile 文件格式

# This dockerfile uses the ubuntu image
# VERSION 2 - EDITION 1
# Author: docker_user
# Command format: Instruction [arguments / command] ..
 
# 1、第一行必须指定 根底镜像信息
FROM ubuntu
 
# 2、维护者信息
MAINTAINER docker_user docker_user@email.com
 
# 3、镜像操作指令
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
 
# 4、容器启动执行指令
CMD /usr/sbin/nginx

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

DockerFile 实例

一、在最根底的 centos 镜像上增加性能

首先来启动一个 centos 镜像

[root@jiangwang /]# docker images
REPOSITORY            TAG       IMAGE ID       CREATED        SIZE
tomcat                9.0       040bdb29ab37   8 weeks ago    649MB
tomcat                latest    040bdb29ab37   8 weeks ago    649MB
nginx                 latest    f6d0b4767a6c   8 weeks ago    133MB
centos                latest    300e315adb2f   3 months ago   209MB
portainer/portainer   latest    62771b0b9b09   7 months ago   79.1MB
[root@jiangwang /]# docker run -it centos
[root@124a4f4fda98 /]# pwd
/
[root@124a4f4fda98 /]# vim
bash: vim: command not found
[root@124a4f4fda98 /]# ifconfig
bash: ifconfig: command not found
[root@124a4f4fda98 /]#

进入这个容器内，发现 vim 和 ipconfig 这些命令都是没有的，当初咱们本人在这个centos 镜像上减少一些性能

# 编写 dockerfile 文件
[root@jiangwang home]# mkdir dockerfile
[root@jiangwang home]# ls
dockerfile  f2  f3  jiangwang  test  test.java  www
[root@jiangwang home]# cd dockerfile/
[root@jiangwang dockerfile]# ls
[root@jiangwang dockerfile]# vim mydocker-centos
[root@jiangwang dockerfile]# cat mydocker-centos 
FROM centos                                                                
MAINTAINER jiangwang<360619357@qq.com>

ENV MYPATH /usr/local
WORKDIR $MYPATH

RUN yum -y install vim
RUN yum -y install net-tools

EXPOSE 80

CMD echo $MYPATH
CMD /bin/bash
[root@jiangwang dockerfile]# 

# 2、通过这个文件构建镜像
# 命令 docker build -f 文件门路 -t 镜像名:[tag] .
[root@jiangwang dockerfile]# docker build -f mydocker-centos -t mycentos:0.1 .
.... 省略
Successfully built 02b2cc88ef37
Successfully tagged mycentos:0.1    # 构建胜利

启动这个镜像，再次进入这个容器内，看看 vim 和 ipconfig 这些命令是不是能够应用了

[root@jiangwang dockerfile]# docker images
REPOSITORY            TAG       IMAGE ID       CREATED         SIZE
mycentos              0.1       02b2cc88ef37   5 minutes ago   291MB
tomcat                9.0       040bdb29ab37   8 weeks ago     649MB
tomcat                latest    040bdb29ab37   8 weeks ago     649MB
nginx                 latest    f6d0b4767a6c   8 weeks ago     133MB
centos                latest    300e315adb2f   3 months ago    209MB
portainer/portainer   latest    62771b0b9b09   7 months ago    79.1MB
[root@jiangwang dockerfile]# docker run -it mycentos:0.1
[root@4755f8bdac43 local]# pwd
/usr/local
[root@4755f8bdac43 local]# ifconfig
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 172.17.0.4  netmask 255.255.0.0  broadcast 172.17.255.255
        ether 02:42:ac:11:00:04  txqueuelen 0  (Ethernet)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        loop  txqueuelen 1000  (Local Loopback)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

[root@4755f8bdac43 local]# vim test
[root@4755f8bdac43 local]#

咱们发现，这些命令都能够应用了，阐明咱们增加的性能胜利了。

查看镜像的历史信息

[root@jiangwang /]# docker history 02b2cc88ef37
IMAGE          CREATED          CREATED BY                                      SIZE      COMMENT
02b2cc88ef37   11 minutes ago   /bin/sh -c #(nop)  CMD ["/bin/sh" "-c" "/bin…   0B        
e31ad4ddeaf0   11 minutes ago   /bin/sh -c #(nop)  CMD ["/bin/sh" "-c" "echo…   0B        
c1b0b4277cf0   11 minutes ago   /bin/sh -c #(nop)  EXPOSE 80                    0B        
b51a4c01f846   11 minutes ago   /bin/sh -c yum -y install net-tools             23.3MB    
afc7010897bf   11 minutes ago   /bin/sh -c yum -y install vim                   58MB      
056ee119a21c   12 minutes ago   /bin/sh -c #(nop) WORKDIR /usr/local            0B        
48a552e8da6b   12 minutes ago   /bin/sh -c #(nop)  ENV MYPATH=/usr/local        0B        
9621d7bfb61b   12 minutes ago   /bin/sh -c #(nop)  MAINTAINER jiangwang<3606…   0B        
300e315adb2f   3 months ago     /bin/sh -c #(nop)  CMD ["/bin/bash"]            0B        
<missing>      3 months ago     /bin/sh -c #(nop)  LABEL org.label-schema.sc…   0B        
<missing>      3 months ago     /bin/sh -c #(nop) ADD file:bd7a2aed6ede423b7…   209MB     
[root@jiangwang /]#

二、Dockerfile 制作 Tomcat 镜像

1、筹备镜像文件 tomcat 压缩包和 jdk 压缩包

链接：https://pan.baidu.com/s/1ed1n…
提取码：73s9

2、编写 Dockerfile 文件，官网指定 Dockerfile，build 会主动导入这个文件，就不须要应用 -f 指定了

FROM centos
MAINTAINER jiangwang<360619357@qq.com>

COPY readme.txt /usr/local/readme.txt

ADD jdk-8u161-linux-x64.tar.gz /usr/local/
ADD apache-tomcat-9.0.44.tar.gz /usr/local/

RUN yum -y install vim

ENV MYPATH /usr/local
WORKDIR $MYPATH

ENV JAVA_HOME /usr/local/jdk1.8.0_161
ENV CLASSPATH $JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
ENV CATALINA_HOME /usr/local/apache-tomcat-9.0.44
ENV CATALINA_BASE /usr/local/apache-tomcat-9.0.44
ENV PATH $PATH:$JAVA_HOME/bin:$CATALINA_HOME/lib:$CATALINA_HOME/bin

EXPOSE 8080
CMD /usr/local/apache-tomcat-9.0.44/bin/startup.sh && tail -F /usr/local/apache-tomcat-9.0.44/bin/logs/catalina.out

3、构建镜像

[root@jiangwang tomcat]# docker build -t mytomcat .
Sending build context to Docker daemon  201.2MB
Step 1/15 : FROM centos
 ---> 300e315adb2f
Step 2/15 : MAINTAINER jiangwang<360619357@qq.com>
 ---> Using cache
 ---> 9621d7bfb61b
Step 3/15 : COPY readme.txt /usr/local/readme.txt
 ---> 5e5723ce3ef3
Step 4/15 : ADD jdk-8u161-linux-x64.tar.gz /usr/local/
 ---> e20cd0601bc1
Step 5/15 : ADD apache-tomcat-9.0.44.tar.gz /usr/local/
 ---> b2f54e1ffad0
Step 6/15 : RUN yum -y install vim
 ---> Running in 0b4b4d2df697

Removing intermediate container 7ede7de98513
 ---> 0c80321324a1
Successfully built 0c80321324a1
Successfully tagged mytomcat:latest     # 构建胜利

4、启动镜像（端口映射 挂载一些目录）

[root@jiangwang tomcat]# docker run -d -p 39001:8080 --name jwtomcat -v /home/jiangwang/tomcat/test:/usr/local/apache-tomcat-9.0.44/webapps/test -v /home/jiangwang/tomcat/tomcatlogs/:/usr/local/apache-tomcat-9.0.44/logs mytomcat
9194dbeb2995c314425cf2d9c4776a67122f482d59b068eba4d300ce2661215d

5、内网测试，拜访胜利

[root@jiangwang tomcat]# curl localhost:39001

6、外网测试一下，也是能够的，（外网的端口需开发，不然拜访不了）如下图：

7、咱们到方才挂载 test 的目录下，创立一个简略的我的项目，看看能不能失常运行

新建一个 WEB-INF 目录，而后创立一个 web.xml 文件，接着创立一个 index.jsp 文件

[root@jiangwang tomcat]# ls
apache-tomcat-9.0.44.tar.gz  Dockerfile  jdk-8u161-linux-x64.tar.gz  readme.txt  test  tomcatlogs
[root@jiangwang tomcat]# cd test
[root@jiangwang test]# ls
index.jsp  WEB-INF
[root@jiangwang test]#

web.xml 文件中输出一下内容：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"id="WebApp_ID"version="2.5">

</web-app>

index.jsp 文件的内容输出：

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Tomcat</title>
</head>
<body>
    <h1>
        hello,jiangwang
    </h1>
</body>
</html>

拜访页面，发现我的项目胜利运行

至此，一个 tomcat 镜像胜利的创立胜利。

参考文档

  • Dockerfie 官网文档：https://docs.docker.com/engin…
  • Dockerfile 最佳实际文档：https://docs.docker.com/devel…
  • Docker 官网镜像 Dockerfile：https://github.com/docker-lib…
  • Docker — 从入门到实际
退出移动版