使用Docker部署Spring Boot的应用示例

Jelena ·

更新时间:2024-11-15

· 758 次阅读

Docker 技术发展为微服务落地提供了更加便利的环境，使用 Docker 部署 Spring Boot 其实非常简单，这篇文章我们就来简单学习下。

首先构建一个简单的 Spring Boot 项目，然后给项目添加 Docker 支持，最后对项目进行部署。

一个简单 Spring Boot 项目

在 pom.xml 中，使用 Spring Boot 2.0 相关依赖


<parent>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-parent</artifactId>
 <version>2.0.0.RELEASE</version>
</parent>

添加 web 和测试依赖


<dependencies>
   <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-test</artifactId>
 <scope>test</scope>
 </dependency>
</dependencies>

创建一个 DockerController，在其中有一个 index() 方法，访问时返回： Hello Docker!


@RestController
public class DockerController {
  @RequestMapping("/")
  public String index() {
    return "Hello Docker!";
  }
}

启动类


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

添加完毕后启动项目，启动成功后浏览器放问： http://localhost:8080/ ，页面返回： Hello Docker! ，说明 Spring Boot 项目配置正常。

Spring Boot 项目添加 Docker 支持

在 pom.xml-properties 中添加 Docker 镜像名称


<properties>
 <docker.image.prefix>springboot</docker.image.prefix>
</properties>

plugins 中添加 Docker 构建插件：


<build>
 <plugins>
 <plugin>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-maven-plugin</artifactId>
 </plugin>
 <!-- Docker maven 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>
   <directory>${project.build.directory}</directory>
   <include>${project.build.finalName}.jar</include>
   </resource>
  </resources>
  </configuration>
 </plugin>
 <!-- Docker maven plugin -->
 </plugins>
</build>

在目录 src/main/docker 下创建 Dockerfile 文件，Dockerfile 文件用来说明如何来构建镜像。


FROM openjdk:8-jdk-alpine
VOLUME /tmp
ADD spring-boot-docker-1.0.jar app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

这个 Dockerfile 文件很简单，构建 Jdk 基础环境，添加 Spring Boot Jar 到镜像中，简单解释一下:

FROM ，表示使用 Jdk8 环境为基础镜像，如果镜像不是本地的会从 DockerHub 进行下载 VOLUME ，VOLUME 指向了一个 /tmp 的目录，由于 Spring Boot 使用内置的Tomcat容器，Tomcat 默认使用 /tmp 作为工作目录。这个命令的效果是：在宿主机的 /var/lib/docker 目录下创建一个临时文件并把它链接到容器中的 /tmp 目录 ADD ，拷贝文件并且重命名 ENTRYPOINT ，为了缩短 Tomcat 的启动时间，添加 java.security.egd 的系统属性指向 /dev/urandom 作为 ENTRYPOINT

这样 Spring Boot 项目添加 Docker 依赖就完成了。

构建打包环境

我们需要有一个 Docker 环境来打包 Spring Boot 项目，在 Windows 搭建 Docker 环境很麻烦，因此我这里以 Centos 7 为例。

安装 Docker 环境

安装


yum install docker

安装完成后，使用下面的命令来启动 docker 服务，并将其设置为开机启动：


ervice docker start
chkconfig docker on
#LCTT 译注：此处采用了旧式的 sysv 语法，如采用CentOS 7中支持的新式 systemd 语法，如下：
systemctl start docker.service
systemctl enable docker.service

使用Docker 中国加速器


vi /etc/docker/daemon.json
#添加后：
{
  "registry-mirrors": ["https://registry.docker-cn.com"],
  "live-restore": true
}

重新启动docker


systemctl restart docker

输入 docker version 返回版本信息则安装正常。

安装JDK


yum -y install java-1.8.0-openjdk*

配置环境变量打开 vim /etc/profile 添加一下内容


export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.161-0.b14.el7_4.x86_64 
export PATH=$PATH:$JAVA_HOME/bin

修改完成之后，使其生效


source /etc/profile

输入 java -version 返回版本信息则安装正常。

安装MAVEN

下载： http://mirrors.shu.edu.cn/apache/maven/maven-3/3.5.2/binaries/apache-maven-3.5.2-bin.tar.gz


## 解压
tar vxf apache-maven-3.5.2-bin.tar.gz
## 移动
mv apache-maven-3.5.2 /usr/local/maven3

修改环境变量，在 /etc/profile 中添加以下几行


MAVEN_HOME=/usr/local/maven3
export MAVEN_HOME
export PATH=${PATH}:${MAVEN_HOME}/bin

记得执行 source /etc/profile 使环境变量生效。

输入 mvn -version 返回版本信息则安装正常。

这样整个构建环境就配置完成了。

使用 Docker 部署 Spring Boot 项目

将项目 spring-boot-docker 拷贝服务器中，进入项目路径下进行打包测试。


#打包
mvn package
#启动
java -jar target/spring-boot-docker-1.0.jar

看到 Spring Boot 的启动日志后表明环境配置没有问题，接下来我们使用 DockerFile 构建镜像。


mvn package docker:build

第一次构建可能有点慢，当看到以下内容的时候表明构建成功：


...
Step 1 : FROM openjdk:8-jdk-alpine
 ---> 224765a6bdbe
Step 2 : VOLUME /tmp
 ---> Using cache
 ---> b4e86cc8654e
Step 3 : ADD spring-boot-docker-1.0.jar app.jar
 ---> a20fe75963ab
Removing intermediate container 593ee5e1ea51
Step 4 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /app.jar
 ---> Running in 85d558a10cd4
 ---> 7102f08b5e95
Removing intermediate container 85d558a10cd4
Successfully built 7102f08b5e95
[INFO] Built springboot/spring-boot-docker
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 54.346 s
[INFO] Finished at: 2018-03-13T16:20:15+08:00
[INFO] Final Memory: 42M/182M
[INFO] ------------------------------------------------------------------------

使用 docker images 命令查看构建好的镜像：


docker images
REPOSITORY           TAG         IMAGE ID      CREATED       SIZE
springboot/spring-boot-docker  latest       99ce9468da74    6 seconds ago    117.5 MB

springboot/spring-boot-docker 就是我们构建好的镜像，下一步就是运行该镜像


docker run -p 8080:8080 -t springboot/spring-boot-docker

启动完成之后我们使用 docker ps 查看正在运行的镜像：


docker ps
CONTAINER ID    IMAGE              COMMAND         CREATED       STATUS       PORTS          NAMES
049570da86a9    springboot/spring-boot-docker  "java -Djava.security"  30 seconds ago   Up 27 seconds    0.0.0.0:8080->8080/tcp  determined_mahavira

可以看到我们构建的容器正在在运行，访问浏览器： http://192.168.0.x:8080/ ,返回


Hello Docker!

说明使用 Docker 部署 Spring Boot 项目成功！

示例代码：https://github.com/ityouknow/spring-boot-examples

您可能感兴趣的文章:java通过Idea远程一键部署springboot到Docker详解利用Dockerfile部署SpringBoot项目的方法使用Docker部署Spring Boot的实现方法在Docker中部署Spring Boot项目过程详解Spring Boot利用Docker快速部署项目的完整步骤Spring Boot和Docker实现微服务部署的方法基于idea把springboot项目部署到docker

spring 示例 boot Docker

1024 个赞