docker-maven-demo

几种自动化构建Docker镜像的Maven插件使用

目的:实现应用的自动打包、构建docker镜像、推送私有镜像仓库、运行/停止/销毁容器

io.fabric8.docker-maven-plugin
com.spotify.dockerfile-maven-plugin
org.springframework.boot.spring-boot-maven-plugin [SpringBoot官方插件]

详细使用请参考三种自动化构建Docker镜像的Maven插件使用

io.fabric8.docker-maven-plugin

子项目:fabric-docker

使用方法：

由于项目中用到mysql，所以在项目启动前先启动mysql容器，参考如下
```
docker run --rm --name mysql -v mysql-data:/var/lib/mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 -d mysql:latest
```
然后将document/sql/quick_coating.sql导入
项目要用到私有镜像仓库，搭建可参考：https://www.jianshu.com/p/bbbf93b29b78
使用不同的Maven插件构建Docker镜像时方法不同，所以此项目直接使用Dockerfile来构建，也推荐大家这样使用
项目打包，点击idea右侧的Lifecyle->package即可；如果pom.xml中有配置execution项则同时生产docker镜像
生产镜像，点击Plugins->docker:build即可
容器操作，点击Plugins->docker:start/stop/remove即可实现容器的启动/停止/销毁
访问应用：swagger url: http://127.0.0.1:8082/swagger-ui/index.html

com.spotify.dockerfile-maven-plugin

子项目:spotify-dockerfile

Spotify官方已经不再推荐使用 docker-maven-plugin ;推荐使用 com.spotify.dockerfile-maven-plugin

使用方法：

配置pom.xml
在pom.xml添加 com.spotify.dockerfile-maven-plugin 插件配置

<properties>
    <docker.image.prefix>12.78.18.15:5000</docker.image.prefix>
</properties>
<build>
    <plugins>
        <plugin>
             <groupId>com.spotify</groupId>
             <artifactId>dockerfile-maven-plugin</artifactId>
             <version>1.4.13</version>
             <executions>
                 <!--运行mvn package时，会自动执行build目标，构建Docker镜像;
                 运行mvn deploy命令时，会自动执行push目标，将Docker镜像push到Docker仓库-->
                 <execution>
                     <id>default</id>
                     <goals>
                         <goal>build</goal>
                         <goal>push</goal>
                     </goals>
                 </execution>
             </executions>
             <configuration>
                 <repository>${docker.image.prefix}/spotify-dockerfile</repository>
                 <tag>${project.version}</tag>
                 <!--在settings.xml中配置server-->
                 <useMavenSettingsForAuth>true</useMavenSettingsForAuth>
                 <!--可以指定一个或多个变量，传递给Dockerfile，在Dockerfile中通过ARG指令进行引用-->
                 <buildArgs>
                     <JAR_FILE>${project.build.finalName}.jar</JAR_FILE>
                 </buildArgs>
             </configuration>
         </plugin>
    </plugins>
</build>

编写Dockerfile 这里说明下插件特有的新功能，可使用pom.xml中指定的变量

# 此处的JAR_FILE正式pom.xml中指定的buildArgs->JAR_FILE
ARG JAR_FILE
COPY target/${JAR_FILE} /app.jar

构建docker images

使用该插件构建Docker镜像，需要有一个安装好的Docker运行环境，且需要在运行该插件的机器上定义DOCKER_HOST环境变量，配置访问Docker的URL linux 下配置
```
export DOCKER_HOST=tcp://localhost:2375
```
window下配置环境变量,自行配置即可接下来，就可以运行maven命令来构建Docker镜像了,使用idea右侧工具栏响应的命令双击即可
```
mvn package 或者 mvn dockerfile:build
```
推送到私有镜像仓库

作者使用的非docker hub，而是自己搭建的，且需要用户验证，pom.xml配置如下
```
<useMavenSettingsForAuth>true</useMavenSettingsForAuth>
```
同时在maven的settings.xml中的servers下增加一个server配置：
```
 <servers>
      <server>
         <id>12.78.182.15:5000</id>
         <username>lipandeng</username>
         <password>123456</password>
       </server>
 </servers>
```
注意server.id即是上边配置的docker.image.prefix push 镜像
```
mvn dockerfile:push
```
查看私有镜像库即可验证上传是否成功

org.springframework.boot.spring-boot-maven-plugin

子项目:springboot-docker

springboot 2.3.X+ , maven plugin支持将应用程序打包成Docker镜像，无需额外的Dockerfile，只需要一条命令即可，不需要任何改动,这里我们用最新版的2.5.3

使用方法：

配置pom.xml

<properties>
    <docker.image.prefix>12.78.18.15:5000</docker.image.prefix>
</properties>
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration> 
        <image>
            <!--镜像名称-->
            <name>${docker.image.prefix}/${project.name}:${project.version}</name>
            <!--生成镜像后是否推送到镜像仓库-->
            <publish>true</publish>
        </image> 
        <docker>
            <!--docker环境远程管理地址，非镜像仓库地址-->
            <host>http://localhost:2375</host>
            <!--不使用TLS访问-->
            <tlsVerify>false</tlsVerify>
            <!--Docker推送镜像仓库配置-->
            <publishRegistry>   
                <!--推送镜像仓库用户名-->
                <username>test</username>
                <!--推送镜像仓库密码-->
                <password>123456</password>
                <!--推送镜像仓库地址-->
                <url>http://${docker.image.prefix}</url>      
            </publishRegistry>      
        </docker>
    </configuration> 
</plugin>

生成镜像&推送到私有镜像仓库
```
mvn spring-boot:build-image
```
也可在idea，直接双击SpringBoot插件的build-image命令即可一键打包并推送到镜像仓库生成镜像工程中由于需要从github下载文件，大概率会不成功，需要多次尝试。最后在本地和私有镜像仓库均有docker镜像，表示buiild-image已经完成。

总结

io.fabric8.docker-maven-plugin 比较灵活(可dockerfile也可pom.xml配置)、支持直接操作容器，且仍在持续更新，推荐使用。
com.spotify.dockerfile-maven-plugin 支持dockerfile 近两年无更新，不支持操作容器。
org.springframework.boot.spring-boot-maven-plugin springboot官方插件，无需额外安装，但需要从github下载相关层文件，失败率高，需要多次尝试。

License

lipandeng/docker-maven-demo

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages