Docker系列-第七篇Docker构建SpringBoot应用

时间：2022-03-24 04:24:46

1.基于Dockerfile构建SpringBoot镜像

1.1准备工作

将SpringBoot项目通过maven打成jar包

mvn clean package #使用maven打包项目

1.2使用Dockerfile构建镜像

  • step1 在存放jar所在目录下创建Dockerfile文件

    touch Dockerfile

  • step2 编辑Dockerfile增加以下内容

    FROM java:8
    
MAINTAINER  niugang<863263957@qq.com>
    
RUN mkdir -p /opt/springapp
    
ADD   demo-0.0.1.jar  /opt/springapp
    
EXPOSE 8088
    
ENTRYPOINT ["java","-jar","/opt/springapp/demo-0.0.1.jar"]

  • step3 构建镜像

    docker build -t springbootdemo:1.0 .

  • step4 启动容器

    docker run -d  -p 8088:8088 --name sb springbootdemo:1.0

    在启动容器是可以添加数据卷，程序日志映射到宿主机，方便后期排查问题

    注意：在启动过程中，一直起不起来，然后通过前台启动查看了日志。

    报了如下错误：

    WARNING: IPv4 forwarding is disabled. Networking will not work.

    解决：

    #需要做如下配置

    解决办法：

    vim/etc/sysctl.conf

    net.ipv4.ip_forward=1 #添加这段代码

    #重启network服务

    systemctl restart network && systemctl restart docker

    #查看是否修改成功 （备注：返回1，就是成功）

    [root@docker-node2 ~]# sysctl net.ipv4.ip_forward

    net.ipv4.ip_forward = 1

  • step5 调用你的springboot应用，验证其是否正确

2.使用Maven插件构建Docker镜像

Maven是一个强大的项目管理与构建工具。如果可以使用Maven构建Docker镜像，以下几款Maven的Docker插件比较常用。

插件名称 官方地址

docker-maven-plugin https://github.com/spotify/docker-maven-plugin

上面插件可以从github看到此插件已经不再推荐了。推荐使用

https://github.com/spotify/dockerfile-maven 具体操作步骤上面有介绍

docker-maven-plugin https://github.com/fabric8io/docker-maven-plugin

docker-maven-plugin https://github.com/bibryam/docker-maven-plugin

2.1直接配置方式

  • step 1

    在你的springboot应用的pom.xml中增加如下配置

     <plugin>
    
                <groupId>com.spotify</groupId>
    
                <artifactId>docker-maven-plugin</artifactId>
    
                <version>0.4.13</version>
    
                <configuration>
    
                    <!--用于指定镜像名称-->
    
                    <imageName>niugang/springboot:3.0</imageName>
    
                    <!--用于指定基础镜像，类似于Dockerfile中的FROM指令。-->
    
                    <baseImage>java</baseImage>
    
                    <!--类似于Dockerfile的ENTRYPOINT指令-->
    
                    <entryPoint>["java", "-jar", "/${project.build.finalName}.jar"]</entryPoint>
    
                    <resources>
    
                        <resource>
    
                            <!--将打包后的资源文件复制到该目录-->
    
                            <targetPath>/</targetPath>
    
                            <!--需要复制的文件所在目录，maven打包的应用jar包保存在target目录下面-->
    
                            <directory>${project.build.directory}</directory>
    
                            <!--需要复制的文件，打包好的应用jar包。-->
    
                            <include>${project.build.finalName}.jar</include>
    
                        </resource>
    
                    </resources>
    
                </configuration>
    
            </plugin>l

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

    • imageName：用于指定镜像名称，其中niugang是仓库名称，springboot是镜像名称，3.0是标签名称
    • baseImage：用于指定基础镜像，类似于Dockerfile中的FROM指令。
    • entrypoint：类似于Dockerfile的ENTRYPOINT指令。
    • resources.resource.directory：用于指定需要复制的根目录，${project.build.directory}表示target目录。
    • resources.resource.include：用于指定需要复制的文件。${project.build.finalName}.jar指的是打包后的jar包文件。

  • step2 进入代码路径下，执行如下命令

    mvn clean package docker:build

  • step3 查看镜像

    Docker系列-第七篇Docker构建SpringBoot应用

  • step4 启动容器

    docker run  -d -p 8088:8088 --name myspringboot niugang/springboot:3.0

  • step5 访问测试

