准备工作
使用到的工具及运行环境:
- JDK 1.8 及以上
- Gradle 4+ 或 Maven 3.2+
- 开发工具
- Spring Tool Suite (STS)
- IntelliJ IDEA
创建SpringBoot应用
这边我是使用 IntelliJ IDEA 创建的,你也可以通过这种方式创建然后导入到IDE中 http://start.spring.io/
在 pom.xml 中添加 docker maven插件:
4.0.0
org.springframework.boot
spring-boot-starter-parent
2.1.9.RELEASE
com.xumiao
spring-boot-docker
0.0.1-SNAPSHOT
spring-boot-docker
Demo project for Spring Boot
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
dockerfile-maven-plugin
1.4.9
${docker.image.prefix}/${project.artifactId}
org.apache.maven.plugins
maven-dependency-plugin
unpack
package
unpack
${project.groupId}
${project.artifactId}
${project.version}
在 SpringBootApplication 启动文件中添加个简单的路由:
@SpringBootApplication
@RestController
public class Application {
@RequestMapping("/")
public String home() {
return "Hello Docker World";
}
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
编写Dockerfile
在项目根目录创建 Dockerfile 文件,内容如下,启动类名全路径根据实际情况填写
FROM openjdk:8-jdk-alpine
VOLUME /tmp
ARG DEPENDENCY=target/dependency
COPY ${DEPENDENCY}/BOOT-INF/lib /app/lib
COPY ${DEPENDENCY}/META-INF /app/META-INF
COPY ${DEPENDENCY}/BOOT-INF/classes /app
ENTRYPOINT ["java","-cp","app:app/lib/*","com.xumiao.springboot.docker.Application"]
FROM
:基于openjdk镜像进行构建;第一条指令必须为FROM 指令。并且,如果在同一个Dockerfile中创建多个镜像时,可以使用多个FROM 指令(每个镜像一次)。
VOLUME
: 指向了一个 /tmp 的目录,由于 SpringBoot 使用内置的Tomcat容器,Tomcat 默认使用 /tmp 作为工作目录。效果就是在主机的 /var/lib/docker 目录下创建了一个临时文件,并连接到容器的/tmp;如果应用中有对文件系统进行写操作这个是必须要写的。
ARG
:设置构建参数
COPY
:复制本地主机的 (为 Dockerfile 所在目录的相对路径)到容器中的 app 目录下
ENTRYPOINT
:配置容器启动后执行的命令,并且不可被 docker run 提供的参数覆盖。每个 Dockerfile 中只能有一个 ENTRYPOINT ,当指定多个时,只有最后一个起效。
上面命令参考以下资料
https://jiajially.gitbooks.io/dockerguide/content/chapter_fastlearn/dockerfile_details.html
https://yeasy.gitbooks.io/docker_practice/image/dockerfile/
构建 Docker 镜像
启动 Docker 后在应用下目录执行以下 maven 命令开始构建
mvn install dockerfile:build
执行完成后我们查看下构建好的 docker 镜像(docker image ps
),如下:
springio/spring-boot-docker latest 436d7666f2f3 About a minute ago 122MB
openjdk 8-jdk-alpine a3562aa0b991 5 months ago 105MB
运行 Docker 镜像
通过以下命令创建 docker 容器并运行:
docker run -p 8080:8080 -t springio/spring-boot-docker
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.1.9.RELEASE)
2019-10-24 13:33:09.064 INFO 1 --- [ main] c.xumiao.springboot.docker.Application : Starting Application on 9a8a14b6d1ec with PID 1 (/app started by root in /)
2019-10-24 13:33:09.067 INFO 1 --- [ main] c.xumiao.springboot.docker.Application : No active profile set, falling back to default profiles: default
2019-10-24 13:33:10.335 INFO 1 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http)
2019-10-24 13:33:10.374 INFO 1 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
2019-10-24 13:33:10.374 INFO 1 --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/9.0.26]
2019-10-24 13:33:10.525 INFO 1 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext
2019-10-24 13:33:10.525 INFO 1 --- [ main] o.s.web.context.ContextLoader : Root WebApplicationContext: initialization completed in 1384 ms
2019-10-24 13:33:10.723 INFO 1 --- [ main] o.s.s.concurrent.ThreadPoolTaskExecutor : Initializing ExecutorService 'applicationTaskExecutor'
2019-10-24 13:33:10.883 INFO 1 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''
2019-10-24 13:33:10.886 INFO 1 --- [ main] c.xumiao.springboot.docker.Application : Started Application in 2.279 seconds (JVM running for 2.619)
我们通过docker ps
查看一下容器运行情况:
docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
9a8a14b6d1ec springio/spring-boot-docker "java -cp app:app/li…" 4 minutes ago Up 4 minutes 0.0.0.0:8080->8080/tcp elegant_goldwasser
接着在浏览器访问http://localhost:8080
可以看到“Hello Docker World”
结果,大功告成!
参考资料
https://spring.io/guides/gs/spring-boot-Docker/
https://lw900925.github.io/docker/docker-springboot.html