Dockerfile是一个文本文件,包含了若干条指令。
1.准备一个文件,名为Dockerfile
FROM nginx
RUN echo'<h1>test</h1>' > /usr/share/ngix/html/index.html
FROM指用于指定基础镜像
RUN指令用于执行命令
2. 构建镜像
在Dockerfile所在路径执行docker build -t nginx:my .
命令后面的点(.)et 用于路径参数传递,表示当前路径。
3.在指定镜像启动一个Docker容器
docker run -d -p 92:80 ngix:my
4.访问宿主机
二、 Dockerfile常用命令
2.1 ADD 复制文本
ADD <src>...<dest>
从src目录复制文档 到容器的dest,src可以是一个Dockerfile所在目录的相对路径,也可以是一个url,还可以是一个压缩包。
注意事项目
a. src必须在构建的上下文内;
b. src是一个url,同时dest不以斜杠结尾,dest将被视为文件,src对应的内容会被下载到dest.。
c. src是一个url,同进dest以斜杠结尾,dest将被视为目录,src对应的内容会被下载到dest.。
d. src是一个目录,整个目录都会被复制到,包括文件系统元数据。
e. 如果文件是可识别的压缩包格式,则docker会自动解压缩
示例:ADD test.jar app.jar
2.2 ARG设置构建参数
ARG指令用于设置构建参数,类似于ENV。和ENV不同的是,ARG设置的是构建时的环境变量,在容器运行时是不是会存在这些变量的。
格式为:ARG <name>[=<default value>]
示例:ARG user=someuser
2.3 CMD容器启动命令
CMD指令用于执行容器提供默认值、每个Dockerfile只有一个CMD命令,如果指定多个CMD命令,那么只有最后一条会被执行,如果 启动容器时指下降运行的命令,则会覆盖CMD指定的命令。
支持3种格式:
1) CMD["exeutable","param1","param2"](推荐使用)
2)CMD["param1","param2"](为ENTERPOINT指令提供预设参数)
3)CMD command param1 param2(在shell中执行)
示例:CMD echo "This is a test." | wc -
2.4 COPY复制文件
格式为:
COPY <src>...<dest>
COPY["<src>"..."<dest>"]
复制本地端的 src到容器的dest,COPY指令和ADD指令类似,COPY不支持URL 和压缩包。
2.5 ENTRYPOINT入口点
格式为:
1) ENTRYPOINT["exeutable","param1","param2"]
3)ENTRYPOINT command param1 param2
ENTRYPOINT 和CMD指令的目的都一样,都是指定Docker容器启动时执行的命令,可多次设置,但只有最后一个有效
2.6 ENV 设置环境变量
ENV指令用于设置环境变量,格式为:
ENV <key> <value>
ENV<key>=<value>...
示例: ENV JAVA_HOME /path/to/java
2.7 EXPOSE声明暴露的端口
EXPOSE指令用于声明在运行时容提供服务的端口,格式为:EXPOSE<port> [<port>...].
注:这只是一个声明,运行是并不会因为该声明就找开相应端口。该指令的作用主要是帮助镜像使用都理解该镜像服务的守护端口;其次是当运行时使用随机映射时,会自动映射EXPOSE端口。
示例:
#声明暴露一个端口
EXPOSE port1
#相应的运行容器使用的命令
docker run -p port1 image
#也可以使用-p选项启动
docker run -p image
#声明暴露多个端口示例:
EXPOSE port1 port2 port3
#相应的容器使用相应的命令
docker run -p port1 -p port2 -p port3 image
#也可以指定需要映射到缩主机器上的端口号
docker run -p host_port1:port1 -p host_port3:port2 -p host_port3:port3 image
2.8 FROM指定基础镜像
使用FROM指令指定基础镜像,FROM指令有点像JAVA里面的extends关键字,需求要注意的是,FROM指令必须指定且需要写在其它指令之前,FROM指令后的所有指令都 依赖于该指令所指定的镜像。
支持3种格式:
FROM <image>
FROM <image>:<tag>
FROM <image>@<digest>
2.9 LABEL为镜像添加元数据
格式为:LABEL <key>=<value> <key>=<value> <key>=<value> ....
使用“:”和"/"转换命令行,示例:
LABEL "com.example.vender"="ACME Incorporated"
LABEL com.example.label-with-value="foo"
LABEL version="1.9";
LABEL description="This text illustreates\
that label-values can span multiple lines."
2.10 MAINTAINER指定维护者的信息,用于为Dockerfile署名
格式为:MAINTAINER <name>
示例:MAINTAINER test<test@qq.com>
2.11 RUN执行命令
格式:
RUN <command>
在shell终端中运行,在linux中默认是/bin/sh -c,在windows中是cmd /s/c,这程格式就像直接在命令行中输入命令一样。
RUN["exeutable","param1","param2"]
使用exec执行,这种方式类似于函数调用。指定终端可以通过该方式操作,例如RUN["bin/bash","-c","echo hello"],该方式必须使用双引号["]而不能使用单引号['],因为该方式会转换成一个json数组。
2.12 USER设置用户
该指令用于设置启动镜像时的用户或者UID,写在该指后的RUN,CMD以及ENTRYPOINT指令都将使用该用户执行命令。
格式为:USER userName
示例: USER tester
2.13 VOLUME指定挂载
该指令使用容 器中的一个目录具有扶化存储的功能,该目录可被容器本身使用,也可以共享给其它容器,当容器中的应用 有持久化数据的需求时可以在Docerfile中使用该指令。
格式为:VOLUME ["/data"]
示例:VOLUME /data
2.14 WORKDIR指定工作目录
格式为:WORKDIR /path/to/wordkdir.
切换目录 指令,类似于cd命令,写在该指后的RUN,CMD以及ENTRYPOINT指令都 将该目录作为当前目录,并执行相应命令。
2.15 其它
Dockerfile还有其它指令,例如STOPSINGAL、 HEALTHCHECK、SHELL等。
来源:Spring clould与Docker微服务架构实战第13.1章