AI 助理
备案控制台登录注册
开发者社区 开发与运维 文章 正文

Docker系列教程12-使用Maven插件构建Docker镜像

2018-03-21 3673
版权
举报
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 原文：http://www.itmuch.com/docker/12-docker-maven/我们知道，Maven是一个强大的项目管理与构建工具。

原文：http://www.itmuch.com/docker/12-docker-maven/

我们知道，Maven是一个强大的项目管理与构建工具。如果可以使用Maven构建Docker镜像，那么我们的工作就能得到进一步的简化。

经过调研，以下几款Maven的Docker插件进入笔者视野，如表13-1所示。

插件名称 官方地址
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

表13-1 Maven的Docker插件列表

笔者从各项目的功能性、文档易用性、更新频率、社区活跃度、Stars等几个纬度考虑，选用了第一款。这是一款由Spotify公司开发的Maven插件。

下面我们来详细探讨如何使用Maven插件构建Docker镜像。

快速入门

以项目microservice-discovery-eureka 为例。

(1) 在pom.xml中添加Maven的Docker插件。

<plugin>
  <groupId>com.spotify</groupId>
  <artifactId>docker-maven-plugin</artifactId>
  <version>0.4.13</version>
  <configuration>
    <imageName>itmuch/microservice-discovery-eureka:0.0.1</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>


        

          
        

        
        

          

          AI 代码解读

简要说明一下插件的配置：

① imageName：用于指定镜像名称，其中itmuch是仓库名称，microservice-discovery-eureka是镜像名称，0.0.1是标签名称。

② baseImage：用于指定基础镜像，类似于Dockerfile中的FROM指令。

③ entrypoint：类似于Dockerfile的ENTRYPOINT指令。

④ resources.resource.directory：用于指定需要复制的根目录，${project.build.directory}表示target目录。

⑤ resources.resource.include：用于指定需要复制的文件。${project.build.finalName}.jar指的是打包后的jar包文件。

(2) 执行以下命令，构建Docker镜像。

mvn clean package docker:build


        

          
        

        
        

          

          AI 代码解读

我们会发现终端输出类似于如下的内容：

[INFO] Building image itmuch/microservice-discovery-eureka:0.0.1
Step 1 : FROM java
 ---> 861e95c114d6
Step 2 : ADD /microservice-discovery-eureka-0.0.1-SNAPSHOT.jar //
 ---> 035a03f5b389
Removing intermediate container 2b0e70056f1d
Step 3 : ENTRYPOINT java -jar /microservice-discovery-eureka-0.0.1-SNAPSHOT.jar
 ---> Running in a0149704b949
 ---> eb96ca1402aa
Removing intermediate container a0149704b949
Successfully built eb96ca1402aa


        

          
        

        
        

          

          AI 代码解读

由以上日志可知，我们已成功构建了一个Docker镜像。

(3)执行 docker images 命令，即可查看刚刚构建的镜像。

REPOSITORY                             TAG        IMAGE ID          CREATED             SIZE
itmuch/microservice-discovery-eureka   0.0.1      eb96ca1402aa      39 seconds ago      685 MB


        

          
        

        
        

          

          AI 代码解读

(4) 启动镜像

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


        

          
        

        
        

          

          AI 代码解读

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

(5) 访问测试

访问http://Docker宿主机IP:8761 ，能够看到Eureka Server的首页。

插件读取Dockerfile进行构建

之前的示例，我们直接在pom.xml中设置了一些构建的参数。很多场景下，我们希望使用Dockerfile更精确、有可读性地构建镜像。

(1) 首先我们在/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"]


        

          
        

        
        

          

          AI 代码解读

(2) 修改pom.xml

<plugin>
  <groupId>com.spotify</groupId>
  <artifactId>docker-maven-plugin</artifactId>
  <version>0.4.13</version>
  <configuration>
    <imageName>itmuch/microservice-discovery-eureka:0.0.2</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>
  </configuration>
</plugin>


        

          
        

        
        

          

          AI 代码解读

可以看到，我们不再指定baseImage和entrypoint，而是使用dockerDirectory指定Dockerfile所在的路径。这样，我们就可以使用Dockerfile构建Docker镜像了。

将插件绑定在某个phase执行

很多场景下，我们有这样的需求，执行例如mvn clean package 时，插件就自动为我们构建Docker镜像。要想实现这点，我们只需将插件的goal绑定在某个phase即可。

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

<plugin>
  <groupId>com.spotify</groupId>
  <artifactId>docker-maven-plugin</artifactId>
  <version>0.4.13</version>
  <executions>
    <execution>
      <id>build-image</id>
      <phase>package</phase>
      <goals>
        <goal>build</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <imageName>itmuch/microservice-discovery-eureka:0.0.3</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>


        

          
        

        
        

          

          AI 代码解读

由配置可知，我们只需添加如下配置：

<executions>
  <execution>
    <id>build-image</id>
    <phase>package</phase>
    <goals>
      <goal>build</goal>
    </goals>
  </execution>
