docker入门之dockerfile文件详解

史上最通俗易懂的dockerFile基础知识介绍,轻轻松松从入门到精通

Posted by yishuifengxiao on 2019-03-03

Dockerfile 是用来构建 Docker 镜像的构建文件,是由一系列命令和参数构成的脚本。

编写 dockerFile 的步骤

  1. 编写 DockerFile 文件
  2. 执行 docker build 命令,获得一个自定义的镜像
  3. 执行 docker run ,运行生成的镜像

centos 官方 dockerFile 问价内容如下:

FROM scratch
ADD centos-7-docker.tar.xz /

LABEL org.label-schema.schema-version="1.0" \
org.label-schema.name="CentOS Base Image" \
org.label-schema.vendor="CentOS" \
org.label-schema.license="GPLv2" \
org.label-schema.build-date="20181205"

CMD ["/bin/bash"]

DockerFile 解析过程

一 DockerFile 内容基础知识

  1. 每条保留字指令都必须为大写字母且后面要跟随至少一个参数
  2. 指令按照从上到下,顺序执行
  3. #表示注释
  4. 每条指令都会创建一个新的镜像层,并对镜像进行提交

1.1 Docker 执行 Dockerfile 的大致流程

  1. docker 从基础镜像运行一个容器
  2. 执行一条指令并对容器作出修改
  3. 执行类似 docker commit 的操作提交一个新的镜像层
  4. docker 再基于刚提交的镜像运行一个新容器
  5. 执行 dockerfile 中的下一条指令直到所有指令都执行完成

从应用软件的角度来看,Dockerfile、Docker 镜像与 Docker 容器分别代表软件的三个不同阶段,

  • Dockerfile 是软件的原材料

  • Docker 镜像是软件的交付品

  • Docker 容器则可以认为是软件的运行态。

Dockerfile 面向开发,Docker 镜像成为交付标准,Docker 容器则涉及部署与运维,三者缺一不可,合力充当 Docker 体系的基石。

1 Dockerfile,需要定义一个 Dockerfile,Dockerfile 定义了进程需要的一切东西。Dockerfile 涉及的内容包括执行代码或者是文件、环境变量、依赖包、运行时环境、动态链接库、操作系统的发行版、服务进程和内核进程(当应用进程需要和系统服务和内核进程打交道,这时需要考虑如何设计 namespace 的权限控制)等等;

2 Docker 镜像,在用 Dockerfile 定义一个文件之后,docker build 时会产生一个 Docker 镜像,当运行 Docker 镜像时,会真正开始提供服务;

3 Docker 容器,容器是直接提供服务的。

1.2 docker 的体系结构

FROM :       基础镜像,当前新镜像是基于哪个镜像的
MAINTAINER : 镜像维护者的姓名和邮箱地址
RUN: 容器构建时需要运行的命令
EXPOSE: 当前容器对外暴露出的端口
WORKDIR: 指定在创建容器后,终端默认登陆的进来工作目录,一个落脚点
ENV: 用来在构建镜像过程中设置环境变量
ADD: 将宿主机目录下的文件拷贝进镜像且ADD命令会自动处理URL和解压tar压缩包
COPY: 类似ADD,拷贝文件和目录到镜像中。将从构建上下文目录中 <源路径> 的文件/目录复制到新的一层的镜像内的 <目标路径> 位置(COPY src dest 或者 COPY ["src","dest"])
VOLUME: 容器数据卷,用于数据保存和持久化工作
CMD: 指定一个容器启动时要运行的命令,Dockerfile 中可以有多个 CMD 指令,但只有最后一个生效,CMD 会被 docker run 之后的参数替换
ENTRYPOINT​: 指定一个容器启动时要运行的命令,ENTRYPOINT的目的和 CMD 一样,都是在指定容器启动程序及参数
ONBUILD: 当构建一个被继承的Dockerfile时运行命令,父镜像在被子继承后父镜像的onbuild被触发

注意

ENV MY_PATH /usr/mytest

这个环境变量可以在后续的任何 RUN 指令中使用,这就如同在命令前面指定了环境变量前缀一样;

也可以在其它指令中直接使用这些环境变量,

比如:WORKDIR $MY_PATH


二 DockerFile 案例详解

