使用Docker部署Spring Boot项目
目录
本文使用 Docker 部署 Spring Boot 项目。部署之前需要环境中已经安装 Docker 和 Maven(用于打包),所以本文先进行安装 Docker 和 Maven;接着搭建一个 Spring Boot 项目,使其支持 Docker 部署;最后进行部署和测试。
环境搭建
安装 Docker
检查系统内核版本
Docker 运行在 CentOS 7 上,要求操作系统为 64 位,内核版本为 3.10 及以上。
确认本机已经安装了满足要求的 Linux 内核。使用命令uname -r
来检查内核版本信息。
[root@localhost ~]# uname -r
3.10.0-957.el7.x86_64
在 CentOS 7 中安装 Docker
使用命令yum install -y docker
安装 Docker,“-y”表示不询问,使用默认配置进行安装。
备注:Docker 从 1.13 版本之后采用时间线的方式作为版本号,分为社区版 CE 和企业版 EE。社区版是免费提供给个人开发者和小型团体使用的,企业版会提供额外的收费服务,比如经过官方测试认证过的基础设施、容器、插件等。所以,需要将安装命令修改为yum install -y docker-ce
。(20201129 修改)
启动 Docker 服务,并设置为开机自启动
使用下列命令:
systemctl start docker.service
systemctl enable docker.service
查看版本信息
输入docker version
,返回版本信息表明 Docker 安装成功。
[root@localhost ~]# docker version
Client:
Version: 1.13.1
API version: 1.26
Package version: docker-1.13.1-96.gitb2f74b2.el7.centos.x86_64
Go version: go1.10.3
Git commit: b2f74b2/1.13.1
Built: Wed May 1 14:55:20 2019
OS/Arch: linux/amd64
Server:
Version: 1.13.1
API version: 1.26 (minimum version 1.12)
Package version: docker-1.13.1-96.gitb2f74b2.el7.centos.x86_64
Go version: go1.10.3
Git commit: b2f74b2/1.13.1
Built: Wed May 1 14:55:20 2019
OS/Arch: linux/amd64
Experimental: false
安装 Maven 和配置阿里云镜像
下载 Maven
wget https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.5.4/binaries/apache-maven-3.5.4-bin.tar.gz
解压和移动
tar vxf apache-maven-3.5.4-bin.tar.gz
mv apache-maven-3.5.4 /usr/local/maven3
配置环境变量
打开环境变量vim /etc/profile
,添加如下内容:
MAVEN_HOME=/usr/local/maven3
export MAVEN_HOME
export PATH=${PATH}:${MAVEN_HOME}/bin
保存并退出::wq
刷新环境变量的配置使其生效:source /etc/profile
查看版本信息
使用命令mvn -v
进行查看
[root@localhost ~]# mvn -v
Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-18T02:33:14+08:00)
Maven home: /usr/local/maven3
Java version: 1.8.0_211, vendor: Oracle Corporation, runtime: /usr/local/java/jdk1.8.0_211/jre
Default locale: zh_CN, platform encoding: UTF-8
OS name: "linux", version: "3.10.0-957.el7.x86_64", arch: "amd64", family: "unix"
使用mvn package
命令进行打包,却报错,提示连接被拒绝。
解决办法:给 Maven 配置阿里云镜像
切换到 maven 安装目录下面,打开 settings.xml 文件,在<mirrors>
标签里面添加:
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
Spring Boot 项目添加 Docker 支持
新建 Spring Boot 工程
新建一个 Spring Boot 项目,添加一个简单的 DockerController,方便进行测试。
@RestController
@SpringBootApplication
@RequestMapping("/docker")
public class DockerController {
<span class="hljs-meta">@RequestMapping("/hello")</span>
<span class="hljs-meta">@ResponseBody</span>
<span class="hljs-keyword">public</span> String <span class="hljs-title function_">hello</span><span class="hljs-params">()</span> {
<span class="hljs-keyword">return</span> <span class="hljs-string">"Hello Docker"</span>;
}
}
添加 Docker 支持
在 pom.xml 中添加 Docker 镜像名称
<properties>
<docker.image.prefix>springboot</docker.image.prefix>
</properties>
添加 Docker 插件:
<!-- docker 插件 -->
<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>
编写 Dockerfile 文件
在目录 src/main/docker 下创建 Dockerfile 文件,Dockerfile 文件用来说明如何来构建镜像。
FROM java:8
VOLUME /tmp
ADD docker-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
FROM 指令指定一个已经存在的镜像,告诉 Docker 后续的指令都是在这个基础上进行的。例如:FROM java:8
表示使用 Jdk1.8 环境为基础镜像进行构建镜像。
VOLUME ,VOLUME 指向了一个 /tmp 的目录,由于 Spring Boot 使用内置的 Tomcat 容器,Tomcat 默认使用 /tmp 作为工作目录。这个命令的效果是:在宿主机的 /var/lib/docker 目录下创建一个临时文件并把它链接到容器中的 /tmp 目录
ADD ,拷贝文件并且重命名
ENTRYPOINT,为了缩短 Tomcat 的启动时间,添加 java.security.egd 的系统属性指向 /dev/urandom 作为 ENTRYPOINT。
部署 Spring Boot 工程
将工程代码 docker 拷贝服务器中,进入项目路径下进行打包测试。
打包:mvn package
运行:java -jar target/spring-boot-docker-1.0.jar
项目启动成功,说明环境配置没有问题,接下来可以使用 Dockerfile 构建镜像。
构建 Docker 镜像mvn package docker:build
。可以看到 docker 镜像构建成功,仔细看日志,会发现四个步骤和 Dockerfile 中的指令是一一对应的。
使用docker images
命令查看构建好的镜像:
[root@localhost ~]# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
springboot/docker latest 39aabeebb971 5 days ago 660 MB
运行 docker 镜像:docker run -p 8080:8080 -t springboot/docker
在本机浏览器进行访问,可以看到返回结果,说明部署成功。
完整代码:GitHub 地址