</executions>


        

          
        

        
        

          

          AI 代码解读

就可将插件绑定在package这个phase上。也就是说，用户只需执行mvn package ，就会自动执行mvn docker:build 。当然，读者也可按照需求，将插件绑定到其他的phase。

推送镜像

前文我们使用docker push 命令实现了镜像的推送，我们也可使用Maven插件推送镜像。我们不妨使用Maven插件推送一个Docker镜像到Docker Hub。

(1) 修改Maven的全局配置文件setttings.xml，在其中添加以下内容，配置Docker Hub的用户信息。

<server>
  <id>docker-hub</id>
  <username>你的DockerHub用户名</username>
  <password>你的DockerHub密码</password>
  <configuration>
    <email>你的DockerHub邮箱</email>
  </configuration>
</server>


        

          
        

        
        

          

          AI 代码解读

(2) 修改pom.xml，示例：

<plugin>
  <groupId>com.spotify</groupId>
  <artifactId>docker-maven-plugin</artifactId>
  <version>0.4.13</version>
  <configuration>
    <imageName>itmuch/microservice-discovery-eureka:0.0.4</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>

    <!-- 与maven配置文件settings.xml中配置的server.id一致，用于推送镜像 -->
    <serverId>docker-hub</serverId>
  </configuration>
</plugin>


        

          
        

        
        

          

          AI 代码解读

如上，添加serverId段落，并引用settings.xml中的server的id即可。

(3) 执行以下命令，添加pushImage的标识，表示推送镜像。

mvn clean package docker:build  -DpushImage


        

          
        

        
        

          

          AI 代码解读

经过一段时间的等待，我们会发现Docker镜像已经被push到Docker Hub了。同理，我们也可推送镜像到私有仓库，只需要将imageName指定成类似于如下的形式即可：

<imageName>localhost:5000/itmuch/microservice-discovery-eureka:0.0.4</imageName>


        

          
        

        
        

          

          AI 代码解读

TIPS

(1) 以上示例中，我们是通过imageName指定镜像名称和标签的，例如：

<imageName>itmuch/microservice-discovery-eureka:0.0.4</imageName>


        

          
        

        
        

          

          AI 代码解读

我们也可借助imageTags元素更为灵活地指定镜像名称和标签，例如：

<configuration>
  <imageName>itmuch/microservice-discovery-eureka</imageName>
  <imageTags>
    <imageTag>0.0.5</imageTag>
    <imageTag>latest</imageTag>
  </imageTags>
  ...
<configuration>


        

          
        

        
        

          

          AI 代码解读

这样就可为同一个镜像指定两个标签。

(2) 我们也可在执行构建命令时，使用dockerImageTags参数指定标签名称，例如：

mvn clean package docker:build -DpushImageTags -DdockerImageTags=latest -DdockerImageTags=another-tag


        

          
        

        
        

          

          AI 代码解读

(3) 如需重复构建相同标签名称的镜像，可将forceTags设为true，这样就会覆盖构建相同标签的镜像。

<configuration>
  <!-- optionally overwrite tags every time image is built with docker:build -->
  <forceTags>true</forceTags>
<configuration>


        

          
        

        
        

          

          AI 代码解读

拓展阅读

(1) Spotify是全球最大的正版流媒体音乐服务平台。