Base 镜像(scratch) : Docker Hub 中 99% 的镜像都是通过在 base 镜像中安装和配置需要的软件构建出来的

2.1 自定义 centos

2.1.1. 编写 DockerFile 文件

先查看官方文件,得知,自定义镜像具备以下情况

     登陆后的默认路径
     vim编辑器
     查看网络配置ifconfig支持

编写好自定义的 DockerFile 文件,内容如下

FROM centos
MAINTAINER yishui<zhiyubujian@163.com>

ENV MYPATH /usr/local
WORKDIR $MYPATH

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

EXPOSE 80

CMD echo $MYPATH
CMD echo "success--------------ok"
CMD /bin/bash

2.1.2. 构建 Docker 镜像

docker build -t 新镜像的名字:TAG .

注意 上述命令最后的 点 表示的是当前路径

具体的命令如下:

docker build -f /demo/myDockerFile -t mycentos/centos:1.0 .

2.1.3. 使用 docker images 命令查询是否构建成功

2.1.4. 运行构建的镜像

docker run -it mycentos/centos:1.0

2.1.5. 列出镜像的变更历史

docker history 镜像名


2.2 CMD/ENTRYPOINT 镜像案例

命令相同点:

  • 都是指定一个容器启动时要运行的命令

命令不同点:

CMD 命令

  • Dockerfile 中可以有多个 CMD 指令,但只有最后一个生效,CMD 会被 docker run 之后的参数替换
    例如我们在启动 tomcat 镜像时,执行一下命令

docker run -it -p 8888:8080 tomcat ls -l

上述命令会覆盖 tomcat 的 dockerFile 文件最后的启动定义命令

CMD [“catalina.sh”, “run”]

因此会导致 tomcat 的 Docker 镜像无法启动里面的 tomcat

ENTRYPOINT 命令

  • docker run 之后的参数会被当做参数传递给 ENTRYPOINT,之后形成新的命令组合

    例如 制作一个查询 IP 的镜像

    DockerFile 文件的定义如下:


FROM centos
RUN yum install -y curl
CMD [ "curl", "-s", "http://ip.cn" ]

如果我们希望显示 HTTP 头信息,就需要运行改容器镜像时加上 -i 参数

我们可以看到可执行文件找不到的报错,executable file not found。

之前我们说过,跟在镜像名后面的是 command,运行时会替换 CMD 的默认值。

因此这里的 -i 替换了原来的 CMD,而不是添加在原来的 curl -s http://ip.cn 后面。而 -i 根本不是命令,所以自然找不到。

那么如果我们希望加入 -i 这参数,可以将 CMD 替换为

新的 DockerFIle 文件的定义如下:

FROM centos

RUN yum install -y curl

ENTRYPOINT [ "curl", "-s", "http://ip.cn" ]

此时,重新完整的输入这个命令:

$ docker run myip curl -s http://ip.cn -i

可以看到,输出了想要的结果信息


2.3 ONBUILD 命令详解

制作一个包含 onbuild 的镜像,其 DockerFIle 文件内容如下:

FROM centos

RUN yum install -y curl

ENTRYPOINT [ "curl", "-s", "http://ip.cn" ]

ONBUILD run echo "我被继承了"

2.4 自定义 tomcat

  1. 在/docker_images 目录下创建一个名为 c.txt 的文本文件

  2. 将 tomcat 和 jdk 的安装包拷贝到上述目录

  3. 在该目录下创建一个 DockerFIle 文件

    DockerFIle 文件内容如下:

FROM         centos
MAINTAINER yishui<zhiyubujian@163.com>
#把宿主机当前上下文的c.txt拷贝到容器/usr/local/路径下
COPY c.txt /usr/local/cincontainer.txt
#把java与tomcat添加到容器中,并解压
ADD jdk-8u144-linux-x64.tar.gz /usr/local/
ADD apache-tomcat-9.0.16.tar.gz /usr/local/
#安装vim编辑器
RUN yum -y install vim
#设置工作访问时候的WORKDIR路径,登录落脚点
ENV MYPATH /usr/local
WORKDIR $MYPATH
#配置java与tomcat环境变量
ENV JAVA_HOME /usr/local/jdk1.8.0_144
ENV CLASSPATH $JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
ENV CATALINA_HOME /usr/local/apache-tomcat-9.0.16
ENV CATALINA_BASE /usr/local/apache-tomcat-9.0.16
ENV PATH $PATH:$JAVA_HOME/bin:$CATALINA_HOME/lib:$CATALINA_HOME/bin
#容器运行时监听的端口
EXPOSE 8080
#启动时运行tomcat
# ENTRYPOINT ["/usr/local/apache-tomcat-9.0.16/bin/startup.sh" ]
# CMD ["/usr/local/apache-tomcat-9.0.16/bin/catalina.sh","run"]
CMD /usr/local/apache-tomcat-9.0.16/bin/startup.sh && tail -F /usr/local/apache-tomcat-9.0.16/bin/logs/catalina.out

