Dockerfile是一个文本文件,其中包含了若干条指令,指令描述了构建镜像的细节。
先来编写一个最简单的Dockerfile,编写一个Dockerfile修改该镜像的首页。
1:准备一个文件,名为Dockerfile:
> FROM nginx
> RUN echo '测试Dockerfile文件
' > /user/share/nginx/html/index.html
FROM指令用语指定基础镜像,RUN指令用于执行命令。
2:在Dockerfile所在路径执行以下命令构建镜像:
docker build -t nginx:my .
其中,命令最后的(.)用于路径参数传递,表示当前路径。
3:执行以下命令,即可使用该镜像启动一个Docker容器。
docker run -d -p 92:80 nginx:my
4:访问http://Docker宿主机IP:92/,即可看到刚才修改的主页面。
指令的一般格式为:指令名称参数。
ADD用于复制文科,格式为:
- ADD ....
- ADD["",...""]
从src目录复制文件到容器的dest,其中src可以是Dockerfile所在目录的相对路径,也可以是一个URL,还可以是一个压缩包。
示例:
ADD microservice-discovery-eureka-0.0.1-SNAPSHOT.jar app.jar
ARG指令用于设置构建参数,类似于ENV。ARG设置的是构建时的环境变量,在容器运行时是不会存在这些变量的。
格式为:ARG [name][=< default value>]
示例:
ARG user1=someuser
CMD指令用于为执行容器提供默认值。每个Dockerfile只有一个CMD命令,如果指定了多个CMD命令,那么只有最后一条会被执行,如果启动容器时指定了运行的命令,则会覆盖CMD指定的命令。
支持3种格式:
CMD ["executable","parama","param2"] (推荐使用)
CMD["param1","param2"] (为EMTRYPOINT指令提供预设参数)
CMD command param1 param2 (在shell中执行)
示例:
CMD echo "test." | wc -
复制文件,格式为:
- COPY ...
- COPY ["",...""]
复制本地端的src到容器的dest。COPY不支持URL和压缩包。
格式为:
ENTRYPOINT ["executable","param1","param2"]
ENTRYPOINT command param1 param2
ENTRYPOINT和CMD指令的目的一样,都是指定Docker容器启动时执行的命令,可多次设置,但只有最后一个有效。
ENV指令用语设置环境变量,格式为:
ENV
ENV = ...
示例:
ENV JAVA_HOME /path/to/java
EXPOSE指令用语声明在运行时容器提供服务的端口,格式为:
EXPOSE [...]
这只是一个声明,运行时并不会因为该声明就打开相应的端口。该指令的作用主要是帮助镜像使用者理解该镜像服务的守护端口;其次是运行时使用随机映射时,会自动映射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 -p host_port2:port2 -p host_port3:port3 image
使用FROM指令指定基础镜像,FROM指令类似Java中的extends关键字。FROM指令必须指定且需要写在其他指令之前。FROM指令后的所有指令都依赖与该指令指定的镜像。
支持3种格式:
FROM
FROM :
FROM @
LABEL指令用于为镜像添加元数据。
格式为:
LABEL = = = ...
使用" 和 \ 转换命令行;
示例:
LABEL "com.example.vendor"=" ACME Incorporated"
LABEL com.example.label-width-value="foo"
LABEL version="1.0"
LABEL description = "this test illustrates \
that label-values can span multiple lines."
MAINTAINER 指令用于指定维护者的信息,用于为Dockerfile署名。
格式为:
MAINTAINER
示例:
MAINTAINER 测试
支持两种格式:
RUN
RUN ["executable","param1","param2"]
RUN在shell终端运行,在Windows中式cmd /s/c。
RUN ["executable","param1","param2"]使用exec执行,类似于函数调用。指定其他终端可以通过该方式操作,例如
RUN["/bin/bash","c","echo hello"],该方式必须使用双引号而不能使用单引号,因为该方式会被转换成一个JSON数组。
该指令用于设置启动镜像时的用户或者UID,写在该指令后的RUN、CMD以及ENTRYPOINT指令都将使用该用户执行命令。
格式为:USER 用户名
示例:
USER demo
该指令使容器中的一个目录具有持久化存储的功能,该目录可被容器本身使用,也可共享给其他容器。当容器中的应用有持久化数据的需求时可以在Dockerfile中使用该命令。
格式为:VOLUME ["/data"]
示例:VOLUME /data
格式为:WORKDIR /path/to/workdir
切换目录指令,类似cd,写在该指令后的RUN、CMD及ENTRYPOINT都将该目录作为当前目录,并执行相应的命令。