Dockerfile制作镜像

~]# docker image pull busybox:latest		#默认会从dockerhub上拉取
...
~]# docker image ls
	REPOSITORY    TAG       IMAGE ID        CREATED             SIZE
	busybox      latest    59788edf1f3e    2 months ago        1.15MB

~]# docker container run --name bbox -it busybox:latest		#启动镜像，并交互式登录

/ # httpd -h
Usage: httpd [-ifv[v]] [-c CONFFILE] [-p [IP:]PORT] [-u USER[:GRP]] [-r REALM] [-h HOME]
	   httpd -d/-e/-m STRING
        -i              Inetd mode
        -f              Don't daemonize
        -v[v]           Verbose
        -p [IP:]PORT    Bind to IP:PORT (default *:80)
        -u USER[:GRP]   Set uid/gid after binding to port
        -r REALM        Authentication Realm for Basic Authentication
        -h HOME         Home directory (default .)
        -c FILE         Configuration file (default {/etc,HOME}/httpd.conf)
        -m STRING       MD5 crypt STRING
        -e STRING       HTML encode STRING
        -d STRING       URL decode STRING

/ # mkdir /data/html		#家目录
/ # echo "httpd server" >> /data/html/index.html		#测试页
/ # httpd -h /data/html		#指定家目录，启动服务

~]# docker container commit --help
	Usage:  docker container commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]
	Options:
	  -a, --author string    Author (e.g., "John Hannibal Smith <hannibal@a-team.com>")
	  -c, --change list      Apply Dockerfile instruction to the created image
	  -m, --message string   Commit message
	  -p, --pause            Pause container during commit (default true)

~]# docker container commit -p bbox test/mybbox:v0.1		#-p制作镜像时，容器暂停运行，防止在制作镜像时有数据写入
~]# docker image ls
	test/mybbox      v0.1     e07687dd8546    1 minutes ago     1.15MB 

~]# docker image inspect -f {{.Config.Cmd}} test/mybbox:v0.1
	[sh]						#可见 mybbox 镜像还是使用 busybox 的初始命令。

~]# docker container commit -a "test <test@docker.com>" -c 'CMD ["/bin/httpd,"-h /data/html"]' -p bbox test/mybbox:v0.2
~]# docker image inspect -f {{.Config.Cmd}} test/mybbox:v0.2         
	[/bin/sh -c ["/bin/httpd,"-h /data/html"]]

~]# docker image save -o /tmp/mybbox.gz test/mybbox:v0.2	#-o指定保存目录，也可多个镜像一起保存
~]# docker image load -i /tmp/mybbox.gz 		#使用时导入即可

Syntax: 
	FROM <image>[:<tag>] 
	FROM <image>@<digest>
	
	<image> :指定作为base image的名称，默认从dockerhub拉取镜像，若使用其他仓库可在镜像前指定；
	<tag>	:base image的标签，为可选项，省略时默认为latest；

eg:
	FROM busybox:latest

Syntax: 
	FROM <image>[:<tag>] 
	FROM <image>@<digest>
	
	<image> :指定作为base image的名称，默认从dockerhub拉取镜像，若使用其他仓库可在镜像前指定；
	<tag>	:base image的标签，为可选项，省略时默认为latest；

eg:
	FROM busybox:latest

Syntax:
	 LABEL <key>=<value> [<key>=<value> ...]

eg:
	LABEL name=test mail=test@163.com

Syntax:
	COPY <src> ... <dest> 
	COPY ["<src>",... "<dest>"] 

	<src>  :要复制的源文件或目录，支持使用通配符
	<dest> :目标路径，即正在创建的image的文件系统路径；
		    建议为<dest>使用绝对路径否则，COPY指定则以WORKDIR为其起始路径；

文件复制准则:
	1.<src>必须是build上下文中的路径，不能是其父目录中的文件
	2.如果<src>是目录，则其内部文件或子目录会被递归复制，但<src>目录自身不会被复制
	3.如果指定了多个<src>，或在<src>中使用了通配符，则<dest>必须是一个目录，且必须以/结尾
	4.如果<dest>事先不存在，它将会被自动创建，这包括其父目录路径

eg:
	COPY index.html /data/web/		#最后不加斜线会改名为web
	COPY src/ /data/web				#src/* 被拷贝到/data/web目录下
	COPY test1 test2 /data/web/		#多文件最后必须加/

Syntax:
	ADD <src> ... <dest> 
	ADD ["<src>",... "<dest>"] 

