一、docker-maven-plugin 介绍java
在咱们持续集成过程当中，项目工程通常使用 Maven 编译打包，而后生成镜像，经过镜像上线，可以大大提供上线效率，同时可以快速动态扩容，快速回滚，着实很方便。docker-maven-plugin 插件就是为了帮助咱们在Maven工程中，经过简单的配置，自动生成镜像并推送到仓库中。nginx
二、环境、软件准备git
本次演示环境，我是在本机 Mac OX 上操做，如下是安装的软件及版本：github
- Docker：version 17.03.1-ce
- Maven：version 3.3.9
- Java： version 1.8.0_91
- docker-maven-plugin：1.0.0
注意：这里咱们要测试 Java Maven 项目用 docker-maven 插件打镜像，上传镜像等操做，因此须要先安装一下 Docker、Maven、Java，这里忽略安装过程。sql
三、Demo 示例docker
3.1 配置 DOCKER_HOSTapache
docker-maven-plugin 插件默认链接本地 Docker 地址为：localhost:2375，因此咱们须要先设置下环境变量。缓存
DOCKER_HOST=tcp://<host>:2375
注意：若是没有设置 DOCKER_HOST 环境变量，能够命令行显示指定 DOCKER_HOST 来执行，如我本机指定 DOCKER_HOST：DOCKER_HOST=unix:///var/run/docker.sock mvn clean install docker:build。安全
3.2 示例构建镜像markdown
构建镜像可使用一下两种方式，第一种是将构建信息指定到 POM 中，第二种是使用已存在的 Dockerfile 构建。
第一种方式，支持将 FROM, ENTRYPOINT, CMD, MAINTAINER 以及 ADD 信息配置在 POM 中，不须要使用 Dockerfile 配置。可是若是使用 VOLUME 或其余 Dockerfile 中的命令的时候，须要使用第二种方式，建立一个 Dockerfile，并在 POM 中配置 dockerDirectory 来指定路径便可。
这里咱们以一个 Java Maven 项目 mavendemo 做为示例演示一下。
3.2.1 指定构建信息到 POM 中构建
<build> <plugins> <plugin> <groupId>com.spotify</groupId> <artifactId>docker-maven-plugin</artifactId> <version>1.0.0</version> <configuration> <imageName>mavendemo</imageName> <baseImage>java</baseImage> <maintainer>docker_maven docker_maven@email.com</maintainer> <workdir>/ROOT</workdir> <cmd>["java", "-version"]</cmd> <entryPoint>["java", "-jar", "${project.build.finalName}.jar"]</entryPoint> <!-- 这里是复制 jar 包到 docker 容器指定目录配置 --> <resources> <resource> <targetPath>/ROOT</targetPath> <directory>${project.build.directory}</directory> <include>${project.build.finalName}.jar</include> </resource> </resources> </configuration> </plugin> </plugins> </build>
3.2.2 使用 Dockerfile 构建
pom.xml配置
<build> <plugins> <plugin> <groupId>com.spotify</groupId> <artifactId>docker-maven-plugin</artifactId> <version>1.0.0</version> <configuration> <imageName>mavendemo</imageName> <dockerDirectory>${basedir}/docker</dockerDirectory> <!-- 指定 Dockerfile 路径--> <!-- 这里是复制 jar 包到 docker 容器指定目录配置，也能够写到 Docokerfile 中 --> <resources> <resource> <targetPath>/ROOT</targetPath> <directory>${project.build.directory}</directory> <include>${project.build.finalName}.jar</include> </resource> </resources> </configuration> </plugin> </plugins> </build> ${basedir}/docker/Dockerfile 配置 FROM java MAINTAINER docker_maven docker_maven@email.com WORKDIR /ROOT CMD ["java", "-version"] ENTRYPOINT ["java", "-jar", "${project.build.finalName}.jar"]
以上两种方式执行docker:build效果是同样的，执行输出过程大体以下：
[INFO] --- docker-maven-plugin:1.0.0:build (default-cli) @ mavenDemo --- [INFO] Building image mavendemo Step 1/5 : FROM java ---> d23bdf5b1b1b Step 2/5 : MAINTAINER docker_maven docker_maven@email.com ---> Using cache ---> 2faf180d4a50 Step 3/5 : WORKDIR /ROOT ---> Using cache ---> 862210f7956a Step 4/5 : ENTRYPOINT java -jar mavenDemo.jar ---> Running in 96bbe83de6ec ---> c29009c88993 Removing intermediate container 96bbe83de6ec Step 5/5 : CMD java -version ---> Running in f69b8d2a75b1 ---> bc8d54014325 Removing intermediate container f69b8d2a75b1 Successfully built bc8d54014325
执行完成后，使用docker images查看生成的镜像：
REPOSITORY TAG IMAGE ID CREATED SIZE mavendemo latest 333b429536b2 38 minutes ago 643 MB
3.3 执行命令
mvn clean package docker:build 只执行 build 操做
mvn clean package docker:build -DpushImage 执行 build 完成后 push 镜像
mvn clean package docker:build -DpushImageTag 执行 build 并 push 指定 tag 的镜像
注意：这里必须指定至少一个 imageTag，它能够配置到 POM 中，也能够在命令行指定。命令行指定以下：mvn clean package docker:build -DpushImageTags -DdockerImageTags=imageTag_1 -DdockerImageTags=imageTag_2，POM 文件中指定配置以下：
<build>
<plugins>
... <plugin> <configuration> ... <imageTags> <imageTag>imageTag_1</imageTag> <imageTag>imageTag_2</imageTag> </imageTags> </configuration> </plugin> ... </plugins> </build>
3.4 绑定Docker 命令到 Maven 各个阶段
咱们能够绑定 Docker 命令到 Maven 各个阶段，咱们能够把 Docker 分为 build、tag、push，而后分别绑定 Maven 的 package、deploy 阶段，此时，咱们只须要执行mvn deploy就能够完成整个 build、tag、push操做了，当咱们执行mvn build就只完成 build、tag 操做。除此此外，当咱们想跳过某些步骤或者只执行某个步骤时，不须要修改 POM 文件，只须要指定跳过 docker 某个步骤便可。好比当咱们工程已经配置好了自动化模板了，可是此次咱们只须要打镜像到本地自测，不想执行 push 阶段，那么此时执行要指定参数-DskipDockerPush就可跳过 push 操做了。
<build> <plugins> <plugin> <groupId>com.spotify</groupId> <artifactId>docker-maven-plugin</artifactId> <version>1.0.0</version> <configuration> <imageName>mavendemo</imageName> <baseImage>java</baseImage> <maintainer>docker_maven docker_maven@email.com</maintainer> <workdir>/ROOT</workdir> <cmd>["java", "-version"]</cmd> <entryPoint>["java", "-jar", "${project.build.finalName}.jar"]</entryPoint> <resources> <resource> <targetPath>/ROOT</targetPath> <directory>${project.build.directory}</directory> <include>${project.build.finalName}.jar</include> </resource> </resources> </configuration> <executions> <execution> <id>build-image</id> <phase>package</phase> <goals> <goal>build