• Maven 插件之 docker-maven-plugin 的使用


    目录

    • docker-maven-plugin 介绍
    • 环境、软件准备
    • Demo 示例
      • 配置 DOCKER_HOST
      • 示例构建镜像
        • 指定构建信息到 POM 中构建
        • 使用 Dockerfile 构建
      • 使用命令
      • 绑定 Docker 命令到 Maven各个阶段
      • 使用私有Docker仓库地址
      • 安全认证配置
    • FAQ

    1、docker-maven-plugin 介绍

    在我们持续集成过程中,项目工程一般使用 Maven 编译打包,然后生成镜像,通过镜像上线,能够大大提供上线效率,同时能够快速动态扩容,快速回滚,着实很方便。docker-maven-plugin 插件就是为了帮助我们在Maven工程中,通过简单的配置,自动生成镜像并推送到仓库中。

    2、环境、软件准备

    本次演示环境,我是在本机 Mac OX 上操作,以下是安装的软件及版本:

    1. Docker:version 17.03.1-ce
    2. Maven:version 3.3.9
    3. Java: version 1.8.0_91
    4. docker-maven-plugin:1.0.0

    注意:这里我们要测试 Java Maven 项目用 docker-maven 插件打镜像,上传镜像等操作,所以需要先安装一下 Docker、Maven、Java,这里忽略安装过程。

    3、Demo 示例

    3.1 配置 DOCKER_HOST

    docker-maven-plugin 插件默认连接本地 Docker 地址为:localhost:2375,所以我们需要先设置下环境变量。

    DOCKER_HOST=tcp://:2375
    
    • 1

    注意:如果没有设置 DOCKER_HOST 环境变量,可以命令行显示指定 DOCKER_HOST 来执行,如我本机指定 DOCKER_HOST:DOCKER_HOST=unix:///var/run/docker.sock mvn clean install docker:build

    3.2 示例构建镜像

    构建镜像可以使用一下两种方式,第一种是将构建信息指定到 POM 中,第二种是使用已存在的 Dockerfile 构建。
    第一种方式,支持将 FROM, ENTRYPOINT, CMD, MAINTAINER 以及 ADD 信息配置在 POM 中,不需要使用 Dockerfile 配置。但是如果使用 VOLUME 或其他 Dockerfile 中的命令的时候,需要使用第二种方式,创建一个 Dockerfile,并在 POM 中配置 dockerDirectory 来指定路径即可。

    这里我们以一个 Java Maven 项目 mavendemo 作为示例演示一下。

    3.2.1 指定构建信息到 POM 中构建

    
        
            
                com.spotify
                docker-maven-plugin
                1.0.0
                
                    mavendemo
                    java
                    docker_maven docker_maven@email.com
                    /ROOT
                    ["java", "-version"]
                    ["java", "-jar", "${project.build.finalName}.jar"]
                    
                    
                        
                            /ROOT
                            ${project.build.directory}
                            ${project.build.finalName}.jar
                        
                    
                
            
        
    
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25

    3.2.2 使用 Dockerfile 构建

    pom.xml配置
    
        
             
                com.spotify
                docker-maven-plugin
                1.0.0
                
                    mavendemo
                    ${basedir}/docker 
                    
                    
                        
                            /ROOT
                            ${project.build.directory}
                            ${project.build.finalName}.jar
                        
                    
                
               
        
    
    
    ${basedir}/docker/Dockerfile 配置
    
    FROM java
    MAINTAINER docker_maven docker_maven@email.com
    WORKDIR /ROOT
    CMD ["java", "-version"]
    ENTRYPOINT ["java", "-jar", "${project.build.finalName}.jar"]
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30

    以上两种方式执行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
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19

    执行完成后,使用docker images查看生成的镜像:

    REPOSITORY       TAG           IMAGE ID            CREATED             SIZE
    mavendemo        latest        333b429536b2        38 minutes ago      643 MB
    
    • 1
    • 2

    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 文件中指定配置如下:

    
      
        ...
        
          
            ...
            
               imageTag_1
               imageTag_2
            
          
        
        ...
      
    
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15

    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 操作了。

    
        
            
                com.spotify
                docker-maven-plugin
                1.0.0
                
                    mavendemo
                    java
                    docker_maven docker_maven@email.com
                    /ROOT
                    ["java", "-version"]
                    ["java", "-jar", "${project.build.finalName}.jar"]
                    
                        
                            /ROOT
                            ${project.build.directory}
                            ${project.build.finalName}.jar
                        
                    
                
                
                    
                        build-image
                        package
                        
                            build
                        
                    
                    
                        tag-image
                        package
                        
                            tag
                        
                        
                            mavendemo:latest
                            docker.io/wanyang3/mavendemo:${project.version}
                        
                    
                    
                        push-image
                        deploy
                        
                            push
                        
                        
                            docker.io/wanyang3/mavendemo:${project.version}
                        
                    
                
            
        
    
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    • 44
    • 45
    • 46
    • 47
    • 48
    • 49
    • 50
    • 51
    • 52
    • 53
    • 54

    以上示例,当我们执行mvn package时,执行 build、tag 操作,当执行mvn deploy时,执行build、tag、push 操作。如果我们想跳过 docker 某个过程时,只需要:

    • -DskipDockerBuild 跳过 build 镜像
    • -DskipDockerTag 跳过 tag 镜像
    • -DskipDockerPush 跳过 push 镜像
    • -DskipDocker 跳过整个阶段

    例如:我们想执行 package 时,跳过 tag 过程,那么就需要mvn package -DskipDockerTag

    3.5 使用私有 Docker 仓库地址

    实际工作环境中,我们需要 push 镜像到我们私有 Docker 仓库中,使用d ocker-maven-plugin 插件我们也是很容易实现,有几种方式实现:

    一、修改 POM 文件 imageName 操作

    ...
    
        registry.example.com/wanyang3/mavendemo:v1.0.0
        ...
    
    ...
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6

    二、修改 POM 文件中 newName 操作

    ...
    
        mavendemo
        ...
    
    
        tag-image
        package
        
            tag
        
        
            mavendemo
            registry.example.com/wanyang3/mavendemo:v1.0.0
        
    
    ...
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17

    3.6 安全认证配置

    当我们 push 镜像到 Docker 仓库中时,不管是共有还是私有,经常会需要安全认证,登录完成之后才可以进行操作。当然,我们可以通过命令行 docker login -u user_name -p password docker_registry_host 登录,但是对于自动化流程来说,就不是很方便了。使用 docker-maven-plugin 插件我们可以很容易实现安全认证。

    首先在 Maven 的配置文件 setting.xml 中增加相关 server 配置,主要配置 Docker registry用户认证信息。

    
      
        my-docker-registry
        wanyang3
        12345678
        
          wanyang3@mail.com
        
      
    
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    然后只需要在 pom.xml 中使用 server id 即可。

    
      
        com.spotify
        docker-maven-plugin
        1.0.0
        
          registry.example.com/wanyang3/mavendemo:v1.0.0
          ...
          my-docker-registry
        
      
    
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    3.7 其他参数

    docker-maven-plugin 插件还提供了很多很实用的配置,稍微列举几个参数吧。

    参数

    说明

    默认值

    true

    build 时强制覆盖 tag,配合 imageTags 使用

    false

    true

    build 时,指定 –no-cache 不使用缓存

    false

    true

    build 时,指定 –pull=true 每次都重新拉取基础镜像

    false

    true

    build 完成后 push 镜像

    false

    true

    build 完成后,push 指定 tag 的镜像,配合 imageTags 使用

    false

    5

    push 镜像失败,重试次数

    5

    10

    push 镜像失败,重试时间

    10s

    true

    build 时,指定 –rm=true 即 build 完成后删除中间容器

    false

    true

    build 时,使用最近的 git commit id 前7位作为tag,例如:image:b50b604,前提是不配置 newName

    false

    4、FAQ

    1、执行 build images 时,报错情况一:

    [INFO] Building image mavendemo
    org.apache.http.impl.execchain.RetryExec execute
    I/O exception (java.io.IOException) caught when processing request to {}->unix://localhost:80: No such file or directory
    [ERROR] Failed to execute goal com.spotify:docker-maven-plugin:1.0.0:build (default-cli) on project mavenDemo: Exception caught: java.util.concurrent.ExecutionException: com.spotify.docker.client.shaded.javax.ws.rs.ProcessingException: java.io.IOException: No such file or directory -> [Help 1]
    
    • 1
    • 2
    • 3
    • 4

    这个是因为 Docker 服务没有启动造成的,启动 Docker 即可。

    2、执行 build images 时,报错情况二:

    ERROR] Failed to execute goal com.spotify:docker-maven-plugin:1.0.0:build (default-cli) on project mavenDemo: Exception caught: Request error: POST unix://localhost:80/build?t=mavenDemo: 500, body: {"message":"Error parsing reference: "mavenDemo" is not a valid repository/tag: repository name must be lowercase"}: HTTP 500 Internal Server Error -> [Help 1]
    
    • 1

    这个是因为镜像名字不正确,Docker 镜像名称需匹配[a-z0-9-_.]。

    参考资料

  • 相关阅读:
    android存储,内部存储,外部存储,日志
    反射详细说明
    A40I工控主板(SBC-X40I)网络接口测试
    MySQL 全文索引
    数据结构与算法-队列
    Python机器学习笔记:CART算法实战
    下载opencv
    建模规范:命名规范
    Leetcode.146 LRU 缓存
    html解决浏览器记住密码输入框的问题
  • 原文地址:https://blog.csdn.net/m0_67400973/article/details/126435153