使用Maven插件构建Docker镜像

最新推荐文章于 2024-09-16 21:39:26 发布
最新推荐文章于 2024-09-16 21:39:26 发布
阅读量1.9w 收藏 22
点赞数 3
分类专栏： docker

1.7 Docker与微服务-使用Maven插件构建Docker镜像

工具

工欲善其事，必先利其器。笔者经过调研，有以下几款Docker的Maven插件进入笔者视野：

插件名称 官方地址
docker-maven-plugin https://github.com/spotify/docker-maven-plugin
docker-maven-plugin https://github.com/fabric8io/docker-maven-plugin
docker-maven-plugin https://github.com/bibryam/docker-maven-plugin

笔者从Stars、文档易用性以及更新频率三个纬度考虑，选用了第一款。

使用插件构建Docker镜像

简单使用

我们以之前的项目：microservice-discovery-eureka为例：

  • 在pom.xml中添加下面这段
    <build>
        <plugins>
            <!-- docker的maven插件，官网：https://github.com/spotify/docker-maven-plugin -->
            <plugin>
                <groupId>com.spotify</groupId>
                <artifactId>docker-maven-plugin</artifactId>
                <version>0.4.12</version>
                <configuration>
                    <!-- 注意imageName一定要是符合正则[a-z0-9-_.]的，否则构建不会成功 -->
                    <!-- 详见：https://github.com/spotify/docker-maven-plugin    Invalid repository name ... only [a-z0-9-_.] are allowed-->
                    <imageName>microservice-discovery-eureka</imageName>
                    <baseImage>java</baseImage>
                    <entryPoint>["java", "-jar", "/${project.build.finalName}.jar"]</entryPoint>
                    <resources>
                        <resource>
                            <targetPath>/</targetPath>
                            <directory>${project.build.directory}</directory>
                            <include>${project.build.finalName}.jar</include>
                        </resource>
                    </resources>
                </configuration>
            </plugin>
        </plugins>
    </build>
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 执行命令：
mvn clean package docker:build
 
 
  • 1
  • 我们会发现控制台有类似如下内容：
[INFO] Building image microservice-discovery-eureka
Step 1 : FROM java
Pulling from library/java
Digest: sha256:581a4afcbbedd8fdf194d597cb5106c1f91463024fb3a49a2d9f025165eb675f
Status: Downloaded newer image for java:latest
 ---> ea40c858f006
Step 2 : ADD /microservice-discovery-eureka-0.0.1-SNAPSHOT.jar //
 ---> d1c174083bca
Removing intermediate container 91913d847c20
Step 3 : ENTRYPOINT java -jar /microservice-discovery-eureka-0.0.1-SNAPSHOT.jar
 ---> Running in 0f2aeccdfd46
 ---> d57b027ca65a
Removing intermediate container 0f2aeccdfd46
Successfully built d57b027ca65a
[INFO] Built microservice-discovery-eureka
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:38 min
[INFO] Finished at: 2016-09-18T01:05:05-07:00
[INFO] Final Memory: 40M/198M
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21

恭喜，构建成功了。

  • 我们执行docker images 会发现该镜像已经被构建成功：
REPOSITORY                      TAG                 IMAGE ID            CREATED              SIZE
microservice-discovery-eureka   latest              d57b027ca65a        About a minute ago   681.5 MB
 
 
  • 1
  • 2
  • 启动镜像
docker run -p 8761:8761 microservice-discovery-eureka
 
 
  • 1

我们会发现该Docker镜像会很快地启动。

  • 访问测试

访问http://Docker宿主机IP:8761 ，能够正常看到Eureka界面。

使用Dockerfile进行构建

上文讲述的方式是最简单的方式，很多时候，我们还是要借助Dockerfile进行构建的，首先我们在/microservice-discovery-eureka/src/main/docker目录下，建立文件Dockerfile

FROM java:8
VOLUME /tmp
ADD microservice-discovery-eureka-0.0.1-SNAPSHOT.jar app.jar
RUN bash -c 'touch /app.jar'
EXPOSE 9000
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

修改pom.xml

<build>
        <plugins>
            <!-- docker的maven插件，官网：https://github.com/spotify/docker-maven-plugin -->
            <plugin>
                <groupId>com.spotify</groupId>
                <artifactId>docker-maven-plugin</artifactId>
                <version>0.4.12</version>
                <configuration>
                    <!-- 注意imageName一定要是符合正则[a-z0-9-_.]的，否则构建不会成功 -->
                    <!-- 详见：https://github.com/spotify/docker-maven-plugin    Invalid repository name ... only [a-z0-9-_.] are allowed-->
                    <imageName>microservice-discovery-eureka-dockerfile</imageName>
                    <!-- 指定Dockerfile所在的路径 -->
                    <dockerDirectory>${project.basedir}/src/main/docker</dockerDirectory>
                    <resources>
                        <resource>
                            <targetPath>/</targetPath>
                            <directory>${project.build.directory}</directory>
                            <include>${project.build.finalName}.jar</include>
                        </resource>
                    </resources>
                </configuration>
            </plugin>
        </plugins>
    </build>
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24

其他步骤一样。这样即可使用Dockerfile进行构建Docker镜像啦。

将Docker镜像push到DockerHub上

  • 首先修改Maven的全局配置文件settings.xml，添加以下段落
<servers>
  <server>
    <id>docker-hub</id>
    <username>你的DockerHub用户名</username>
    <password>你的DockerHub密码</password>
    <configuration>
      <email>你的DockerHub邮箱</email>
    </configuration>
  </server>
</servers>
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 在DockerHub上创建repo,例如：test，如下图

DockerHub

  • 项目pom.xml修改为如下：注意imageName的路径要和repo的路径一致
<build>
        <plugins>
            <!-- docker的maven插件，官网：https://github.com/spotify/docker-maven-plugin -->
            <plugin>
                <groupId>com.spotify</groupId>
                <artifactId>docker-maven-plugin</artifactId>
                <version>0.4.12</version>
                <configuration>
                    <!-- 注意imageName一定要是符合正则[a-z0-9-_.]的，否则构建不会成功 -->
                    <!-- 详见：https://github.com/spotify/docker-maven-plugin Invalid repository 
                        name ... only [a-z0-9-_.] are allowed -->
                    <!-- 如果要将docker镜像push到DockerHub上去的话，这边的路径要和repo路径一致 -->
                    <imageName>eacdy/test</imageName>
                    <!-- 指定Dockerfile所在的路径 -->
                    <dockerDirectory>${project.basedir}/src/main/docker</dockerDirectory>
                    <resources>
                        <resource>
                            <targetPath>/</targetPath>
                            <directory>${project.build.directory}</directory>
                            <include>${project.build.finalName}.jar</include>
                        </resource>
                    </resources>
                    <!-- 以下两行是为了docker push到DockerHub使用的。 -->
                    <serverId>docker-hub</serverId>
                    <registryUrl>https://index.docker.io/v1/</registryUrl>
                </configuration>
            </plugin>
        </plugins>
    </build>
 
 
  • 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
  • 执行命令：
mvn clean package docker:build  -DpushImage
 
 
  • 1
  • 搞定，等构建成功后，我们会发现Docker镜像已经被push到DockerHub上了。

将镜像push到私有仓库

在很多场景下，我们需要将镜像push到私有仓库中去，这边为了讲解的全面性，私有仓库采用的是配置登录认证的私有仓库。

  • 和push镜像到DockerHub中一样，我们首先需要修改Maven的全局配置文件settings.xml，添加以下段落
<servers>
  <server>
    <id>docker-registry</id>
    <username>你的DockerHub用户名</username>
    <password>你的DockerHub密码</password>
    <configuration>
      <email>你的DockerHub邮箱</email>
    </configuration>
  </server>
