Docker(五) Dockerfile

Dockerfile

镜像相关的操作

  • 镜像生成的途径

    • Dockerfile

    • 基于容器制作docker commit

image.png

定义

  • 构建docker镜像的源码

    • docker可以根据Dockerfile中的指令进行镜像的自动构建

    • Dockerfile是一个包含了一个用户可以调用的命令行去组织一个镜像

    • 通过docker build命令可以将一些用户可调用的命令行指令去构建对应的镜像

image.png

构建Dockerfile的注意事项

  • 必须有一个工作目录放Dockerfile文件与附文件

  • Dockerfile文件名必须是Dockerfile

Dockerfile的格式

  • 包含的信息：

    • 注释

    • 指令： 所有指令一般都是大写；是一个资源清单；没有复杂的判断语法等

指令

  • FROM

    • 是Dockerfile最重要的一个且必须为文件开篇第一个非注释行，用于为镜像文件构建过程中指定基础镜像，后续的指令运行于此基准镜像所提供的运行环境

    • 实践中，基准竟想可以是任何可用镜像文件，默认情况下，docker build会在docker主机上查找指定的镜像文件，若本机不存在则去dockerHub拉取

    • 语法：

      • FROM <repository>[:tag]： repostory是镜像仓库名称，tag是镜像的标签，如不指定，默认是latest

      • FROM <repository>@<digist>：digest是镜像的ID（校验码）

  • MAINTAINER

    • 用于指定Dockerfile的维护者信息，目前已经被废弃

    • 出现的位置推荐在FROM的下一行

    • 语法：

      • MAINTAINER "wanghui <wanghui@tencent.com>"

  • LABEL

    • 代替MAINTAINER指令，可以定义镜像的额外信息，可以定义多个信息

    • 镜像的元信息（metadata）

    • 语法：

      • LABEL <key>=<value> <key1>=<value1>

  • COPY

    • 用于从docker宿主机拷贝文件到镜像的可写层

    • 拷贝的原路径必须是我们的工作目录

    • 语法：支持多个源地址

      • COPY <src>... <dest>

      • COPY ["<src>",...,"<dest>"]：路径中由空白字符时，使用此格式

    • 注意事项

      • src必须是build上下文中的路径，不能是父路径中的文件

      • 如果src是目录，则其内部的子文件或者子目录会被递归复制，但是src目录自身不会被复制

      • 如果指定了多个src，或者在src后面使用了通配符，则dest必须是一个目录且必须以/结尾

      • 如果dest事先不存在，其将会被自动创建


[root@centos7-node1 ~]# mkdir /data/build_workshop -p

[root@centos7-node1 ~]# cd /data/build_workshop/

[root@centos7-node1 build_workshop]# echo "<h1>this is a test page</h1>" > index.html

[root@centos7-node1 ~]# cd /data/build_workshop/

[root@centos7-node1 build_workshop]# vim Dockerfile         

FROM busybox:latest

LABEL maintainer="wanghui<wanghui@yeecall.com>"

COPY index.html /data/web/html/

[root@centos7-node1 build_workshop]# docker build . -t myimg:v0.1

[root@centos7-node1 build_workshop]# docker run --name t1 --rm -it myimg:v0.1 /bin/sh

/ # ls /data/web/html/

index.html

[root@centos7-node1 build_workshop]# mkdir /data/build_workshop/pages/

[root@centos7-node1 build_workshop]# mv /data/build_workshop/index.html /data/build_workshop/pages/

[root@centos7-node1 build_workshop]# echo "<h1>test1 page</h1>" >  /data/build_workshop/pages/test1.html

[root@centos7-node1 build_workshop]# echo "<h1>test2 page</h1>" >  /data/build_workshop/pages/test2.html 

[root@centos7-node1 build_workshop]# vim /data/build_workshop/.dockerignore    #忽略拷贝文件

pages/test2.html

[root@centos7-node1 build_workshop]# vim /data/build_workshop/Dockerfile 

FROM busybox:latest

LABEL maintainer="wanghui<wanghui@yeecall.com>"