此时,文件的目录内容如下:

yishui@yishui:~/桌面/docker_images$ pwd
/home/yishui/桌面/docker_images
yishui@yishui:~/桌面/docker_images$ ls
apache-tomcat-9.0.16.tar.gz  Dockerfile    jdk-8u144-linux-x64.tar.gz
c.txt                        jdk1.8.0_144
yishui@yishui:~/桌面/docker_images$ 

2.5. 构建自定义镜像

2.5.1 构建命令如下:

docker build -t yishui_tomcat .

或者

docker build -f Dockerfile -t yishui_tomcat .

注意: 因为这里 DockerFile 文件的名字为 Dockerfile,所以可以的省略-f 命令

执行命令,得到的结果如下:

yishui@yishui:~/桌面/docker_images$ docker build -t yishui_tomcat
"docker build" requires exactly 1 argument.
See 'docker build --help'.

Usage:  docker build [OPTIONS] PATH | URL | -

Build an image from a Dockerfile
yishui@yishui:~/桌面/docker_images$ docker build -t yishui_tomcat .
Sending build context to Docker daemon  573.8MB
Step 1/15 : FROM         centos
 ---> 1e1148e4cc2c
Step 2/15 : MAINTAINER    yishui<zhiyubujian@163.com>

注意 命令的最后一个点,一定要加,否则会出问题

2.5.2 查看是否有镜像生成

yishui@yishui:~/桌面/docker_images$ docker images
REPOSITORY           TAG                 IMAGE ID            CREATED             SIZE
yishui_tomcat        latest              b359862a31e7        2 minutes ago       726MB
yishui/tomcat-demo   1.0                 1323b27a2652        2 days ago          463MB
<none>               <none>              7cfe70fc34b0        2 days ago          463MB
tomcat               latest              168588387c68        3 weeks ago         463MB
centos               latest              1e1148e4cc2c        2 months ago        202MB

2.5.3 运行构建的镜像

yishui@yishui:~/桌面/docker_images$ docker run -it -p 8000:8080 b359862a31e7
Using CATALINA_BASE:   /usr/local/apache-tomcat-9.0.16
Using CATALINA_HOME:   /usr/local/apache-tomcat-9.0.16
Using CATALINA_TMPDIR: /usr/local/apache-tomcat-9.0.16/temp
Using JRE_HOME:        /usr/local/jdk1.8.0_144
Using CLASSPATH:       /usr/local/apache-tomcat-9.0.16/bin/bootstrap.jar:/usr/local/apache-tomcat-9.0.16/bin/tomcat-juli.jar
Tomcat started.
tail: cannot open '/usr/local/apache-tomcat-9.0.8/bin/logs/catalina.out' for reading: No such file or directory
tail: cannot watch parent directory of '/usr/local/apache-tomcat-9.0.8/bin/logs/catalina.out': No such file or directory
tail: inotify cannot be used, reverting to polling

通过http://localhost:8000/ 访问,发现可以看到 tomcat 管理界面,镜像构建成功

或者运行以下命令

docker run -d -p 9080:8080 --name myt9 -v /demo/tomcat9/test:/usr/local/apache-tomcat-9.0.16/webapps/test -v /demo/tomcat9/tomcat9logs/:/usr/local/apache-tomcat-9.0.16/logs --privileged=true b359862a31e7

注意     -v   该命令表示挂载容器卷

Docker 挂载主机目录 Docker 访问出现 cannot open directory .: Permission denied

解决办法:在挂载目录后多加一个–privileged=true 参数即可