使用 Docker 部署 SpringBoot 项目 (Jar 包、War包)

5,142 阅读3分钟

0 环境

Linux:vargrant安装Linux

Docker:Linux安装docker

1 准备工作

  • 首先新建一个 SpringBoot 项目,在 pom.xml 中添加如下依赖:
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
</dependency>
<!--web模块-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.3.3.RELEASE</version>
</dependency>
  • 在 pom.xml 中的 标签中 新增 :
<properties>
    <java.version>1.8</java.version>
    <!--规定docker打包后镜像名称前缀-->
    <docker.image.prefix>springboot</docker.image.prefix>
</properties>
  • 在 pom.xml 的 标签中添加 如下插件:(build 标签完整代码)
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>com.spotify</groupId>
            <artifactId>docker-maven-plugin</artifactId>
            <version>1.0.0</version>
            <configuration>
                <!--镜像名称-->
                <imageName>${docker.image.prefix}/${project.artifactId}</imageName>
                <dockerDirectory>src/main/docker</dockerDirectory>
                <resources>
                    <resource>
                        <targetPath>/</targetPath>
                        <!--jar 包所在目录,缺省为target-->
                        <directory>${project.build.directory}</directory>
                        <!--jar 包名,缺省为 $project.artifactId}-${project.version}-->
                        <include>${project.build.finalName}.jar</include>
                    </resource>
                </resources>
            </configuration>
        </plugin>
    </plugins>
</build>
  • 修改端口号(可选)

在 application.properties 中新增:

server.port=8081
  • 新增一个 controller,测试使用
package com.ifknow.controller;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author: ifknow <br>
 * @date: 2020/9/8  10:32 <br>
 * @description: 测试
 */
@RestController
public class HelloController {
    @RequestMapping("/hello")
    public String hello() {
        return "Hello Docker!";
    }
}
  • 在 src/main 下新建 docker 文件夹,在 docker 文件夹下创建 Dockerfile 文件(重要!

Dockerfile 内容如下:

# 使用 JDK 8 环境为基础环境,如果镜像不是本地的将会从 DockerHub 进行下载
FROM openjdk:8-jdk-alpine
# 在宿主机的 /var/lib/docker 目录下创建一个临时文件并把它链接到 tomcat 容器的工作目录 /tmp目录
VOLUME /tmp
# 复制文件并重命名 spring-boot-docker-1.0.jar 表示打包后的 jar 包名称
ADD spring-boot-docker-1.0.jar app.jar
# 为了缩短Tomcat启动时间,添加 java.security.egd 的系统属性指向 /dev/urandom 作为ENTRYPOINT
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

docker-1

  • 上传

将 springboot 项目上传到 Linux 的某个目录下. 可以使用 SecureCRT or Xftp.

  • 其他

Linux 环境要安装 maven、docker

2 部署 springboot jar包项目

  • 进入到 项目目录下:
cd spring-boot-docker/
  • 执行打包操作:
mvn clean package
  • 运行 jar 包 测试
java -jar target/spring-boot-docker-1.0.jar
  • 启动成功后,构建 Dockerfile 镜像
mvn package docker:build

.....赖心等待,出现下图所示内容,说明构建镜像成功。

docker-2

  • 查看镜像
# 列出所有镜像
docker images

docker-3

  • 运行镜像
docker run -p 8081:8081 -t springboot/spring-boot-docker
# -p 8081:8081 的含义是:将本地主机的 8081 端口映射到容器的 8081 端口(冒号前是主机端口)
# -t springboot/spring-boot-docker 的含义是:运行那个镜像
  • 查看进行中的镜像
docker ps

# docker ps -a #查看所有所有镜像包括正在运行和已结束的

docker-4

docker-5

3 部署 war 包项目

新建一个 war 包项目比较复杂,这里给出一个方案:在上面的 Jar 包项目的基础上改动!

修改 pom.xml

docker-6

docker-7

  • 将项目打包后的 war 包,上传到服务器指定目录下!
  • 安装 tomcat 镜像并启动
# 搜索tomcat镜像
docker search tomcat

# 下载镜像
docker pull docker.io/tomcat

# 启动 tomcat 镜像
# -d 的含义是后台运行 -p 的含义是端口映射,将主机的 8088 端口 映射到 docker 容器端口
docker run -d -p 8088:8080 docker.io/tomcat
  • 测试

打开浏览器 访问 http://ip:8088

docker-8

**注意:**如果出现404,可能的原因的端口未放开。但是我并不是这个原因,经过 查看 docker 内的 tomcat 容器目录和 tomcat 的官方目录 可以看到 容器中 的 webapp.dist 才是正确的webapp目录。

解决方法:

docker-9

(图片来源于:blog.csdn.net/qq_40891009…)

docker-10

(图片来源于:blog.csdn.net/qq_40891009…)

  • war 包部署

将 我们穿过来的 war 包 拷贝到 tomcat 容器的 webapps 下

查看当前运行的镜像:

docker ps

docker-11

拷贝操作:

docker-12

docker cp /root/workspace/spring-boot-docker-0.0.1-SNAPSHOT.war 8f63b712c7f:/usr/local/tomcat/webapps
# cp 的含义是拷贝
# /root/workspace/spring-boot-docker-0.0.1-SNAPSHOT.war 的含义是war包路径
# 8f63b712c7f:/usr/local/tomcat/webapps:8f63b712c7f的含义是tomcat容器的 container_id

tomcat 容器会自动将 war 包 解压。

  • 测试访问

在浏览器中访问:http://ip:8088/spring-boot-docker-0.0.1-SNAPSHOT/hello

docker