2.2 读取Dockerfile进行构建

在2.1中只需要在pom.xm中配置，执行命令就可以生成docker镜像。在很多时候希望通过Dockerfile生成Docker镜像。

  • step1 在项目src/main/resources目录下新建docker文件夹,在文件夹下新建Dockerfile文件，增加如下内容：
FROM java:8

MAINTAINER niugang<863263957@qq.com>

RUN  mkdir -p /docker/images

ADD demo-0.0.1-SNAPSHOT.jar /docker/images

ENTRYPOINT ["java","-jar","/docker/images/demo-0.0.1-SNAPSHOT.jar"]

  • step2 pom.xml修改为如下

     <plugin>
    
                <groupId>com.spotify</groupId>
    
                <artifactId>docker-maven-plugin</artifactId>
    
                <version>0.4.13</version>
    
                <configuration>
    
                    <!--用于指定镜像名称-->
    
                    <imageName>niugang/springboot:4.0</imageName>             <dockerDirectory>${project.basedir}/src/main/resources/docker</dockerDirectory>
    
                    <resources>
    
                        <resource>
    
                            <!--将打包后的资源文件复制到该目录-->
    
                            <targetPath>/</targetPath>
    
                            <!--需要复制的文件所在目录，maven打包的应用jar包保存在target目录下面-->
    
                            <directory>${project.build.directory}</directory>
    
                            <!--需要复制的文件，打包好的应用jar包。-->
    
                            <include>${project.build.finalName}.jar</include>
    
                        </resource>
    
                    </resources>
    
                </configuration>
    
            </plugin>

    可以看到，不再制定baseImage和entrypoint，而是使用dockerDirectory指定Dockerfile所在路径。即时指定了baseImage和entrypoint也将被忽略。

  • step2 进入代码路径下，执行如下命令

mvn clean package docker:build
  • 查看镜像
docker images

Docker系列-第七篇Docker构建SpringBoot应用

  • step4 启动容器

    docker run  -d -p 8088:8088 --name myspringboot niugang/springboot:4.0

  • step5 访问测试

2.3 将插件绑定在某个phase执行

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

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

  • step1 编辑pom.xml 内容如下

    <plugin>
    
                <groupId>com.spotify</groupId>
    
                <artifactId>docker-maven-plugin</artifactId>
    
                <version>0.4.13</version>
    
               <executions>
    
                   <execution>
    
                       <id>build-images</id>
    
                       <phase>package</phase>
    
                       <goals>
    
                           <goal>build</goal>
    
                       </goals>
    
                   </execution>
    
               </executions>
    
                <configuration>
    
                    <!--用于指定镜像名称-->
    
                    <imageName>niugang/springboot:5.0</imageName>                    <dockerDirectory>${project.basedir}/src/main/resources/docker</dockerDirectory>
    
                    <resources>
    
                        <resource>
    
                            <!--将打包后的资源文件复制到该目录-->
    
                            <targetPath>/</targetPath>
    
                            <!--需要复制的文件所在目录，maven打包的应用jar包保存在target目录下面-->
    
                            <directory>${project.build.directory}</directory>
    
                            <!--需要复制的文件，打包好的应用jar包。-->
    
                            <include>${project.build.finalName}.jar</include>
    
                        </resource>
    
                    </resources>
    
                </configuration>
    
            </plugin>

  • step2进入代码路径下，执行如下命令

mvn clean package
  • step3 查看镜像

Docker系列-第七篇Docker构建SpringBoot应用

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

<executions>

  <execution>

    <id>build-image</id>

    <phase>package</phase>

    <goals>

      <goal>build</goal>

    </goals>

  </execution>

</executions>

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

微信公众号

Docker系列-第七篇Docker构建SpringBoot应用

JAVA程序猿成长之路

分享资源，记录程序猿成长点滴。专注于Java,Spring,SpringBoot,SpringCloud，分布式，微服务。

相关文章