文章标签：
Java
容器
Docker
Maven
Shell
项目管理
数据安全/隐私保护
关键词：
Docker教程
Maven构建
Docker镜像
构建Docker
Docker构建
eacdy0000
+关注
87文章
目录
打赏
0
0
0
0
29
分享
相关文章
nzeberq6lz6ni
|
3月前
|
Docker 容器 Perl
云效flow构建docker镜像更换apt源为阿里镜像源
在 Dockerfile 中添加命令以更换 Debian 源为阿里云镜像，加速容器内软件包下载。核心命令通过 `sed` 实现源地址替换，并更新 apt 软件源。其中 `cat` 命令用于验证替换是否成功，实际使用中可删除该行。
nzeberq6lz6ni
679 32
sunyalei
|
2月前
|
缓存 Shell 网络安全
将应用程序打包成Docker镜像时可能遇到哪些问题？
将应用程序打包成Docker镜像时可能遇到哪些问题？
sunyalei
268 77
鱼的爱情看不出泪水
|
8天前
|
Ubuntu Docker 容器
Ubuntu国内镜像Docker安装详细教程
Ubuntu国内镜像Docker安装详细教程
鱼的爱情看不出泪水
170 4
凤中枫
|
2月前
|
应用服务中间件 Linux nginx
构建包含 nginx_upstream_check_module 的轻量级 Nginx 1.21.5 Docker 镜像
测试
凤中枫
209 31
凤中枫
|
2月前
|
Shell 应用服务中间件 nginx
docker 镜像的部分常用命令
docker镜像常用命令
凤中枫
110 16
凤中枫
|
2月前
|
关系型数据库 MySQL Docker
docker 常用命令大全（基础、镜像、容器、数据卷）
常用docker命令
凤中枫
699 15
蓝易云
|
3月前
|
Ubuntu Linux 网络安全
Ubuntu Docker镜像：支持systemctl、SSH、VNC
总的来说，创建一个支持systemctl、SSH和VNC的Ubuntu Docker镜像需要一些技术知识，但是通过学习和实践，我们可以掌握这些技术。这将使我们能够更有效地使用Docker，更好地管理我们的应用程序和服务。CentOS系统中的日志文件位置和管理
蓝易云
120 17
啦啦啦191
|
2月前
|
Java 测试技术 项目管理
【JavaEE】从 0 到 1 掌握 Maven 构建 Java 项目核心技巧 解锁 Java 项目高效管理实用实例
本文从Maven基础概念讲起，涵盖安装配置、核心概念（如POM与依赖管理）及优化技巧。结合Java Web项目实例，演示如何用Maven构建和管理项目，解决常见问题，助你高效掌握这一强大工具，提升Java开发与项目管理能力。适合初学者及进阶开发者学习。资源链接：[点此获取](https://pan.quark.cn/s/14fcf913bae6)。
啦啦啦191
90 6
m1a6
|
8月前
|
XML Java 测试技术
从零开始学 Maven：简化 Java 项目的构建与管理
Maven 是一个由 Apache 软件基金会开发的项目管理和构建自动化工具。它主要用在 Java 项目中，但也可以用于其他类型的项目。
m1a6
249 1
从零开始学 Maven：简化 Java 项目的构建与管理
2的n次方_
|
9月前
|
Java 关系型数据库 MySQL
Maven——创建 Spring Boot项目
Maven 是一个项目管理工具，通过配置 `pom.xml` 文件自动获取所需的 jar 包，简化了项目的构建和管理过程。其核心功能包括项目构建和依赖管理，支持创建、编译、测试、打包和发布项目。Maven 仓库分为本地仓库和远程仓库，远程仓库包括中央仓库、私服和其他公共库。此外，文档还介绍了如何创建第一个 SpringBoot 项目并实现简单的 HTTP 请求响应。
2的n次方_
626 1
Maven——创建 Spring Boot项目

热门文章

最新文章

  • 1
    Docker镜像加速指南：手把手教你配置国内镜像源
    4337
  • 2
    Docker 架构简述及国内镜像源推荐
    0
  • 3
    Docker化运维：容器部署的实践指南
    19
  • 4
    【Docker项目实战】使用Docker部署Organizr个人导航页
    30
  • 5
    一键部署革命：Docker容器化运维实战指南
    0
  • 6
    Docker与Kubernetes集成挑战及方案
    21
  • 7
    Ubuntu国内镜像Docker安装详细教程
    148
  • 8
    用 Docker 轻松部署 ERPNext 15：多场景实战指南
    42
  • 9
    在Docker容器中部署GitLab服务器的步骤（面向Ubuntu 16.04）
    40
  • 10
    使用Docker Compose工具进行容器编排的教程
    59
  • 1
    Maven依赖冲突解决总结
    197
  • 2
    maven 工程pom依赖优化及常用命令
    168
  • 3
    gradle项目对比maven项目的目录架构以及对gradle wrapper的理解
    138
  • 4
    maven总结三: 常用插件
    132
  • 5
    maven总结二: 常用标签及属性
    89
  • 6
    maven总结一: 常用命令
    86
  • 7
    解决 idea maven plugins 报红波浪线
    1620
  • 8
    idea安装并使用maven依赖分析插件:Maven Helper
    3600
  • 9
    idea导入maven项目结构不全
    378
  • 10
    maven开源仓库
    281

    • 相关课程

    更多
  • 深入解析Docker容器化技术
  • 基于Docker与Jenkins实现自动化部署
  • Docker 快速入门
  • Docker完全自学手册图文教程
  • AI开发者的Docker实践
  • Docker 入门

    • 相关电子书

    更多
  • 应用 Docker 进行持续交付：用技术改变交付路程
  • 从Docker到容器服务
  • 构建基因数据应用生态系统—— docker in Bio/informatics

    • 相关实验场景

    更多
  • 部署并使用Docker（AlibabaCloud Linux 3）
  • Docker镜像管理快速入门
  • Docker Compose部署案例
  • Docker Compose入门
  • 部署并使用Docker（Alibaba Cloud Linux 3）
  • 部署并使用Docker（CentOS 8）

    • 推荐镜像

    更多
  • docker-ce
  • docker-toolbox
  • maven
    • 下一篇
    就是要你懂负载均衡--lvs和转发模式
    目录
    AI助理

    你好，我是AI助理

    可以解答问题、推荐解决方案等

    登录插画

    登录以查看您的控制台资源

    管理云资源
    状态一览
    快捷访问
    快捷注册登录阿里云