</servers>
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 将项目的pom.xml改成如下，
<plugin>
  <groupId>com.spotify</groupId>
  <artifactId>docker-maven-plugin</artifactId>
  <version>0.4.12</version>
  <configuration>
    <!-- 路径为：私有仓库地址/你想要的镜像路径 -->
    <imageName>reg.itmuch.com/test-pull-registry</imageName>
    <dockerDirectory>${project.basedir}/src/main/docker</dockerDirectory>

    <resources>
      <resource>
        <targetPath>/</targetPath>
        <directory>${project.build.directory}</directory>
        <include>${project.build.finalName}.jar</include>
      </resource>
    </resources>

    <!-- 与maven配置文件settings.xml一致 -->
    <serverId>docker-registry</serverId>
  </configuration>
</plugin>
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 执行：
mvn clean package docker:build  -DpushImage
 
 
  • 1

稍等片刻，将会push成功。

  • 如果想要从私服上下载该镜像，执行：
docker login reg.itmuch.com  # 然后输入账号和密码
docker pull reg.itmuch.com/test-pull-registry
 
 
  • 1
  • 2

将插件绑定在某个phase执行

在很多场景下，我们有这样的需求，例如执行mvn clean package 时，自动地为我们构建docker镜像，可以吗？答案是肯定的。我们只需要将插件的goal 绑定在某个phase即可。

所谓的phase和goal，可以这样理解：maven命令格式是：mvn phase:goal ，例如mvn package docker:build 那么，package 和docker 都是phase，build 则是goal 。

下面是示例：

首先配置属性：

<properties>
  <docker.image.prefix>reg.itmuch.com</docker.image.prefix>
</properties>
 
 
  • 1
  • 2
  • 3

插件配置：

  <build>
    <plugins>
      <plugin>
        <groupId>com.spotify</groupId>
        <artifactId>docker-maven-plugin</artifactId>
        <executions>
          <execution>
            <id>build-image</id>
            <phase>package</phase>
            <goals>
              <goal>build</goal>
            </goals>
          </execution>
        </executions>
        <configuration>
          <imageName>${docker.image.prefix}/${project.artifactId}</imageName>
          <baseImage>java</baseImage>
          <entryPoint>["java", "-jar", "/${project.build.finalName}.jar"]</entryPoint>
          <resources>
            <resource>
              <targetPath>/</targetPath>
              <directory>${project.build.directory}</directory>
              <include>${project.build.finalName}.jar</include>
            </resource>
          </resources>
        </configuration>
      </plugin>
    </plugins>
  </build>
 
 
  • 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

如上，我们只需要添加：

        <executions>
          <execution>
            <id>build-image</id>
            <phase>package</phase>
            <goals>
              <goal>build</goal>
            </goals>
          </execution>
        </executions>
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

即可。本例指的是讲docker的build目标，绑定在package这个phase上。也就是说，用户只需要执行mvn package ，就自动执行了mvn docker:build 。

常见异常

连接不上2375（一般在Win7上出现）

Connect to localhost:2375 [localhost/127.0.0.1, localhost/0:0:0:0:0:0:0:1] failed: Connection refused: connect -> [Help 1]
 
 
  • 1

解决步骤：

  • 输入docker-machine env
$Env:DOCKER_TLS_VERIFY = "1"
$Env:DOCKER_HOST = "tcp://192.168.99.100:2376"
$Env:DOCKER_CERT_PATH = "C:\Users\Administrator\.docker\machine\machines\default
 
 
  • 1
  • 2
  • 3
  • 为插件添加配置
<!-- 解决Connect to localhost:2375的问题的其中一种方式，注意要跟docker-machine env相一致 -->
<dockerHost>https://192.168.99.100:2376</dockerHost>                <dockerCertPath>C:\Users\Administrator\.docker\machine\machines\default</dockerCertPath>
 
 
  • 1
  • 2

