Spring Boot + 外置tomcat + docker 打包部署

luckyharry4 2019-11-23

java docker Apache spring tomcat 镜像 Maven springboot class scope Deploy

前言

最近这段时间在做一个有关于"Docker Graceful shutdown",于是自己就开始做起了各种"小实验"。

虽然说过程有点痛苦,但是结果总是好的,让我对于docker有了一些新的认识。

正文

言归正传,今天我们的主题是Spring Boot + 外置tomcat + Docker,然后用做好的镜像可以去做部署。

我们需要修改两大块的地方:

  1. Spring boot
  2. Docker

我并不是把tomcat落下了。原因是我们可以让docker引用tomcat的镜像。


首先我们来改造Spring boot 项目,让他"摆脱"内置的tomcat

pom.xml:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.demo</groupId>
    <artifactId>externaltomcattest</artifactId>
    <version>1.0</version>
    <packaging>war</packaging>
    <name>externaltomcattest</name>
    <description>This project is used to test graceful shutdown, and use external tomcat</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                  <!--这个地方时摆脱tomcat的关键-->
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-tomcat</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>ch.qos.logback</groupId>
                    <artifactId>logback-classic</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>ch.qos.logback</groupId>
                    <artifactId>logback-core</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

      <!--将tomcat的scope的作用域设置为provided,这个地方和上面说的那个exclusion里面其实选其一就行-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

启动类:

package com.demo.externaltomcattest;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class ExternaltomcattestApplication {

    public static void main(String[] args) {
        SpringApplication.run(ExternaltomcattestApplication.class, args);
    }

}

和启动类同级的地方,我们添加上这样一个类,名字叫做ServletInitializer:

package com.demo.externaltomcattest;

import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

public class ServletInitializer extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(ExternaltomcattestApplication.class);
    }

}

关键就是以上三步。

有不懂的可以参考我的github:https://github.com/luckypoison/SpringBootTomcatExternalTest

️只需要注意上面我说的那几个地方就行,剩下的是我为了做grace-shutdown测试用的‍️。


接下来我们需要打出来一个war包用于部署,不知道何为war包的,可以去自行搜索。

使用下面的命令进行打包:

mvn clean package

然后我们就可以在当前项目目录下面的target目录下面找到war包了。


在接下来我们就应该在一个空的文件夹下面,放上dockerfile,和我们的war包。

Dockerfile内容如下:

FROM tomcat:9.0

COPY externaltomcattest-1.0.war /usr/local/tomcat/webapps 

EXPOSE 8080

CMD ["catalina.sh", "run"]

下面做一下基本的讲解:

  1. FROM 指令告诉我们需要使用的Docker应该使用哪一个basic的镜像
  2. 拷贝我们的war包到docker中的tomcat的一个路径下。
  3. 暴露8080端口
  4. 启动tomcat

然后使用下面的命令进行构建:

首先我们需要进到刚刚我们新创建的文件夹下面。

docker build -t external-tomcat-test:1.0 .

-t 后面跟着的是我们需要打包出来的镜像的名字和版本号。

️后面的"."是不可以缺少的。

然后使用下面的命令,如果里面有我们刚刚打包出来的镜像,证明我们构建成功:

docker images

最后启动就可以了。

docker run -p 8080:8080 <imageId>

如果有需要可以把构建镜像和启动放在需要的地方。

后记

这是一个简单的例子,如果对docker上有什么知道的命令可以去官网进行查询:

https://docs.docker.com/engine/reference/run/

如果遇到了什么问题,可以在下方评论区告诉我们,我会尽量进行解答。

登录 后评论
下一篇
云栖号资讯小编
1486人浏览
2020-05-25
相关推荐
SpringBoot相关
1513人浏览
2017-12-30 14:44:14
SpringBoot热部署加持
2263人浏览
2018-06-23 08:33:14
Spring Boot Admin 2.0开箱体验
3879人浏览
2018-07-18 08:43:21
gradle build docker image
1529人浏览
2018-03-19 23:23:00
0
0
0
1044