操作准则:同COPY指令
	1.如果<src>为URL且<dest>不以/结尾，则<src>指定的文件将被下载并直接被创建为<dest>；
	  如果<dest>以/结尾，则文件名URL指定的文件将被直接下载并保存为<dest>/<filename>。
	2.如果<src>是一个本地系统上的压缩格式的tar文件，它将被展开为一个目录，其行为类似于“tar -x”命令；
	  然而，通过URL获取到的tar文件将不会自动展开；
	3.如果<src>有多个，或其间接或直接使用了通配符，则<dest>必须是一个以/结尾的目录路径；
	  如果<dest>不以/结尾，则其被视作一个普通文件，<src>的内容将被直接写入到<dest>；

eg:
	ADD http://nginx.org/download/nginx-1.14.2.tar.gz  /data/		#nginx-1.14.2.tar.gz会放在/data/目录下，不会解压
	ADD nginx-1.14.2.tar.gz	/date		#nginx-1.14.2目录会放在/data/目录下，会解压

Syntax:
	WORKDIR <dirpath>

注:在Dockerfile文件中，WORKDIR指令可出现多次，其路径也可以为相对路径，不过，其是相对此前一个WORKDIR指令指定的路径另外，
WORKDIR也可调用由ENV指定定义的变量

eg:
	WORKDIR /var/log
	WORKDIR $STATEPATH

Syntax:
	VOLUME <mountpoint> 
	VOLUME ["<mountpoint>"] 

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

eg:
	VOLUME /data		#不能指定宿主机目录，随机挂载在 /var/lib/docker/volumes/...

Syntax:
	EXPOSE <port>[/<protocol>] [<port>[/<protocol>] ...]
	<protocol>用于指定传输层协议，可为tcp或udp二者之一，默认为TCP协议

eg:
	EXPOSE 11211/udp 11211/tcp	#EXPOSE指令可一次指定多个端口

Syntax:
	ENV <key> <value> 或
	ENV <key>=<value> ...

注：
	1.第一种格式中，<key>之后的所有内容均会被视作其<value>的组成部分，因此，一次只能设置一个变量；
	2.第二种格式可用一次设置多个变量，每个变量为一个"<key>=<value>"的键值对，如果<value>中包含空格，可以以反斜线(\)进行转义，
	  也可通过对<value>加引号进行标识；另外，反斜线也可用于续行；
	3.定义多个变量时，建议使用第二种方式，以便在同一层中完成所有功能
	4.docker run时可以使用 -e 参数指定环境变量，相同环境变量会覆盖Dockerfile中的值

eg:
	ENV name=zhang \
		age=15	\
		sex=N

Syntax:
	RUN <command> 
	RUN ["<executable>", "<param1>", "<param2>"]

注：
	1.第一种格式中，<command>通常是一个shell命令，且以“/bin/sh -c”来运行它，这意味着此进程在容器中的PID不为1，不能接收Unix信号，
	  因此，当使用docker stop <container>命令停止容器时，此进程接收不到SIGTERM信号；即在运行该命令前会先起一个sh进程，然后运行此命令。
	2.第二种语法格式中的参数是一个JSON格式的数组，其中<executable>为要运行的命令，后面的<paramN>为传递给命令的选项或参数；
	  然而，此种格式指定的命令不会以“/bin/sh -c”来发起，因此常见的shell操作如变量替换以及通配符(?,*等)替换将不会运行；
	  不过，如果要运行的命令依赖于此shell特性的话，可以将其替换为类似的格式：RUN ["/bin/bash", "-c", "<executable>", "<param1>"]

eg:
	RUN ls /data		#将会在构建的时候执行 "ls /data"命令
	RUN ["/bin/sh","-c","mkdir -p /data/hello"]	

Syntax:
	CMD <command> 
	CMD ["<executable>","<param1>","<param2>"] 
	CMD ["<param1>","<param2>"]

注：前两种语法格式的意义同RUN，第一种用法虽然会先起sh进程，但是执行完command后，sh进程会退出，并由command的进程替代为1号进程，第三种则用于为ENTRYPOINT指令提供默认参数。

eg:
	CMD /bin/httpd -f -h $DOC_ROOT	#如下可见在运行命令之前会预先运sh命令
	~]# docker image inspect -f {{.Config.Cmd}} test
		[/bin/sh -c /bin/httpd -f -h $DOC_ROOT]

~]# docker container run --name NAME -it --rm IMAGE_NAME /bin/bash		#CMD 指定的命令可在 docker run 时指定命令修改

Syntax:
	ENTRYPOINT <command>
	ENTRYPOINT ["<executable>", "<param1>", "<param2>"]

