DockerFile及DockerFile Maven插件说明及基本用法

上一篇：Ubuntu16.04上Docker的安装及基本用法

本文主要内容有：

• DockerFile常用指令；

• 使用DockerFile构建Docker镜像

• DockFile Maven插件说明；

• 使用DockerFile Maven插件构建Docker镜像；

• 使用DockerFile Maven插件实现Spring Boot程序自动化部署；

 

DockerFile是一个文本文件，其中包含若干条指令，指令描述了构建镜像的细节。

DockerFile常用指令

• ADD 复制文件

ADD指令用于复制文件，格式为：

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

从src目录复制文件到容器的dest。其中src可以是Dockfile所在目录的相对路径，也可以是一个URL，还可以是一个压缩包。

注意：

    src必须在构建的上下文内，不能使用例如：ADD ../something /something 这样的命令，因为docker build命令首先会将上下文路径和其子目录发送到docker daemon。

    如果src是一个URL，同时dest不以斜杠借我，dest将会被视为文件，MULU src对应内容将会被下载到dest。

    如果src是一个URL，同时dest以斜杠结尾，dest将被视为目录，src对应内容将会被下载到dest目录。

    如果src是一个目录，那么整个目录下的内容将会被复制，包括文件系统元数据。

    如果文件是可识别的压缩包格式，则docker会自动解压。

示例：

ADD microservice-discovery-eureka-0.0.1-SNAPSHOT.jar app.jar

• ARG 设置构建参数

ARG指令用于设置构建参数，类似于ENV。和ENV不同的是，ARG设置的是构建时的环境变量，在容器运行时是不存在这些变量的，格式为：

ARG <name> [=<default value>]

示例：

ARG user1=someuser

• CMD 容器启动命令

CMD命令用于为执行容器提供默认值。每个Dockerfile只有一个CMD命令，如果指定了多个CMD命令，那么只有最后一条会被执行，如果启动容器时指定了运行的命令，则会覆盖掉CMD指定的命令，支持3种格式：

CMD ["executable","param1","param2"]  (推荐使用)
CMD ["param1","param2"]  (为ENTRYPOINT指令提供预设参数)
CMD command param1 param2  (在shell中执行)

示例：

CMD echo "This is a test." | wc -

• COPY 复制文件

COPY命令用于复制文件，格式为：

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

复制本地端的src到容器的dest。COPY指令和ADD指令类型，COPY指令不支持URL和压缩包。

• ENTRYPOINT 入口点

ENTRYPOINT指令和CMD指令的目的一样，都是指定Dorker容器启动时执行的命令，可多次设置，但只有最后一个有效，格式为：

ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2

• ENV 设置环境变量

ENV指令用于设置环境变量，格式为：

ENV <key> <value>
ENV <key>=<value> ...

示例：

ENV JAVA_HOME /path/to/java

• EXPOSE 声明暴露的端口

EXPOSE指令用于声明在运行时容器提供服务的端口，格式为：

EXPOSE <port> [<port>...]

需要注意的是，这只是一个声明，运行时并不会因为该声明就打开相应的端口。该指令的作用主要是帮助镜像使用者理解该镜像服务的守护端口；其次是当运行时使用随机映射时，自动映射EXPOSE的端口。

示例：

# 声明暴露一个端口示例
EXPOSE port1
# 相应的运行容器使用的命令
$ sudo docker run -p port1 image
# 也可以使用 -P 选项启动
$ sudo docker run  -P image

# 声明暴露多个端口示例
EXPOSE port1 port2 port3
# 相应的运行容器使用的命令
$ sudo docker run -p port1 -p port2 -p port3 image
# 也可指定需要映射到宿主机上的端口号
$ sudo docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 image

• FROM 指定基础镜像

使用FROM指令指定基础镜像，FROM指令有点像Java里的extends关键词。需要注意的是，FROM指令必须指定且需要写在其他指令之前。FROM指令后的所有指令都依赖于该指令所指定的镜像，支持3种格式：

FROM <image>
FROM <image>:<tag>
FROM <image>@<digest>

