使用 Docker 部署 Spring Boot

这里主要用到spring-boot开箱即用,能生成一个独立运行的程序,及maven的插件docker-maven-plugin

这里主要步骤

  • 构建一个简单的springboot项目
  • 添加docker-maven-plugin及写dockerfile
  • 实践生成 docker镜像

一个简单 Spring Boot 项目

以spring boot 2.0 为例
在pom.xml文件中增加parament依赖

1
2
3
4
5
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.0.RELEASE</version>
</parent>

增加web和测试依赖

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

创建一个 Controller,在其中有一个index()方法,访问时返回:Hello Docker!

1
2
3
4
5
6
7
8
@RestController
public class Controller {
@RequestMapping("/")
public String index() {
return "Hello Docker!";
}
}

启动类

1
2
3
4
5
6
7
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}

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

添加dcoker-maven-plugin

pom.xml的properties节点中添加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
<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>
<directory>${project.build.directory}</directory>
<include>${project.build.finalNmae}.jar</include>
</resource>
</resources>
</configuration>
</plugin>
</plugins>
</build>

编写Dockerfile

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

1
2
3
4
5
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"]
EXPOSE 8080

这个 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
  • EXPOSE 指明8080端口提供服务

生成docekr镜像

需要有一个 Docker 环境来打包 Spring Boot 项目。
需要三个依赖

  • jdk环境
  • maven
  • docker环境
    运行java -version,mvn -version,docker version这些命令不报错就是环境准备好了。

进入项目目录

1
2
mvn package -Dmavne.test.skip=true
java -jar target/spring-boot-docker-1.0.jar

能正常运行,说明jar包没问题。

然后构建镜像

1
mvn docker:build

显示build success就成功。

使用docker images来查看构建好的镜像

运行镜像

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

然后curl http://127.0.0.1:8080可以看到返回Hello Docker!,说明成功

更多