注:
	1.docker run命令传入的命令参数会覆盖CMD指令的内容并且附加到ENTRYPOINT命令最后做为其参数使用。
	2.Dockerfile文件中也可以存在多个ENTRYPOINT指令，但仅有最后一个会生效。

eg:
	CMD ["/bin/ls","/etc"]
	ENTRYPOINT ["/bin/bash","-c"]		#会先启动sh进程，CMD指定的命令会被当做参数传给 /bin/bash -c
	
~]# docker container run --name NAME -it --rm IMAGE_NAME /bin/bash		#使用entrypoint时，docker run时动态指定的命令将会被当做参数传递给entrypoint定义的命
~]# docker container run --name NAME -it --rm --entrypoint "/bin/bash" IMAGE_NAME	#entrypoint指定的命令可以在docker run时添加的 --entrypoint 后的命令所覆盖 

Syntax:
	USER <UID>|<UserName>

	注：需要注意的是，<UID>可以为任意数字，但实践中其必须为/etc/passwd中某用户的有效UID，否则，docker run命令将运行失败。

Syntax:
	HEALTHCHECK [OPTIONS] CMD command

OPTIONS:
	--interval：多长时间检测一次，默认30s
	--timeout：超时时长，默认30s
	--start-period：容器启动后多久开始检测，默认30s
	--retries：重试次数：默认3次

响应码：
	0：success
	1：unhealthy
	2：reserved
	
eg:
	HEALTHECK --interval=5m --timeout=30s CMD curl -f http://localhost/ || exit 1	

Syntax:
	SHELL ["executable"，"parameters"]

Syntax:
	ONBUILD <INSTRUCTION>
注：
	1.尽管任何指令都可注册成为触发器指令，但ONBUILD不能自我嵌套，且不会触发FROM和MAINTAINER指令
	2.使用包含ONBUILD指令的Dockerfile构建的镜像应该使用特殊的标签，例如ruby:2.0-onbuild
	3.在ONBUILD指令中使用ADD或COPY指令应该格外小心，因为新构建过程的上下文在缺少指定的源文件时会失败

~]# mkdir myng
~]# cd myng
~]# cat Dockerfile
	#Dockerfile for my nginx
	
	FROM nginx:1.14-alpine
	
	LABEL maintainer="chuan <chuan@test.com>"
	
	ENV DOC_ROOT="/data/web/html/"
	
	#ARG参数不会写到容器的环境变量中，所以在此环境下，PORT不会传递给配置中的变量，此处应使用ENV
	#ARG PORT=80
	ENV PORT=80
	
	COPY entrypoint.sh /bin/
	ADD index.html $DOC_ROOT
	
	EXPOSE ${PORT}/tcp
	
	ENTRYPOINT ["/bin/entrypoint.sh"]
	CMD ["/usr/sbin/nginx","-g","daemon off;"]
	
	HEALTHCHECK --interval=10s --start-period=10s CMD wget -O - -q http://${IP:-0.0.0.0}:${PORT:-80}/index.html

~]# cat index.html
	<h1>hello world</h1>

~]# cat entrypoint.sh 			#exec命令表示用将要执行的进程代替当前进程，否则此程序将作为sh的子进程运行
	#!/bin/sh
	#
	cat > /etc/nginx/conf.d/www.conf << EOF
	server {
	        server_name $HOSTNAME;
	        listen ${IP:-0.0.0.0}:${PORT:-8080};
	        root ${DOC_ROOT:-/usr/share/nginx/html};
	}
	EOF
	exec "$@"

~]# chmod a+x entrypoint.sh
~]# docker image build . -t 	test/myweb:v0.1		#PATH 要为Dockerfile文件的父目录

~]# mkdir ap
~]# cd ap
~]# cat Dockerfile 
	#Dockerfile for my httpd
	
	FROM centos:7
	
	LABEL maintainer="chuan <chuan@test.com>"
	
	ENV doc_root=/var/www/html \
        listen_port=80 \
	    server_name=localhost
	
	RUN yum makecache && \
	    yum install -y httpd php php-mysql && \
	    yum clean all 
	
	ADD phpinfo.php ${doc_root}
	ADD entrypoint.sh /bin/
	
	EXPOSE 80/tcp
	
	VOLUME ${doc_root}
	
	CMD ["/usr/sbin/httpd","-DFOREGROUND"]
	ENTRYPOINT ["/bin/entrypoint.sh"]

]# cat phpinfo.php 
	<?php
	        phpinfo();
	?>

~]# 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 "$@"
	
~]# chmod a+x entrypoint.sh
~]# docker image build . -t 	test/myweb:v0.2

~]# docker container run --name myweb2 --rm -P test/myweb:v0.2