COPY pages/*.html /data/web/html/

[root@centos7-node1 build_workshop]# docker build . -t myimg:v0.2

[root@centos7-node1 build_workshop]# docker run --name t1 --rm -it myimg:v0.2 /bin/sh   #验证

/ # ls /data/web/html/

index.html  test1.html

  • ADD

    • ADD类似于COPY指令，ADD支持tar文件和url路径

    • 语法：

      • ADD <src>... <dest>

      • ADD ["<src>","...","<dest>"]

    • 操作准则

      • 同COPY指令

      • 如果src为URL地址且dest不以/结尾，则src指定的文件警备下载并直接创建为dest

      • 如果dest以/结尾，则文件名URL指定的文件会被下载保存为dest/filename

      • 如果src是本地上传的一个压缩格式的tar文件，它将被展开为一个目录，其行为类似与tar -x命令，然而URL获取的他人文件不会被自动展开

      • 如果src有多个，或期间使用了通配符，则dest必须是一个以/结尾的目录路径

      • 如果dest不以/结尾，则被视为一个普通文件，src的内容将被写入到dest


[root@centos7-node1 ~]# mkdir /data/build_workshop/add_example

[root@centos7-node1 ~]# cd /data/build_workshop/add_example

[root@centos7-node1 add_example]# wget http://nginx.org/download/nginx-1.16.1.tar.gz

[root@centos7-node1 add_example]# vim Dockerfile

FROM  busybox:latest

LABEL maintainer="wanghui <wanghui@yeecall.com>"

ADD http://nginx.org/download/nginx-1.18.0.tar.gz /data/

ADD nginx-1.16.1.tar.gz /data/

[root@centos7-node1 add_example]# docker run --name t1 --rm -it myimg:v0.3 /bin/sh

/ # ls /data/

nginx-1.16.1         nginx-1.18.0.tar.gz

  • WORKDIR

    • 用于指定Dockerfile中所有的RUN，CMD，ENTRYPOINT,COPY,ADD指定设定工作目录

    • 语法：

      • WORKDIR /var/log

      • WORKDIR $STATEPATH: 可以引用环境变量，结合ENV使用

    • 注意事项： 可以使用多个WORKDIR，最终用最新的WORKDIR


[root@centos7-node1 ~]# cd /data/build_workshop/

[root@centos7-node1 build_workshop]# cp add_example/ worksdir_example -r  && cd  worksdir_example

[root@centos7-node1 worksdir_example]# vim Dockerfile 

ADD http://nginx.org/download/nginx-1.18.0.tar.gz /data/

FROM  busybox:latest

LABEL maintainer="wanghui <wanghui@yeecall.com>"

WORKDIR  /usr/

ADD nginx-1.16.1.tar.gz src/

[root@centos7-node1 worksdir_example]# docker build . -t myimg:v0.4

[root@centos7-node1 worksdir_example]# docker run --name t1 --rm -it  myimg:v0.4 /bin/sh

/usr # ls src/nginx-1.16.1/

  • VOLUME

    • 用于在image中创建一个挂载点目录，以挂载上docker host上的卷或者其他容器上的卷

    • 语法：

      • VOLUME <mountpoint>

      • VOLUME ["<mountpoint>"]

    • 注意：

      • 如果挂载点目录路径下此前文件存在，docker run命令会在卷挂载完成后将此前的所有文件复制到新的挂载卷中

[root@centos7-node1 build_workshop]# mkdir /data/build_workshop/volumes_example/pages/

[root@centos7-node1 build_workshop]# cd /data/build_workshop/volumes_example

[root@centos7-node1 volumes_example]# echo "<h1>test1 page</h1>" >  /data/build_workshop/volumes_example/pages/test1.html

[root@centos7-node1 volumes_example]# echo "<h1>test2 page</h1>" > /data/build_workshop/volumes_example/pages/test2.html 

[root@centos7-node1 volumes_example]# vim Dockerfile 

FROM busybox:latest

LABEL maintainer="wanghui<wanghui@yeecall.com>"

COPY pages/*.html /data/web/html/

ADD   http://nginx.org/download/nginx-1.15.8.tar.gz /tmp/

WORKDIR /usr/

VOLUME /data/web/html/

[root@centos7-node1 volumes_example]# docker build . -t myimg:v0.5

[root@centos7-node1 volumes_example]# docker run --name t1 -it --rm myimg:v0.5 /bin/sh

/usr # cd /data/web/html/

/data/web/html # ls

index.html  test1.html  test2.html

[root@centos7-node1 ~]# docker inspect -f {{.Mounts}} t1     #另起窗口，找到Source，发现Source映射目录的内容与容器中的一样[随机存储卷]

  • EXPOSE

    • 用于为容器打开制定监听的端口，以实现与外部通信

    • 语法：

      • EXPOSE <port>[/<protocol>] ...： 指定端口和协议

    • 注意事项：

      • EXPOSE 11211/udp 11211/tcp：一次指定多个端口

FROM busybox:latest

LABEL maintainer="wanghui<wanghui@yeecall.com>"

COPY pages/*.html /data/web/html/

ADD   http://nginx.org/download/nginx-1.15.8.tar.gz /tmp/

WORKDIR /usr/

VOLUME /data/web/html/

EXPOSE 80/tcp

[root@centos7-node1 expose_example]# docker build . -t myimg:v0.6

[root@centos7-node1 volumes_example]# docker run --name t1 -it -P --rm myimg:v0.6 /bin/sh

/usr # httpd -f -h /data/web/html/    #启动httpd服务

[root@centos7-node1 expose_example]# docker port t1   #查看映射，然后访问即可

  • ENV

    • 用与定义所需要的环境变量，并可以被Dockerfile文件中位于其后的其他指令（如ENV,ADD,COPY等）所调用

    • 调用格式为 $variable_name或${variable_name}

    • 在build阶段使用的

    • 语法：

      • ENV <key> <value>： 一次只能设置一个变量

      • ENV <key>=<value>： 一次可以设置多个变量，特数字答复需要使用\转义[推荐使用]


FROM busybox:latest

ENV webhome="/data/web/html/"

LABEL maintainer="wanghui<wanghui@yeecall.com>"

COPY pages/*.html ${webhome}

ADD http://nginx.org/download/nginx-1.15.8.tar.gz ${webhome}

WORKDIR ${webhome}

ADD nginx-1.16.1.tar.gz ./

VOLUME  ${webhome}

EXPOSE 80/tcp

[root@centos7-node1 env_example]# docker build . -t myimg:v0.7

  • ARG

    • 定义变量，可以在build阶段传值，替换dockerfile中的值

    • 语法：

      • ARG <name>=[default]

    • 注意：

      • 支持docker1.14及其以上的版本

      • 推荐使用ARG


FROM busybox:latest

ARG webhome="/data/web/html/"

LABEL maintainer="wanghui<wanghui@yeecall.com>"

COPY pages/*.html ${webhome}

ADD http://nginx.org/download/nginx-1.15.8.tar.gz ${webhome}

WORKDIR ${webhome}

ADD nginx-1.16.1.tar.gz ./

VOLUME  ${webhome}

EXPOSE 80/tcp

[root@centos7-node1 arg_example]# docker build . -t myimg:v0.8     #正常不加参数的编译，使用的是默认的参数

[root@centos7-node1 arg_example]# docker build --build-arg webhome="/webdata/htdocs/" . -t myimg:v0.8   #加入参数的编译

[root@centos7-node1 arg_example]# docker run --name t1 -it --rm myimg:v0.8 /bin/sh   #结果测试

  • RUN

    • 用于指定docker build过程中运行程序，其可以是任何命令

    • 语法：

      • RUN <command>：command通常是一个shell命令，且以/bin/sh -c来运行它， 这意味着此进程在容器中的PID不为1，不能接受Unix信号，因此，当使用docker stop <container>停止容器时，此进程接收不到SIGTERM信号

      • RUN ["<executable>","param1","param2"]：参数是一个json格式的数组，其中excutable是要运行的命令，后面的param是要传递给命令的选项或者参数，然而此种格式的参数不会以/bin/sh -c来发起，因此常见的shell操作，如变量替换以及通配符操作将不会进行，不过，如果要运行依赖此shell特性的话，可以将其替换成如下的格式： RUN ["bin/sh","-c","<executable>","<param1>"]

    • 注意： 执行的命令必须是FROM拉取镜像中可以执行的；

    • 实例1


FROM busybox:latest

ARG webhome="/data/web/html/"

LABEL maintainer="wanghui<wanghui@yeecall.com>"

COPY pages/*.html ${webhome}

ADD http://nginx.org/download/nginx-1.15.8.tar.gz ${webhome}

WORKDIR ${webhome}

ADD nginx-1.16.1.tar.gz ./

VOLUME  ${webhome}

EXPOSE 80/tcp

RUN  mkdir -p /web/bbs && \

     ["/bin/sh","-c","echo helle >> /web/bbs/index.html"]

[root@centos7-node1 run_example]# docker build . -t myimg:v0.9


- 实例2


FROM centos:7

LABEL maintainer="wanghui <122725501@qq.com>"

ARG  docroot=/var/www/html/

RUN yum makecache && \

    yum -y install httpd php php-mysql && \

    yum clean all && \

    rm -fr /var/cache/yum/*

[root@centos7-node1 ap]# docker run --name web1 --rm -it php-httpd:v0.1 bash

  • CMD

    • 运行在docker run阶段，用于容器中运行命令或者应用程序

      • RUN指令运行于镜像的构建过程中，而CMD的运行是基于Dockerfile构建出的新镜像文件启动一个容器时

      • CMD指令首要目的在于为溶洞的容器指定默认要运行的程序，且其运行结束后容器也将终止，不过，CMD指令的命令可以被docker run的命令行所覆盖

      • 在Dockerfile中可以存在多个CMD命令，但仅最后一个生效

    • 语法：

      • CMD <command>

      • CMD ["<executable>","param1","param2"]

      • CMD ["param1","param2"]： 用于为ENTRYPOINT提供默认参数


FROM centos:7

LABEL maintainer="wanghui <122725501@qq.com>"

ARG  docroot=/var/www/html/

RUN yum makecache && \

    yum -y install httpd php php-mysql && \

    yum clean all && \

    rm -fr /var/cache/yum/*

CMD ["/usr/sbin/httpd","-DFOREGROUND"]

[root@centos7-node1 ap]# docker build . -t php-httpd:v0.2

[root@centos7-node1 ap]# docker run --name web1 --rm  php-httpd:v0.2 

[root@centos7-node1 ap]# docker ps -a

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES

[root@centos7-node1 ap]# docker run --name web1 -it php-httpd:v0.2 /bin/bash

[root@47818a3ba906 /]# ps -ef    #httpd被覆盖了

UID         PID   PPID  C STIME TTY          TIME CMD

root          1      0  1 09:41 pts/0    00:00:00 /bin/bash

  • ENTRYPOINT

    • 类似CMD指令的功能，用于为容器指定默认的运行程序，从而使容器像是一个独立的可执行程序

      • 与CMD不同的是，由ENTRYPOINT启动的程序不会被docker run命令指定的参数所覆盖，而且这些命令行参数被当做传递给ENTRYPOINT指定的程序

      • 不过，docker run命令的--entrypoint选项参数可以覆盖ENTRYPOINT指定的程序

    • 语法：

      • ENTRYPOINT <command>

      • ENTRYPOINT ["<executable>","param1","param2"]

    • 注意事项

      • docker run 命令传入的参数会覆盖CMD指令的内容并且附加到ENTRYPOINT命令的最后作为其参数使用

      • Dockerfile存在多个ENTRYPOINT指令，但仅有最后一个会生效


[root@centos7-node1 ap]# tree ./

./

├── Dockerfile

├── entrypoint.sh

├── ok.html

└── phpinfo.php

[root@centos7-node1 ap]# cat Dockerfile 

FROM centos:7

LABEL maintainer="wanghui <122725501@qq.com>"

ARG  docroot=/var/www/html/

RUN yum makecache && \

    yum -y install curl httpd php php-mysql && \

    yum clean all && \

    rm -fr /var/cache/yum/*

ADD ok.html phpinfo.php ${docroot}

ADD entrypoint.sh /bin/

EXPOSE 80/tcp

VOLUME ${docroot}

HEALTHCHECK --interval=3s --timeout=3s --start-period=2s CMD curl -f http://localhost/ok.html || exit 1

CMD ["/usr/sbin/httpd","-DFOREGROUND"]

ENTRYPOINT ["/bin/entrypoint.sh"]

[root@centos7-node1 ap]# cat entrypoint.sh 

#!/bin/bash

listen_port=${LISTEN_PORT:-80}

server_name=${SERVER_NAME:-localhost}

doc_root=${DOC_ROOT:-/var/www/html/}

cat > /etc/httpd/conf.d/myweb.conf <<EOF

#LISTEN $listen_port

<VirtualHost *:${listen_port}>

    ServerName  "$server_name"

    DocumentRoot  "$doc_root"

    <Directory "$doc_root">

       Options  none

       AllowOverride none

       Require all granted

    </Directory>

</VirtualHost>

EOF

exec "$@"

Dockerfile  entrypoint.sh  ok.html  phpinfo.php

[root@centos7-node1 ap]# cat ok.html 

OK

[root@centos7-node1 ap]# cat phpinfo.php 

<?php

  phpinfo();

?>

  • USER

    • 用于指定image运行时任何RUN，CMD，ENTRYPOINT指令指定程序运行的用户名或者UID

    • 默认情况下USER是root

    • 语法：

      USAER <uid>|username

      • 注意：

        • 用户必须是存在与/etc/passwd中的有效用户，否则容器会运行失败

  • HEALTHCHECK

    • 检测容器是否正常运行

    • 语法：

      • HEALTHCHECK CMD command：检查容器内的服务是否运行正常

      • HEALTHCHECK none：不需要健康检查

    • 注意事项：

      --interval ： 检查周期，默认30s

      --timeout：等待超时，默认30s

      --start-period： 开始检测的时间，默认是0s

      --retries：重试次数

  • ONBUILD

    • 用于在Dockerfile中定义触发器，延迟运行

       - Dockerfile用于build镜像文件，此镜像文件也也可以作为base image被另外的一个Dockerfile用作FROM指令参数，并以次构建新的镜像

  - 在后面的Dockerfile中的FROM指令在build过程中被执行时，会触发创建其base image的Dockerfile文件中的ONBUILD指令定义的触发器

    • 语法：

      • ONBUILD <INSTRUCTION>

    • 注意事项

      • 尽管任何指令都可以注册成为触发器指令，但是ONBUILD不能自我嵌套，且不会出发FROM和MAINTAINER指令

      • 在ONBUILD指令中使用ADD和COPY要格外小心，因为新构建过程中的上下文在缺少指定的原文件时会失败


[root@centos7-node1 ~]# cd /data/build_workshop/

[root@centos7-node1 build_workshop]# mkdir testimg/ myicme/ -p

[root@centos7-node1 build_workshop]# vim testimg/Dockerfile 

FROM busybox:latest

LABEL maintainer="wanghui <122725501@qq.com>"

RUN mkdir -p /data/web/html

ONBUILD ADD http://nginx.org/download/nginx-1.18.0.tar.gz /usr/src

[root@centos7-node1 build_workshop]# docker build ./testimg/  -t testimg:v0.1   # 构建testing:v0.1

[root@centos7-node1 build_workshop]# vim myicme/Dockerfile

FROM  testimg:v0.1

LABEL from="testimg:v0.1

[root@centos7-node1 build_workshop]# docker build ./myicme/ -t myicme:v0.1   #此时构建才会执行下载testing:v0.1

Sending build context to Docker daemon  2.048kB

Step 1/2 : FROM  testimg:v0.1

# Executing 1 build trigger

Downloading [==>                                                ]  47.73kB/1.04MB
  • 镜像临时导入导出

[root@centos7-node1 ~]# docker image save php-httpd:v0.6 -o php-httpd.tar

[root@centos7-node1 ~]# docker image load -i php-httpd.tar

[root@centos7-node1 ~]# docker history php-httpd:v0.6   #构建历史查看
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 205,033评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,725评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,473评论 0赞 338
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,846评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,848评论 5赞 368
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,691评论 1赞 282
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,053评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,700评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 42,856评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,676评论 2赞 323
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,787评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,430评论 4赞 321
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,034评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,990评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,218评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,174评论 2赞 352
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,526评论 2赞 343