修改后插件配置变为：

<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <version>0.4.12</version>
    <configuration>
        <imageName>eacdy/test</imageName>
        <dockerDirectory>${project.basedir}/src/main/docker</dockerDirectory>

        <!-- 解决Connect to localhost:2375的问题的其中一种方式，注意要跟docker-machine env相一致 -->
        <dockerHost>https://192.168.99.100:2376</dockerHost>
        <dockerCertPath>C:\Users\Administrator\.docker\machine\machines\default</dockerCertPath>
        <resources>
            <resource>
                <targetPath>/</targetPath>
                <directory>${project.build.directory}</directory>
                <include>${project.build.finalName}.jar</include>
            </resource>
        </resources>
        <!-- 以下两行是为了docker push到DockerHub使用的。 -->
        <serverId>docker-hub</serverId>
        <registryUrl>https://index.docker.io/v1/</registryUrl>
    </configuration>
</plugin>
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23

TIPS

  1. imageName必须符合正则[a-z0-9-_.]，否则将会构建失败
  2. 插件默认使用localhost:2375去连接Docker，如果你的Docker端口不是2375，需要配置环境变量DOCKER_HOST=tcp://<host>:2375

代码地址（任选其一）

https://git.oschina.net/itmuch/spring-cloud-study/tree/master/docker/microservice-discovery-eureka 
https://github.com/eacdy/spring-cloud-study/tree/master/docker/microservice-discovery-eureka

参考文档

http://developer.51cto.com/art/201404/434879.htm 
https://linux.cn/article-6131-rss.html

