Spring Boot应用发布到Docker的实现
Spring官网上有一篇GettingStart,介绍了如何使用Docker发布SpringBoot应用,算是比较详细了,不过有些细节没有提及到,而且官网的入门手册是英文版。这里重新整理记录一下,算是给英文不好的小伙伴一个参考,也给自己留个备忘。
准备
需要的工具以及运行环境:
- JDK1.8orlater
- Maven3.0+
- 你喜欢的IDE或其他文本编辑器
创建工程
首先,你需要创建一个SpringBoot工程,SpringToolSuite和IntelliJIDEA都自带插件可以创建,还有一种方式是从http://start.spring.io/上创建,推荐使用这种方式。填好表单中的GroupId和ArtifactId之后,点击GenerateProject按钮就可以生成了,将下载后的工程导入到你喜欢的IDE中。
修改pom.xml文件,添加docker-maven-plugin:
4.0.0 org.matrixstudio.springboot docker 0.0.1-SNAPSHOT jar docker DemoprojectforSpringBoot org.springframework.boot spring-boot-starter-parent 1.5.2.RELEASE UTF-8 UTF-8 1.8 springio org.springframework.boot spring-boot-starter-web org.springframework.boot spring-boot-starter-test test org.springframework.boot spring-boot-maven-plugin com.spotify docker-maven-plugin 0.4.3 ${docker.image.prefix}/${project.artifactId} src/main/docker / ${project.build.directory} ${project.build.finalName}.jar
docker-maven-plugin插件用于将SpringBoot工程构建为Docker镜像:
- imageName表示Docker镜像名称,我们使用Docker的命名规范,命名为:springio/docker
- dockerDirectory表示Dockerfile的路径
- resource表示在构建时需要的资源文件,这些文件和Dockerfile放在一起,这里只需要SpringBoot生成的jar文件即可。
打开DockerApplication.java文件,修改成如下内容:
packageorg.matrixstudio.springboot; importorg.springframework.boot.SpringApplication; importorg.springframework.boot.autoconfigure.SpringBootApplication; importorg.springframework.web.bind.annotation.RequestMapping; importorg.springframework.web.bind.annotation.RestController; @SpringBootApplication @RestController publicclassDockerApplication{ @RequestMapping("/") publicStringhome(){ return"HelloDockerWorld"; } publicstaticvoidmain(String[]args){ SpringApplication.run(DockerApplication.class,args); } }
编译并运行
执行如下命令运行SpringBoot工程:
mvnpackage&&java-jartarget/docker-0.0.1-SNAPSHOT.jar
打开浏览器,输入http://localhost:8080,如果出现“HelloDockerWorld”说明运行成功。
注:运行上面的命令时,需要从Maven官方仓库中下载很多依赖包,国内网络不太稳定,下载速度较慢,可考虑使用第三方提供的镜像站,比如阿里的Maven镜像仓库。在pom.xml中加入下面配置:
4.0.0 org.matrixstudio.springboot docker 0.0.1-SNAPSHOT jar ...... ......central aliyun http://maven.aliyun.com/nexus/content/groups/public/ true
容器化项目
首先要确保你的机器上安装了Docker,如果你的Docker安装在一台Linux服务器上,你需要将上面的SpringBoot工程上传到该服务器上,下面的步骤假设你是在Linux环境上操作。
创建Dockerfile
Docker使用一个名为Dockerfile的文件来指定image层,所以我们首先需要创建一个Dockerfile文件,执行下面的命令创建Dockerfile文件:
sudoteesrc/main/docker/Dockerfile<<-'EOF' FROMfrolvlad/alpine-oraclejdk8:slim VOLUME/tmp ADDdocker-0.0.1-SNAPSHOT.jarapp.jar RUNsh-c'touch/app.jar' ENVJAVA_OPTS="" ENTRYPOINT["sh","-c","java$JAVA_OPTS-Djava.security.egd=file:/dev/./urandom-jar/app.jar"] EOF
大概解释一下上面的命令:
- VOLUME指向了一个/tmp的目录,由于SpringBoot使用内置的Tomcat容器,Tomcat默认使用/tmp作为工作目录。效果就是在主机的/var/lib/docker目录下创建了一个临时文件,并连接到容器的/tmp。
- 将项目的jar文件作为app.jar添加到容器
- RUN表示在新创建的镜像中执行一些命令,然后把执行的结果提交到当前镜像。这里使用touch命令来改变文件的修改时间,Docker创建的所有容器文件默认状态都是“未修改”。这对于简单应用来说不需要,不过对于一些静态内容(比如:index.html)的文件就需要一个“修改时间”。
- 为了缩短Tomcat的启动时间,我们添加一个java.security.egd的系统属性指向/dev/urandom作为ENTRYPOINT。
构建Docker镜像
运行下面的命令构建Docker镜像:
mvnpackagedocker:build
构建完成后,运行下面的命令查看:
sudodockerimages
结果为:
REPOSITORY TAG IMAGEID CREATED SIZE
springio/docker latest 7e2ba2f7e81e 2minutesago 195MB
frolvlad/alpine-oraclejdk8 slim 00d8610f052e 4daysago 167MB
可以看到我们构建的镜像已经出现了,下一步就是运行该镜像。
运行Docker镜像
执行下面的命令来运行上一步构建的Docker镜像:
sudodockerrun-p8080:8080-tspringio/docker
如果不出意外,你将看到下面的输出内容:
._________ /\\/___'_____(_)______\\\\ (()\___|'_|'_||'_\/_`|\\\\ \\/___)||_)|||||||(_||)))) '|____|.__|_||_|_||_\__,|//// =========|_|==============|___/=/_/_/_/ ::SpringBoot::(v1.5.2.RELEASE) 2017-03-0803:34:59.434INFO6---[main]o.m.springboot.DockerApplication:StartingDockerApplicationv0.0.1-SNAPSHOTon00eed53e6928withPID6(/app.jarstartedbyrootin/) 2017-03-0803:34:59.445INFO6---[main]o.m.springboot.DockerApplication:Noactiveprofileset,fallingbacktodefaultprofiles:default 2017-03-0803:34:59.752INFO6---[main]ationConfigEmbeddedWebApplicationContext:Refreshingorg.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@4b9af9a9:startupdate[WedMar0803:34:59GMT2017];rootofcontexthierarchy 2017-03-0803:35:03.755INFO6---[main]s.b.c.e.t.TomcatEmbeddedServletContainer:Tomcatinitializedwithport(s):8080(http) 2017-03-0803:35:03.807INFO6---[main]o.apache.catalina.core.StandardService:StartingserviceTomcat 2017-03-0803:35:03.821INFO6---[main]org.apache.catalina.core.StandardEngine:StartingServletEngine:ApacheTomcat/8.5.11 2017-03-0803:35:04.042INFO6---[ost-startStop-1]o.a.c.c.C.[Tomcat].[localhost].[/]:InitializingSpringembeddedWebApplicationContext 2017-03-0803:35:04.043INFO6---[ost-startStop-1]o.s.web.context.ContextLoader:RootWebApplicationContext:initializationcompletedin4303ms 2017-03-0803:35:04.441INFO6---[ost-startStop-1]o.s.b.w.servlet.ServletRegistrationBean:Mappingservlet:'dispatcherServlet'to[/] 2017-03-0803:35:04.455INFO6---[ost-startStop-1]o.s.b.w.servlet.FilterRegistrationBean:Mappingfilter:'characterEncodingFilter'to:[/*] 2017-03-0803:35:04.457INFO6---[ost-startStop-1]o.s.b.w.servlet.FilterRegistrationBean:Mappingfilter:'hiddenHttpMethodFilter'to:[/*] 2017-03-0803:35:04.468INFO6---[ost-startStop-1]o.s.b.w.servlet.FilterRegistrationBean:Mappingfilter:'httpPutFormContentFilter'to:[/*] 2017-03-0803:35:04.468INFO6---[ost-startStop-1]o.s.b.w.servlet.FilterRegistrationBean:Mappingfilter:'requestContextFilter'to:[/*] 2017-03-0803:35:05.110INFO6---[main]s.w.s.m.m.a.RequestMappingHandlerAdapter:Lookingfor@ControllerAdvice:org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@4b9af9a9:startupdate[WedMar0803:34:59GMT2017];rootofcontexthierarchy 2017-03-0803:35:05.390INFO6---[main]s.w.s.m.m.a.RequestMappingHandlerMapping:Mapped"{[/]}"ontopublicjava.lang.Stringorg.matrixstudio.springboot.DockerApplication.home() 2017-03-0803:35:05.402INFO6---[main]s.w.s.m.m.a.RequestMappingHandlerMapping:Mapped"{[/error],produces=[text/html]}"ontopublicorg.springframework.web.servlet.ModelAndVieworg.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse) 2017-03-0803:35:05.404INFO6---[main]s.w.s.m.m.a.RequestMappingHandlerMapping:Mapped"{[/error]}"ontopublicorg.springframework.http.ResponseEntity>org.springframework.boot.autoconfigure.web.BasicErrorController.error(javax.servlet.http.HttpServletRequest) 2017-03-0803:35:05.512INFO6---[main]o.s.w.s.handler.SimpleUrlHandlerMapping:MappedURLpath[/webjars/**]ontohandleroftype[classorg.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2017-03-0803:35:05.512INFO6---[main]o.s.w.s.handler.SimpleUrlHandlerMapping:MappedURLpath[/**]ontohandleroftype[classorg.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2017-03-0803:35:05.639INFO6---[main]o.s.w.s.handler.SimpleUrlHandlerMapping:MappedURLpath[/**/favicon.ico]ontohandleroftype[classorg.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2017-03-0803:35:06.019INFO6---[main]o.s.j.e.a.AnnotationMBeanExporter:RegisteringbeansforJMXexposureonstartup 2017-03-0803:35:06.168INFO6---[main]s.b.c.e.t.TomcatEmbeddedServletContainer:Tomcatstartedonport(s):8080(http) 2017-03-0803:35:06.183INFO6---[main]o.m.springboot.DockerApplication:StartedDockerApplicationin7.893seconds(JVMrunningfor8.743) 2017-03-0803:35:56.728INFO6---[nio-8080-exec-1]o.a.c.c.C.[Tomcat].[localhost].[/]:InitializingSpringFrameworkServlet'dispatcherServlet' 2017-03-0803:35:56.728INFO6---[nio-8080-exec-1]o.s.web.servlet.DispatcherServlet:FrameworkServlet'dispatcherServlet':initializationstarted 2017-03-0803:35:56.774INFO6---[nio-8080-exec-1]o.s.web.servlet.DispatcherServlet:FrameworkServlet'dispatcherServlet':initializationcompletedin43ms
执行以下命令,查看正在运行的Docker容器:
sudodockerps
可以看到已经有一个Docker容器在运行了:
CONTAINERIDIMAGECOMMANDCREATEDSTATUSPORTSNAMES 00eed53e6928springio/docker"sh-c'java$JAVA..."AboutaminuteagoUpAboutaminute0.0.0.0:8080->8080/tcpfervent_leavitt
现在输入http://localhost:8080可以查看到“HelloDockerWorld”结果。
如果要停止容器,可以执行下面的命令:
sudodockerstop00e
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持毛票票。