• LABEL 为镜像添加元数据

LABEL指令用于为镜像添加元数据，格式为：

LABEL <key>=<value> <key>=<value> <key>=<value> ...

使用“"”和“\”转换命令行，示例：

LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo"
LABEL version="1.0"
LABEL description="This text illustrates \
that label-values can span multiple lines."

• MAINTAINER 指定维护者的信息

MAINTAINER指令用于指定维护者的信息，用户为Dockerfile署名，格式为：

MAINTAINER <name>

示例：

MAINTAINER 张三<0001@163.com>

• RUN 执行命令

该指令支持两种格式：

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

RUN <command>在shell终端中运行，在Linux中默认是/bin/sh -c，在Windows中是cmd/s /c，使用这种格式，就像直接在命令航中输入命令一样。

RUN ["executable", "param1", "param2"] 使用exec执行，这种方式类似于函数调用。指定其他终端可以通过该方式操作。

例如：RUN ["/bin/bash", "-c", "echo hello"]，该方式必须使用双引号"而不是单引号'，因为该方式会被转换成一个JSON数组。

• USER 设置用户

该指令用于设置启动镜像时的用户或者UID，写在该指令后的RUN、CMD以及ENTRYPOINT指令都将使用该用户执行命令，格式为：

USER 用户名

示例：

USER deamon

• VOLUME 指定挂载点

该指令使容器中的一个目录具有持久化存储的功能，该目录可以被容器本身使用，也可以共享给其他容器。当容器中的应用有持久化数据的需求时可以在Dockerfile中使用该命令，格式为：

VOLUME ["/data"]

示例：

VOLUME /data

• WORKDIR 指定工作目录

该指令为切换目录指令，类似于cd命令，写在该指令后的RUN，CMD以及ENTRYPOINT指令都将该目录作为当前目录，并执行相应的命令，格式为：

WORKDIR /path/to/workdir

使用DockerFile构建Docker镜像

以项目microservice-discovery-eureka为例

• 将项目构建成jar包 (microservice-discovery-eureka-0.0.1-SNAPSHOT.jar)：

# 使用Maven命令打包项目
$ mvn clean pachage

• 在jar包所在目录下创建名为Dockfile的文件

$ sudo touch Dockerfile

• 在Dockerfile文件中添加以下内容：

# 基于哪个镜像
FROM java:8

# 将本地文件夹挂载到当前容器
VOLUME /tmp

# 复制文件到容器，也可以直接写成 ADD microservice-discovery-eureka-0.0.1-SNAPSHOT.jar /app.jar
ADD microservice-discovery-eureka-0.0.1-SNAPSHOT.jar app.jar
RUN bash -c 'touch /app.jar'

# 声明需要暴露的端口
EXPOSE 8761

# 配置容器启动后执行的命令
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"

• 使用docker build命令构建镜像

# 格式：docker build -t 仓库名称/镜像名称(:标签) Dockerfile的相对位置
docker build -t itmuch/microservice-discovery-eureka:0.0.1 .

这里使用-t选项指定了镜像的标签。执行该命令后，终端将会输出镜像构建的详细过程和结果。

• 使用docker images命令查看镜像是否存在

docker images

• 启动镜像

docker run -d -p 8761:8761 itmuch/microservice-discovery-eureka:0.0.1

• 验证镜像是否启动成功

访问：http://Docker宿主机IP:8761/，可以正常显示Eureka Server首页

DockFile Maven插件说明

插件名称为：dockerfile-maven-plugin

插件下载地址：点击进入

插件POM依赖：

# 目前最新版本是1.3.7
<plugin>
  <groupId>com.spotify</groupId>
  <artifactId>dockerfile-maven-plugin</artifactId>
  <version>1.3.7</version>
</plugin>

 该插件可以连接远程Docker，通过命令把本地的jar包打成Docker镜像并上传到远程Docker服务器或发布到远程Docker仓库，该插件的前身为docker-maven-plugin，老版本插件允许没有DockerFile，相关配置参数全部写在pom.xml中，老版本插件作者以停止维护升级。