使用 Docker 部署 Spring Boot

Docker 技术发展为微服务落地提供了更加便利的环境,使用 Docker 部署 Spring Boot 其实非常简单,首先构建一个简单的 Spring Boot 项目,然后给项目添加 Docker 支持,最后对项目进行部署。

一个简单 Spring Boot 项目

在 pom.xml 中,使用 Spring Boot 2 相关依赖

1
2
3
4
5
6
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.3.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>

添加 web 和测试依赖

1
2
3
4
5
6
7
8
9
10
11
12
<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!

1
2
3
4
5
6
7
8
9
@RestController
public class DockerController {

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

}

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

Spring Boot 项目添加 Docker 支持

pom.xmlproperties 中添加 Docker 镜像名称:

1
2
3
<properties>
<docker.image.prefix>springboot</docker.image.prefix>
</properties>

plugins 中添加 Docker 构建插件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
<!-- Docker maven plugin -->
<!-- https://github.com/spotify/docker-maven-plugin -->
<plugin>
<groupId>com.spotify</groupId>
<artifactId>docker-maven-plugin</artifactId>
<version>1.2.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>

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

1
2
3
4
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

构建打包环境

我们需要有一个 Docker 环境来打包 Spring Boot 项目,以 Centos 7 为例搭建 Docker 环境。

安装 Docker 环境

1
2
3
4
# yum install docker
# docker -v
# systemctl start docker
# systemctl enable docker

使用Docker中国加速器

1
2
# vim /etc/docker/daemon.json
# systemctl restart docker
1
2
3
4
{
"registry-mirrors": ["https://registry.docker-cn.com"],
"live-restore": true
}

使用 Docker 部署 Spring Boot 项目

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

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

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

1
mvn package docker:build

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[INFO] Building image springboot/spring-boot-docker
Step 1/4 : FROM openjdk:8-jdk-alpine

---> e9ea51023687
Step 2/4 : VOLUME /tmp

---> Using cache
---> ed9eb565fc07
Step 3/4 : ADD spring-boot-docker-0.0.1-SNAPSHOT.jar app.jar

---> 32c07687353d
Step 4/4 : ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

---> Running in 74ed7acd8a75
Removing intermediate container 74ed7acd8a75
---> b118a8f3f961
ProgressMessage{id=null, status=null, stream=null, error=null, progress=null, progressDetail=null}
Successfully built b118a8f3f961
Successfully tagged springboot/spring-boot-docker:latest
[INFO] Built springboot/spring-boot-docker
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 18.619 s
[INFO] Finished at: 2019-03-22T15:29:45+08:00
[INFO] ------------------------------------------------------------------------

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

1
2
3
# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
springboot/spring-boot-docker latest b118a8f3f961 2 minutes ago 122MB 117.5 MB

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

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

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

1
2
3
# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
69a58970d918 springboot/spring-boot-docker "java -Djava.securit…" About a minute ago Up About a minute 0.0.0.0:8080->8080/tcp frosty_pike

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

1
Hello Docker!

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

Powered by AppBlog.CN     浙ICP备14037229号

Copyright © 2012 - 2020 APP开发技术博客 All Rights Reserved.

访客数 : | 访问量 :