Docker 技术发展为微服务落地提供了更加便利的环境,使用 Docker 部署 Spring Boot 其实非常简单,这篇文章我们就来简单学习下。
首先构建一个简单的 Spring Boot 项目,然后给项目添加 Docker 支持,最后对项目进行部署。
在 pom.xml
中 ,使用 Spring Boot 3.0 相关依赖
1 2 3 4 5 |
<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.0.0</version> </parent> |
添加 web 和测试依赖
1 2 3 4 5 6 7 8 9 10 |
<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> </dependency> </dependencies> |
创建一个 DockerController,在其中有一个index()
方法,访问时返回:Hello Docker!
1 2 3 4 5 6 7 8 |
@RestController public class DockerController { @RequestMapping("/") public String index() { return "Hello Docker!"; } } |
启动类
1 2 3 4 5 6 7 |
@SpringBootApplication public class DockerApplication { public static void main(String[] args) { SpringApplication.run(DockerApplication.class, args); } } |
添加完毕后启动项目,启动成功后浏览器访问:http://localhost:8080/
,页面返回:Hello Docker!
,说明 Spring Boot 项目配置正常。
在 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 25 26 |
<build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> <!-- Docker maven 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.finalName}.jar</include> </resource> </resources> </configuration> </plugin> <!-- Docker maven plugin --> </plugins> </build> |
在目录src/main/docker
下创建 Dockerfile 文件,Dockerfile 文件用来说明如何来构建镜像。
1 2 3 4 |
FROM openjdk:17-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 到镜像中,简单解释一下:
/tmp
的目录,由于 Spring Boot 使用内置的Tomcat容器,Tomcat 默认使用/tmp
作为工作目录。这个命令的效果是:在宿主机的/var/lib/docker
目录下创建一个临时文件并把它链接到容器中的/tmp
目录java.security.egd
的系统属性指向/dev/urandom
作为 ENTRYPOINT这样 Spring Boot 项目添加 Docker 依赖就完成了。
我们需要有一个 Docker 环境来打包 Spring Boot 项目,在 Windows 搭建 Docker 环境很麻烦,因此我这里以 Centos 7 为例。
安装
1 |
yum install docker-ce docker-ce-cli containerd.io |
安装完成后,使用下面的命令来启动 docker 服务,并将其设置为开机启动:
1 2 |
systemctl enable docker systemctl start docker |
使用Docker 中国加速器
1 2 3 4 5 6 7 8 9 |
vi /etc/docker/daemon.json #添加后: { "registry-mirrors": [ "https://hub-mirror.c.163.com", "https://mirror.baidubce.com" ] } |
重新启动docker
1 2 |
systemctl daemon-reload systemctl restart docker |
输入docker version
返回版本信息则安装正常。
1 |
yum install java-17-openjdk |
配置环境变量 打开 vi /etc/profile
添加一下内容
1 2 |
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64 export PATH=$PATH:$JAVA_HOME/bin |
修改完成之后,使其生效
1 |
source /etc/profile |
输入java -version
返回版本信息则安装正常。
下载:wget https://mirror.bit.edu.cn/apache/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz
1 2 3 4 |
## 解压 tar vxf apache-maven-3.6.3-bin.tar.gz ## 移动 mv apache-maven-3.6.3 /usr/local/maven3 |
修改环境变量, 在/etc/profile
中添加以下几行
1 2 3 |
MAVEN_HOME=/usr/local/maven3 export MAVEN_HOME export PATH=${PATH}:${MAVEN_HOME}/bin |
记得执行source /etc/profile
使环境变量生效。
输入mvn -version
返回版本信息则安装正常。
这样整个构建环境就配置完成了。
将项目 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 |
... Step 1 : FROM openjdk:17-jdk-alpine ---> 224765a6bdbe Step 2 : VOLUME /tmp ---> Using cache ---> b4e86cc8654e Step 3 : ADD spring-boot-docker-1.0.jar app.jar ---> a20fe75963ab Removing intermediate container 593ee5e1ea51 Step 4 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /app.jar ---> Running in 85d558a10cd4 ---> 7102f08b5e95 Removing intermediate container 85d558a10cd4 Successfully built 7102f08b5e95 [INFO] Built springboot/spring-boot-docker [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 54.346 s [INFO] Finished at: 2018-03-13T16:20:15+08:00 [INFO] Final Memory: 42M/182M [INFO] ------------------------------------------------------------------------ |
使用docker images
命令查看构建好的镜像:
1 2 3 |
docker images REPOSITORY TAG IMAGE ID CREATED SIZE springboot/spring-boot-docker latest 99ce9468da74 6 seconds ago 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 049570da86a9 springboot/spring-boot-docker "java -Djava.security" 30 seconds ago Up 27 seconds 0.0.0.0:8080->8080/tcp determined_mahavira |
可以看到我们构建的容器正在在运行,访问浏览器:http://192.168.0.x:8080/
,返回
1 |
Hello Docker! |
说明使用 Docker 部署 Spring Boot 项目成功!
Spring Boot with Docker
Docker:Spring Boot 应用发布到 Docker
from:http://www.ityouknow.com/springboot/2023/01/25/spring-boot-docker.html