使用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 地址

参考:Spring Boot 2.0(四):使用 Docker 部署 Spring Boot