一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]

idea (35) 2023-03-24 22:20

大家好,我是编程小6,很高兴遇见你,有问题可以及时留言哦。

不知道各位小伙伴在生产环境都是怎么部署 Spring Boot 的,打成 jar 直接一键运行?打成 war 扔到 Tomcat 容器中运行?不过据松哥了解,容器化部署应该是目前的主流方案。

不同于传统的单体应用,微服务由于服务数量众多,在部署的时候出问题的可能性更大,这个时候,结合 Docker 来部署,就可以很好的解决这个问题,这也是目前使用较多的方案之一。

将 Spring Boot 项目打包到 Docker 容器中部署,有很多不同的方法,今天松哥主要来和大家聊一聊如何将 Spring Boot 项目一键打包到远程 Docker 容器,然后通过运行一个镜像的方式来启动一个 Spring Boot 项目。

至于其他的 Spring Boot 结合 Docker 的用法,大家不要着急,后续的文章,松哥会和大家慢慢的一一道来。

1.准备工作

1.1 准备 Docker

我这里以 CentOS7 为例来给大家演示。

首先需要在 CentOS7 上安装好 Docker,这个安装方式网上很多,我就不多说了,我自己去年写过一个 Docker 入门教程,大家可以在公众号后台回复 Docker 获取教程下载地址。

Docker 安装成功之后,我们首先需要修改 Docker 配置,开启允许远程访问 Docker 的功能,开启方式很简单,修改 /usr/lib/systemd/system/docker.service 文件,加入如下内容:

-H tcp://0.0.0.0:2375  -H unix:///var/run/docker.sock

如下图:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第1张

配置完成后,保存退出,然后重启 Docker:

systemctl daemon-reload    
service docker restart 

Docker 重启成功之后,Docker 的准备工作就算是 OK 了。

1.2 准备 IDEA

IDEA 上的准备工作,主要是安装一个 Docker 插件,点击 File->Settings->Plugins->Browse Repositories 如下:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第2张

点击右边绿色的 Install 按钮,完成安装,安装完成之后需要重启一下 IDEA。

IDEA 重启成功之后,我们依次打开 File->Settings->Build,Execution,Deployment->Docker ,然后配置一下 Docker 的远程连接地址:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第3张

配置一下 Docker 的地址,配置完成后,可以看到下面有一个 Connection successful 提示,这个表示 Docker 已经连接上了。

如此之后,我们的准备工作就算是 OK 了。

2.准备项目

接下来我们来创建一个简单的 Spring Boot 项目(只需要引入 spring-boot-starter-web 依赖即可),项目创建成功之后,我们再创建一个普通的 HelloDockerController,用来做测试,如下:

@RestController
public class HelloDockerController {
    @GetMapping("/hello")
    public String hello() {
        return "hello docker!";
    }
}

这是一个很简单的接口,无需多说。

3.配置 Dockerfile

接下来,在项目的根目录下,我创建一个 Dockerfile ,作为我镜像的构建文件,具体位置如下图:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第4张

文件内容如下:

FROM hub.c.163.com/library/java:latest
VOLUME /tmp
ADD target/docker-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

这里只有简单的四行,我说一下:

  1. Spring Boot 项目的运行依赖 Java 环境,所以我自己的镜像基于 Java 镜像来构建。
  2. 考虑到 Docker 官方镜像下载较慢,我这里使用了网易提供的 Docker 镜像。
  3. 由于 Spring Boot 运行时需要 tmp 目录,这里数据卷配置一个 /tmp 目录出来。
  4. 将本地 target 目录中打包好的 .jar 文件复制一份新的 到 /app.jar。
  5. 最后就是配置一下启动命令,由于我打包的 jar 已经成为 app.jar 了,所以启动命令也是启动 app.jar。

这是我们配置的一个简单的 Dockerfile。

4.配置 Maven 插件

接下来在 pom.xml 文件中,添加如下插件:

<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <version>1.2.0</version>
    <executions>
        <execution>
            <id>build-image</id>
            <phase>package</phase>
            <goals>
                <goal>build</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <dockerHost>http://192.168.66.131:2375</dockerHost>
        <imageName>javaboy/${project.artifactId}</imageName>
        <imageTags>
            <imageTag>${project.version}</imageTag>
        </imageTags>
        <forceTags>true</forceTags>
        <dockerDirectory>${project.basedir}</dockerDirectory>
        <resources>
            <resource>
                <targetPath>/</targetPath>
                <directory>${project.build.directory}</directory>
                <include>${project.build.finalName}.jar</include>
            </resource>
        </resources>
    </configuration>
</plugin>

这个插件的配置不难理解:

  1. 首先在 execution 节点中配置当执行 mvn package 的时候,顺便也执行一下 docker:build
  2. 然后在 configuration 中分别配置 Docker 的主机地址,镜像的名称,镜像的 tags,其中 dockerDirectory 表示指定 Dockerfile 的位置。
  3. 最后 resource 节点中再配置一下 jar 的位置和名称即可。

OK,做完这些我们就算大功告成了。

5.打包运行

接下来对项目进行打包,打包完成后,项目会自动构建成一个镜像,并且上传到 Docker 容器中,打包方式如下:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第5张

打包过程会稍微有一点旧,因为还包含了镜像的构建,特别是第一次打包,需要下载基础镜像,会更慢一些。

部分打包日志如下(项目构建过程):

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第6张

项目打包成功之后,我们就可以在 Docker 容器中看到我们刚刚打包成的镜像了,如下:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第7张

5.1 运行方式一

此时,我们可以直接在 Linux 上像创建普通容器一样创建这个镜像的容器,然后启动,执行如下命令即可:

docker run -d --name javaboy -p 8080:8080 javaboy/docker:0.0.1

启动成功之后,我们就可以访问容器中的接口了。

但是这种操作显然还是有点麻烦,结合我们一开始安装的 Docker 插件,这个运行步骤还可以做进一步的简化。

5.2 运行方式二

大家注意,此时我们的 IDEA 中多了一个选项,就是 docker,如下:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第8张

点击左边的绿色启动按钮,连接上 Docker 容器,连接成功之后,我们就可以看到目前 Docker 中的所有容器和镜像了,当然也包括我们刚刚创建的 Docker 镜像,如下:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第9张

此时,我们选中这个镜像,右键单击,即可基于此镜像创建出一个容器,如下图:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第10张

我们选择 Create container,然后填入容器的一些必要信息,配置一下容器名称,镜像 ID 会自动填上,暴露的端口使用 Specify 即可,然后写上端口的映射关系:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第11张

配置完成后,点击下方的 run 按钮,就可以开始运行了。运行日志如下:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第12张

注意,这个日志是在 Docker 的那个窗口里打印出来的。

项目运行成功之后,在浏览器输入远程服务器的地址,就可以访问了:

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第13张

如此之后,我们的 Spring Boot 项目就算顺利发布到远程 Docker 容器中了。

好玩吗?试试!

本文案例我已经上传到 GitHub,小伙伴们可以参考:github.com/lenve/javab…

一键部署 Spring Boot 到远程 Docker 容器,就是这么秀![通俗易懂]_https://bianchenghao6.com/blog_idea_第14张

发表回复