在Docker容器中运行Spring Boot应用 博客分类: spring bootspring
Spring Boot简化了Spring应用的开发过程,遵循约定优先配置的原则提供了各类开箱即用(out-of-the-box)的框架配置。另一方面,Spring Boot还具备将代码直接构建为可执行jar包的能力,这个jar包是一个可以独立运行的部署单元。基于以上特性,现在普遍认为Spring Boot提供了一种快速构造微服务(Micro-Service)的能力。
Docker与Spring Boot
Docker是一种Linux容器的实现,Linux容器是基于进程的轻量级资源隔离技术,每一个容器对应操作系统中的一个进程,但是它又会有自己的网络空间、文件系统、PID等。Docker除了实现Linux容器,还使得容器具有“社会化”的功能,用户可以将容器镜像发布在Docker Hub与其他开发者共享、协作。安装Docker的教程请参考官方文档
Spring Boot应用通常被构建为一个可单独执行的jar包,通过java -jar ...
运行,但是框架本身并没有提供以服务形式运行在后台的方法,通常需要借助Systemd, Supervisord等进程管理工具来实现。另一方面,虽然应用运行环境非常的简单,但是将他们容器化为Docker容器镜像并运行,对于自动化部署、运维都是非常有利的。
本文将以一个最简单的Spring Boot开发的Web应用为例,讲解如何将其容器化运行。本文的重点是构建Docker镜像、运行Docker容器,关于Spring Boot开发Web应用可以参考Spring Boot应用开发
构建并Spring Boot应用
在应用代码编写完成后,可以直接将其打包并运行:
- Maven:
mvn package && java -jar target/spring-boot-docker-0.1.0.jar
- Gradle:
gradle build && java -jar build/libs/gs-spring-boot-docker-0.1.0.jar
在浏览器地址栏种输入[http://localhost:8080/](http://localhost:8080/)
可以访问应用
Dockerfile构建镜像
Docker提供了Dockerfile格式的文件来构建应用镜像,现在开始创建一个Spring Boot应用的Dockerfile:
FROM java:8
VOLUME /tmp
ADD spring-boot-docker-0.1.0.jar app.jar
RUN bash -c 'touch /app.jar'
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
java:8
是指Docker Hub上官方提供的java镜像,版本号是8也就是jdk1.8,有了这个基础镜像后,Dockerfile可以通过FROM
指令直接获取它的状态——也就是在容器中java
是已经安装的,接下来通过自定义的命令来运行Spring Boot应用:
-
VOLUME /tmp
创建/tmp目录并持久化到Docker数据文件夹,因为Spring Boot使用的内嵌Tomcat容器默认使用/tmp
作为工作目录 -
ADD spring-boot-docker-0.1.0.jar app.jar
将应用jar包复制到/app.jar
-
ENTRYPOINT
表示容器运行后默认执行的命令
Dockerfile非常的简单,编辑完成后运行docker构建镜像命令:
docker build -t tmy/spring-boot-app .
然后运行Docker容器:
docker run -d -p 8080:8080 --name sample-app tmy/spring-boot-app
其中-d
表示后台运行容器,这也就自然地解决的Spring Boot不支持后台运行应用程序的问题。-p 8080:8080
表示将容器内部的8080端口映射到宿主机器的8080端口,这样就可以通过宿主机器直接访问应用。--name sample-app
给容器取一个容易记住的名字方便日后管理。
使用Maven/Gradle创建Docker镜像
为了方便Java开发者创建Docker镜像,Maven/Gradle都提供了响应的插件。
Maven
<properties>
<docker.image.prefix>springio</docker.image.prefix>
</properties>
<build>
<plugins>
<plugin>
<groupId>com.spotify</groupId>
<artifactId>docker-maven-plugin</artifactId>
<version>0.2.3</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>
</plugins>
</build>
上述pom.xml
包含了docker-maven-plugin
的配置:
-
imageName
指定了镜像的名字 -
dockerDirectory
指定Dockerfile的位置 -
resources
是指那些需要和Dockerfile放在一起,在构建镜像时使用的文件,一般应用jar包需要纳入
经过以上配置后,运行下列命令可以在本地Docker中创建一个镜像:
$ mvn package docker:build
Gradle
Gradle同样也有支持Docker的插件:
buildscript {
...
dependencies {
...
classpath('se.transmode.gradle:gradle-docker:1.2')
}
}
group = 'springio'
...
apply plugin: 'docker'
task buildDocker(type: Docker, dependsOn: build) {
push = true
applicationName = jar.baseName
dockerfile = file('src/main/docker/Dockerfile')
doFirst {
copy {
from jar
into stageDir
}
}
}
上述配置和Maven基本类似,执行以下命令构建镜像:
$ gradle build buildDocker
https://www.tianmaying.com/tutorial/spring-boot-docker
推荐阅读
-
在Docker容器中运行Spring Boot应用 博客分类: spring bootspring
-
spring boot开发web api应用实践(二)操作数据库 博客分类: spring boot 实践笔记 spring bootspring boot 操作数据库
-
Spring学习(二)---在IoC容器中装配Bean 博客分类: Spring 3.x 企业应用开发笔记 springbeanioc框架
-
详解在Docker容器中运行Spring Boot应用
-
在Docker中开发Java 8 Spring Boot应用程序的方法
-
将spring boot应用打入docker中运行的实现方法
-
详解在Docker容器中运行Spring Boot应用
-
在Docker中开发Java 8 Spring Boot应用程序的方法
-
将spring boot应用打入docker中运行的实现方法