Docker＞07 - 使用Maven构建Docker镜像
cp026la的博客
01-28 952
扯淡： 前面章节，使用 Dockerfile 构建了自己的镜像，但是在企业微服务开发中，微服务的数量是非常多的，如果将服务一个一个的上传到宿主机、编写Dockerfile，然后使用 docker build 命令构建镜像，效率是非常低的。本章将介绍使用 Maven 插件构建镜像。 个人学习总结： 链接：【springboot、springcloud、docker 等，学习目录】 准备...
使用maven插件构建docker镜像、上传镜像
逆流而上的博客
12-26 8200
一、添加maven插件 在pom.xml文件 中添加docker的插件。 <plugins> <plugin> <groupId>com.spotify</groupId> <artifactId>docker-maven-plugin</artifactId> <version>0....
Docker系列教程12-使用Maven插件构建Docker镜像
weixin_33690367的博客
03-21 362
原文：http://www.itmuch.com/docker/12-docker-maven/ 我们知道，Maven是一个强大的项目管理与构建工具。如果可以使用Maven构建Docker镜像，那么我们的工作就能得到进一步的简化。 经过调研，以下几款Maven的Docker插件进入笔者视野，如表13-1所...
Maven详解
最新发布
琴智冰
09-16 4478
Maven是Apache旗下的一个开源项目，是一款用于管理和构建java项目的工具。它基于项目对象模型(Project Object Model , 简称: POM)的概念，通过一小段描述信息来管理项目的构建、报告和文档。Apache 软件基金会，成立于1999年7月，是目前世界上最大的最受欢迎的开源软件基金会，也是一个专门为支持开源项目而生的非盈利性组织。Maven的作用：方便的依赖管理统一的项目结构标准的项目构建流程依赖管理方便快捷的管理项目依赖的资源(jar包)，避免版本冲突问题。
DockerMaven插件快速部署微服务
qq_40794266的博客
11-07 828
1.为什么要学习DockerMaven插件? 因为当微服务过多,手动拷贝war包上传到服务器并拷贝jdk的容器,会非常麻烦,同时也会很容易出错..所以学习dockermaven来自动部署微服务,从而避免这一系列问题.....   2.maven插件自动部署步骤 1.修改宿主机的配置,让其可以远程访问 vi /lib/systemd/system/docker.service 添加...
docker-maven-plugin的pom配置
学亮编程手记
07-15 1254
<build> <plugins> <!--maven docker插件--> <plugin> <groupId>com.spotify</groupId> <artifactId>docker-maven-plugin</artifactId> <version>${docker.mav
idea使用docker-maven-plugin插件将项目编译为docker镜像到远程linux服务器
weixin_34364135的博客
03-11 2640
2019独角兽企业重金招聘Python工程师标准>>> ...
浅谈使用Maven插件构建Docker镜像的方法
08-28
本篇文章主要介绍了浅谈使用Maven插件构建Docker镜像的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
通过Maven插件构建docker镜像并上传到服务器
weixin_43887184的博客
04-13 1679
1. 微服务部署有两种方法: (1) 手动部署: 首先基于源码打包生成jar包 (或war包), 将jar包 (或war包) 上传至虚拟机并拷贝至JDK容器. (2) 通过Maven插件自动部署 2.Maven插件自动部署步骤: (1) 修改宿主机的docker配置, 让其可以远程访问 vim /lib/systemd/system/docker.service 其中ExecStart=后添加配置-H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock 修改
SpringBoot项目使用docker-maven-plugin插件构建docker镜像以及推送到docker hub或docker registry私服
fly_duck的博客
10-17 4048
本文介绍的方式是使用docker-maven-plugin的方式构建SpringBoot的docker镜像以及推送到私服或docker hub服务器上。
【docker系列】mvn使用docker build构建镜像
Think_and_work的博客
04-10 5803
大家好，我是walker 一个从文科自学转行的程序员~ 爱好编程，偶尔写写编程文章和生活 欢迎关注公众号【I am Walker】，可以获取相关的学习资料哦 我的gitee：https://gitee.com/shen-chuhao/walker.git 里面很多技术案例！ 参考： 使用Maven构建Docker镜像 前提条件 1、确保创建一个springboot项目，一个简单项目即可 2、该操作是在linux上运行的，所以要确保linux有安装 maven：用来编译镜像 docker：用来构建镜像.
【Spring Cloud项目&JCE相关】 记一次mvn docker:build 失败
Noobi的博客
09-20 1548
【Spring Cloud项目&JCE相关】 记一次mvn docker:build 失败 最近在学Spring微服务，用的书是Carnell的Spring in Action 小插曲 在构建代码时， 示例代码用的是jdk8，而我的是jdk13 在jdk13中（自从jdk11）去除了javax.activation库 于是报了找不到DataSource类的错，更换jdk8解决 关于JCE 执行 mvn clean package docker:build 后，出现问题 在dockerFile的脚.
Maven打包docker镜像并发布（二）
轰轰烈烈的生活
01-31 1000
docker spring boot 打包镜像并发布到nexus上。
docker maven打包build
做你想做的人，没有时间的限制，只要愿意，什么时候都可以start。
12-14 886
<build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin>
六使用Maven插件构建Docker镜像
itScholar001的博客
01-22 1756
我们知道，Maven是一个强大的项目管理与构建工具。如果可以使用Maven构建Docker镜像，那么我们的工作就能得到进一步的简化。经过调研，以下几款Maven的Docker插件进入笔者视野，如表13-1所示。表13-1 Maven的Docker插件列表笔者从各项目的功能性、文档易用性、更新频率、社区活跃度、Stars等几个纬度考虑，选用了第一款。这是一款由Spotify公司开发的Maven插件。下面我们来详细探讨如何使用Maven插件构建Docker镜像。
使用Maven插件自动化构建Docker镜像
"这篇文章主要讲解了如何使用Maven插件构建Docker镜像，通过详细的步骤和示例代码，为开发者提供了实现这一过程的指导。文章指出，在微服务架构下，服务部署和管理的复杂性增加，而通过自动化流程如Jenkins与Maven的...
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值