详解Dockerfile创建自定义Docker镜像以及CMD与ENTRYPOINT指令的比较
1.概述
创建Docker镜像的方式有三种
- dockercommit命令：由容器生成镜像；
- Dockerfile文件+dockerbuild命令；
- 从本地文件系统导入：OpenVZ的模板。
关于这三种方式的大致说明请参考yeasy/docker_practice的创建镜像。
最近学习了Dockerfile文件的相关配置，这里做一下简单的总结，并对之前一直感到有些迷惑的CMD和ENTRYPOINT指令做个差异对比。
2.Dockerfile文件总结
Dockerfile由一行行命令语句组成，并且支持以#开头的注释行。
一般地，Dockerfile分为四部分：基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令。
|
四部分 |
指令 |
|
基础镜像信息 |
FROM |
|
维护者信息 |
MAINTAINER |
|
镜像操作指令 |
RUN、COPY、ADD、EXPOSE等 |
|
容器启动时执行指令 |
CMD、ENTRYPOINT |
Dockerfile文件的第一条指令必须是FROM，其后可以是各种镜像的操作指令，最后是CMD或ENTRYPOINT指定容器启动时执行的命令。
下面引用yeasy/docker_practice对Dockerfile中各个指令的介绍，
指令
指令的一般格式为INSTRUCTIONarguments，指令包括FROM、MAINTAINER、RUN等。
FROM
格式为FROM
第一条指令必须为FROM指令。并且，如果在同一个Dockerfile中创建多个镜像时，可以使用多个FROM指令（每个镜像一次）。
MAINTAINER
格式为MAINTAINER
RUN
格式为RUN
前者将在shell终端中运行命令，即/bin/sh-c；后者则使用exec执行。指定使用其它终端可以通过第二种方式实现，例如RUN["/bin/bash","-c","echohello"]。
每条RUN指令将在当前镜像基础上执行指定命令，并提交为新的镜像。当命令较长时可以使用\来换行。
CMD
支持三种格式
CMD["executable","param1","param2"]使用exec执行，推荐方式；
CMDcommandparam1param2在/bin/sh中执行，提供给需要交互的应用；
CMD["param1","param2"]提供给ENTRYPOINT的默认参数；
指定启动容器时执行的命令，每个Dockerfile只能有一条CMD命令。如果指定了多条命令，只有最后一条会被执行。
如果用户启动容器时候指定了运行的命令，则会覆盖掉CMD指定的命令。
EXPOSE
格式为EXPOSE
告诉Docker服务端容器暴露的端口号，供互联系统使用。在启动容器时需要通过-P，Docker主机会自动分配一个端口转发到指定的端口。
ENV
格式为ENV
例如
ENVPG_MAJOR9.3
ENVPG_VERSION9.3.4
RUNcurl-SLhttp://example.com/postgres-$PG_VERSION.tar.xz|tar-xJC/usr/src/postgress&&…
ENVPATH/usr/local/postgres-$PG_MAJOR/bin:$PATH
ADD
格式为ADD
该命令将复制指定的
COPY
格式为COPY
复制本地主机的
当使用本地目录为源目录时，推荐使用COPY。
ENTRYPOINT
两种格式：
ENTRYPOINT["executable","param1","param2"]
ENTRYPOINTcommandparam1param2（shell中执行）。
配置容器启动后执行的命令，并且不可被dockerrun提供的参数覆盖。
每个Dockerfile中只能有一个ENTRYPOINT，当指定多个时，只有最后一个起效。
VOLUME
格式为VOLUME["/data"]。
创建一个可以从本地主机或其他容器挂载的挂载点，一般用来存放数据库和需要保持的数据等。
USER
格式为USERdaemon。
指定运行容器时的用户名或UID，后续的RUN也会使用指定用户。
当服务不需要管理员权限时，可以通过该命令指定运行用户。并且可以在之前创建所需要的用户，例如：RUNgroupadd-rpostgres&&useradd-r-gpostgrespostgres。要临时获取管理员权限可以使用gosu，而不推荐sudo。
WORKDIR
格式为WORKDIR/path/to/workdir。
为后续的RUN、CMD、ENTRYPOINT指令配置工作目录。
可以使用多个WORKDIR指令，后续命令如果参数是相对路径，则会基于之前命令指定的路径。例如
WORKDIR/a
WORKDIRb
WORKDIRc
RUNpwd
则最终路径为/a/b/c。
ONBUILD
格式为ONBUILD[INSTRUCTION]。
配置当所创建的镜像作为其它新创建镜像的基础镜像时，所执行的操作指令。
例如，Dockerfile使用如下的内容创建了镜像image-A。
[...]
ONBUILDADD./app/src
ONBUILDRUN/usr/local/bin/python-build--dir/app/src
[...]
如果基于image-A创建新的镜像时，新的Dockerfile中使用FROMimage-A指定基础镜像时，会自动执行ONBUILD指令内容，等价于在后面添加了两条指令。
FROMimage-A#AutomaticallyrunthefollowingADD./app/srcRUN/usr/local/bin/python-build--dir/app/src
使用ONBUILD指令的镜像，推荐在标签中注明，例如ruby:1.9-onbuild。
3.创建镜像
编写完Dockerfile文件后，通过运行dockerbuild命令来创建自定义的镜像。Dockerbuild命令格式如下：
dockerbuild[options]
该命令将读取指定路径下（包括子目录）的Dockerfile，并将该路径下所有内容发送给Docker服务端，由服务端来创建镜像。因此一般建议放置Dockerfile的目录为空目录。也可以通过.dockerignore文件（每一行添加一条匹配模式）来让Docker忽略路径下的目录和文件。
例如下面使用Dockerfile样例来创建了镜像test:0.0.1，其中-t选项用来指定镜像的tag。Dockerfile文件内容如下：
FROMubuntu:14.04 MAINTAINERlienhua34@xxx.com RUNmkdir/opt/leh RUNtouch/opt/leh/test CMDecho"Hellolienhua34"
下面运行dockerbuild命令生成镜像test:0.0.1，
lienhua34@test$sudodockerbuild-ttest:0.0.1. SendingbuildcontexttoDockerdaemon3.072kB Step1:FROMubuntu:14.04 --->a5a467fddcb8 Step2:MAINTAINERlienhua34@163.com --->Runningince9e7b02f075 --->332259a92e74 Removingintermediatecontainerce9e7b02f075 Step3:RUNmkdir/opt/leh --->Runningine93f0a98040f --->097e177cf37f Removingintermediatecontainere93f0a98040f Step4:RUNtouch/opt/leh/test --->Runninginf1531d3dea1a --->0f68852f8356 Removingintermediatecontainerf1531d3dea1a Step5:CMDecho"Hellolienhua34" --->Runningincf3c5ce2af46 --->811ce27ce692 Removingintermediatecontainercf3c5ce2af46 Successfullybuilt811ce27ce692
然后启动该镜像的容器来查看结果，
lienhua34@test$sudodockerimages REPOSITORYTAGIMAGEIDCREATEDVIRTUALSIZE test0.0.1811ce27ce69232secondsago187.9MB lienhua34@test$sudodockerrun-titest:0.0.1 Hellolienhua34
Dockerfile文件的每条指令生成镜像的一层（注：一个镜像不能超过127层）。Dockerfile中的指令被一条条地执行。每一步都创建一个新的容器，在容器中执行指令并提交修改。当所有指令执行完毕后，返回最终的镜像id。
4.Dockerfile文件中的CMD和ENTRYPOINT指令差异对比
CMD指令和ENTRYPOINT指令的作用都是为镜像指定容器启动后的命令，那么它们两者之间有什么各自的优点呢？
为了更好地对比CMD指令和ENTRYPOINT指令的差异，我们这里再列一下这两个指令的说明，
CMD
支持三种格式
CMD["executable","param1","param2"]使用exec执行，推荐方式；
CMDcommandparam1param2在/bin/sh中执行，提供给需要交互的应用；
CMD["param1","param2"]提供给ENTRYPOINT的默认参数；
指定启动容器时执行的命令，每个Dockerfile只能有一条CMD命令。如果指定了多条命令，只有最后一条会被执行。
如果用户启动容器时候指定了运行的命令，则会覆盖掉CMD指定的命令。
ENTRYPOINT
两种格式：
ENTRYPOINT["executable","param1","param2"]
ENTRYPOINTcommandparam1param2（shell中执行）。
配置容器启动后执行的命令，并且不可被dockerrun提供的参数覆盖。
每个Dockerfile中只能有一个ENTRYPOINT，当指定多个时，只有最后一个起效。
从上面的说明，我们可以看到有两个共同点：
- 都可以指定shell或exec函数调用的方式执行命令；
- 当存在多个CMD指令或ENTRYPOINT指令时，只有最后一个生效；
而它们有如下差异：
差异1：CMD指令指定的容器启动时命令可以被dockerrun指定的命令覆盖，而ENTRYPOINT指令指定的命令不能被覆盖，而是将dockerrun指定的参数当做ENTRYPOINT指定命令的参数。
差异2：CMD指令可以为ENTRYPOINT指令设置默认参数，而且可以被dockerrun指定的参数覆盖；
下面分别对上面两个差异点进行详细说明，
4.1差异1
CMD指令指定的容器启动时命令可以被dockerrun指定的命令覆盖；而ENTRYPOINT指令指定的命令不能被覆盖，而是将dockerrun指定的参数当做ENTRYPOINT指定命令的参数。
下面有个命名为startup的可执行shell脚本，其功能就是输出命令行参数而已。内容如下所示，
#!/bin/bash echo"instartup,args:$@"
通过CMD指定容器启动时命令：
现在我们新建一个Dockerfile文件，其将startup脚本拷贝到容器的/opt目录下，并通过CMD指令指定容器启动时运行该startup脚本。其内容如下，
FROMubuntu:14.04 MAINTAINERlienhua34@xxx.com ADDstartup/opt RUNchmoda+x/opt/startup CMD["/opt/startup"]
然后我们通过运行dockerbuild命令生成test:latest镜像，
lienhua34@test$sudodockerbuild-ttest. SendingbuildcontexttoDockerdaemon4.096kB Step1:FROMubuntu:14.04 --->a5a467fddcb8 Step2:MAINTAINERlienhua34@163.com --->Usingcache --->332259a92e74 Step3:ADDstartup/opt --->3c26b6a8ef1b Removingintermediatecontainer87022b0f30c5 Step4:RUNchmoda+x/opt/startup --->Runningin4518ba223345 --->04d9b53d6148 Removingintermediatecontainer4518ba223345 Step5:CMD/opt/startup --->Runningin64a07c2f5e64 --->18a2d5066346 Removingintermediatecontainer64a07c2f5e64 Successfullybuilt18a2d5066346
然后使用dockerrun启动两个test:latest镜像的容器，第一个dockerrun命令没有指定容器启动时命令，第二个dockerrun命令指定了容器启动时的命令为“/bin/bash-c'echoHello'”，
lienhua34@test$sudodockerrun-ti--rm=truetest instartup,args: lienhua34@test$sudodockerrun-ti--rm=truetest/bin/bash-c'echoHello' Hello
从上面运行结果可以看到，dockerrun命令启动容器时指定的运行命令覆盖了Dockerfile文件中CMD指令指定的命令。
通过ENTRYPOINT指定容器启动时命令：
将上面的Dockerfile中的CMD替换成ENTRYPOINT，内容如下所示，
FROMubuntu:14.04 MAINTAINERlienhua34@xxx.com ADDstartup/opt RUNchmoda+x/opt/startup ENTRYPOINT[“/opt/startup”]
同样，通过运行dockerbuild生成test:latest镜像，
lienhua34@test$sudodockerbuild-ttest. SendingbuildcontexttoDockerdaemon4.096kB Step1:FROMubuntu:14.04 --->a5a467fddcb8 Step2:MAINTAINERlienhua34@163.com --->Usingcache --->332259a92e74 Step3:ADDstartup/opt --->Usingcache --->3c26b6a8ef1b Step4:RUNchmoda+x/opt/startup --->Usingcache --->04d9b53d6148 Step5:ENTRYPOINT/opt/startup --->Runningincdec60940ad7 --->78f8aca2edc2 Removingintermediatecontainercdec60940ad7 Successfullybuilt78f8aca2edc2
然后使用dockerrun启动两个test:latest镜像的容器，第一个dockerrun命令没有指定容器启动时命令，第二个dockerrun命令指定了容器启动时的命令为“/bin/bash-c'echoHello'”，
lienhua34@test$sudodockerrun-ti--rm=truetest instartup,args: lienhua34@test$sudodockerrun-ti--rm=truetest/bin/bash-c'echoHello' instartup,args:/bin/bash-cechoHello
通过上面的运行结果可以看出，dockerrun命令指定的容器运行命令不能覆盖Dockerfile文件中ENTRYPOINT指令指定的命令，反而被当做参数传递给ENTRYPOINT指令指定的命令。
4.2差异2
CMD指令可以为ENTRYPOINT指令设置默认参数，而且可以被dockerrun指定的参数覆盖；
同样使用上面的startup脚本。编写Dockerfile，内容如下所示，
FROMubuntu:14.04 MAINTAINERlienhua34@xxx.com ADDstartup/opt RUNchmoda+x/opt/startup ENTRYPOINT["/opt/startup","arg1"] CMD["arg2"]
运行dockerbuild命令生成test:latest镜像，
lienhua34@test$sudodockerbuild-ttest. SendingbuildcontexttoDockerdaemon4.096kB Step1:FROMubuntu:14.04 --->a5a467fddcb8 Step2:MAINTAINERlienhua34@163.com --->Usingcache --->332259a92e74 Step3:ADDstartup/opt --->Usingcache --->3c26b6a8ef1b Step4:RUNchmoda+x/opt/startup --->Usingcache --->04d9b53d6148 Step5:ENTRYPOINT/opt/startuparg1 --->Runningin54947233dc3d --->15a485253b4e Removingintermediatecontainer54947233dc3d Step6:CMDarg2 --->Runningin18c43d2d90fd --->4684ba457cc2 Removingintermediatecontainer18c43d2d90fd Successfullybuilt4684ba457cc2
下面运行dockerrun启动两个test:latest镜像的容器，第一条dockerrun命令没有指定参数，第二条dockerrun命令指定了参数arg3，其运行结果如下，
lienhua34@test$sudodockerrun-ti--rm=truetest instartup,args:arg1arg2 lienhua34@test$sudodockerrun-ti--rm=truetestarg3 instartup,args:arg1arg3
从上面第一个容器的运行结果可以看出CMD指令为ENTRYPOINT指令设置了默认参数；从第二个容器的运行结果看出，dockerrun命令指定的参数覆盖了CMD指令指定的参数。
4.3注意点
CMD指令为ENTRYPOINT指令提供默认参数是基于镜像层次结构生效的，而不是基于是否在同个Dockerfile文件中。意思就是说，如果Dockerfile指定基础镜像中是ENTRYPOINT指定的启动命令，则该Dockerfile中的CMD依然是为基础镜像中的ENTRYPOINT设置默认参数。
例如，我们有如下一个Dockerfile文件，
FROMubuntu:14.04 MAINTAINERlienhua34@xxx.com ADDstartup/opt RUNchmoda+x/opt/startup ENTRYPOINT["/opt/startup","arg1"]
通过运行dockerbuild命令生成test:0.0.1镜像，然后创建该镜像的一个容器，查看运行结果，
lienhua34@test$sudodockerbuild-ttest:0.0.1. SendingbuildcontexttoDockerdaemon6.144kB Step1:FROMubuntu:14.04 --->a5a467fddcb8 Step2:MAINTAINERlienhua34@163.com --->Runningin57a96522061a --->c3bbf1bd8068 Removingintermediatecontainer57a96522061a Step3:ADDstartup/opt --->f9884fbc7607 Removingintermediatecontainer591a82b2f382 Step4:RUNchmoda+x/opt/startup --->Runningin7a19f10b5513 --->16c03869a764 Removingintermediatecontainer7a19f10b5513 Step5:ENTRYPOINT/opt/startuparg1 --->Runninginb581c32b25c3 --->c6b1365afe03 Removingintermediatecontainerb581c32b25c3 Successfullybuiltc6b1365afe03 lienhua34@test$sudodockerrun-ti--rm=truetest:0.0.1 instartup,args:arg1
下面新建一个Dockerfile文件，基础镜像是刚生成的test:0.0.1，通过CMD指定要通过echo打印字符串“intest:0.0.2”。文件内容如下所示，
FROMtest:0.0.1 MAINTAINERlienhua34@xxx.com CMD["/bin/bash","-c","echointest:0.0.2"]
运行dockerbuild命令生成test:0.0.2镜像，然后通过运行dockerrun启动一个test:0.0.2镜像的容器来查看结果，
lienhua34@test$sudodockerbuild-ttest:0.0.2. SendingbuildcontexttoDockerdaemon6.144kB Step1:FROMtest:0.0.1 --->c6b1365afe03 Step2:MAINTAINERlienhua34@163.com --->Runningindeca95cf4c15 --->971b5a819b48 Removingintermediatecontainerdeca95cf4c15 Step3:CMD/bin/bash-cechointest:0.0.2 --->Runningin4a31c4652e1e --->0ca06ba31405 Removingintermediatecontainer4a31c4652e1e Successfullybuilt0ca06ba31405 lienhua34@test$sudodockerrun-ti--rm=truetest:0.0.2 instartup,args:arg1/bin/bash-cechointest:0.0.2
从上面结果可以看到，镜像test:0.0.2启动的容器运行时并不是打印字符串”intest:0.0.2”，而是将CMD指令指定的命令当做基础镜像test:0.0.1中ENTRYPOINT指定的运行脚本startup的参数。
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。
声明：本文内容来源于网络，版权归原作者所有，内容由互联网用户自发贡献自行上传，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任。如果您发现有涉嫌版权的内容，欢迎发送邮件至：czq8825#qq.com（发邮件时，请将#更换为@）进行举报，并提供相关证据，一经查实，本站将立刻删除涉嫌侵权内容。