通过Docker部署SpringBoot项目

  • 通过Docker部署SpringBoot项目已关闭评论
  • 129 次浏览
  • A+
所属分类:linux技术
摘要

前言:以前几次在云服务器上部署项目都是手动打包,安装mysql等环境最后再部署运行,相对比较麻烦而且加上网上各种教程质量层次不齐,如果过程中出错的话排查问题对于新人来说已经够喝一壶了。(我自己第一次手动装mysql8.0就出过问题,最后找不到问题所在只能推倒一步步重来)


Docker部署SpringBoot项目

前言:

以前几次在云服务器上部署项目都是手动打包,安装mysql等环境最后再部署运行,相对比较麻烦而且加上网上各种教程质量层次不齐,如果过程中出错的话排查问题对于新人来说已经够喝一壶了。(我自己第一次手动装mysql8.0就出过问题,最后找不到问题所在只能推倒一步步重来)

而最近在Win10专业版下用Docker桌面版安装了zookeeper/rabbitmq/redis 6.2等都比较方便,命令行拉取镜像,启动服务都非常方便快捷,相比以往下载配置环境变量再启动的方式要方便很多,所以此次决定尝试一下通过Docker的方式来安装部署一次Spring Boot项目。

声明:本文主要介绍如何通过 IntelliJ IDEA、Maven 来操作 Docker 部署 Spring Boot 项目到云服务器,不涉及Docker或Maven等内容中的基本概念,默认读者已经了解,相关教程请自行搜索。

云服务器:阿里云Centos 7

1.云服务器基本环境搭建

安装Docker

yum安装Docker

yum install docker 

启动docker并设置为启动:

systemctl  start docker.service systemctl  enable docker.service 

使用docker国内镜像加速

vim  /etc/docker/daemon.json 

内容如下(也可自己搜索其他镜像修改)

{     "registry-mirrors": ["https://registry.docker-cn.com"],     "live-restore": true } 

重启docker

systemctl restart docker 

可以看到镜像已经改了

docker info 

通过Docker部署SpringBoot项目

查看docker版本信息

docker version 

通过Docker部署SpringBoot项目

安装JDK

耐心等待安装完成

yum -y install java-1.8.0-openjdk 

查找java所在位置

whereis java 

通过Docker部署SpringBoot项目

配置环境变量

vim /etc/profile  

配置信息

export JAVA_HOME=/usr/lib/jvm/java-1.8.0 export PATH=$PATH:$JAVA_HOME/bin 

再次刷新配置信息

source /etc/profile 

查看java版本信息

java -version 

通过Docker部署SpringBoot项目

安装Maven

方式有很多种,自己到Maven官网下载上传到服务器解压或者直接wget命令安装(通过yum安装weget命令).我这里选用第一种.

本质上和在win10下安装没什么区别都是下载->解压->配置镜像和仓库->配置环境变量这几个步骤

下载Maven

Maven官网:

https://maven.apache.org/docs/history.html 

下载Linux版本,然后传到云服务器手动解压安装

通过Docker部署SpringBoot项目

可以直接下载最新版本,但我个人一般习惯往前找几个版本的,所以继续往下滑

1.看到标题停下来,它给我们指明了更早的版本在哪去找

通过Docker部署SpringBoot项目

2.二进制文件就是我们要的,source指的是源码

通过Docker部署SpringBoot项目

3.选择对应Linux的版本

通过Docker部署SpringBoot项目

上传到服务器并解压

把它下载然后上传到服务器指定目录下(我这里用XFTP传到了usr/local目录下)

通过Docker部署SpringBoot项目

这时候解压它就行

通过Docker部署SpringBoot项目

通过如下命令解压

tar -zxvf apache-maven-3.6.3-bin.tar.gz 

通过Docker部署SpringBoot项目

配置镜像和本地仓库信息

上面这个就是解压后的文件夹,只需要配置下国内镜像地址和本地仓库位置信息就可以用了。

cd apache-maven-3.6.3   #进入apache-maven-3.6.3目录 

通过Docker部署SpringBoot项目

这时候可以新建一个目录,用作后续修改配置文件,存放maven下载的jar

mkdir repository    #创建目录存放后续maven下载jar包 

通过Docker部署SpringBoot项目

进入conf目录,通过vim修改settings.xml,配置镜像和本地仓库信息

vim基本操作:

i:进入编辑模式

esc +!:wq: 保存并退出

cd conf #进入conf目录 

通过Docker部署SpringBoot项目

vim settings.xml  #编辑配置文件 

配置文件里我们只关心mirrors根节点下的镜像和localRepository根节点下的本地仓库位置

本地仓库:解除注释,把位置改成之前自己创建的仓库目录的完整路径

通过Docker部署SpringBoot项目

<localRepository>/usr/local/apache-maven-3.6.3/repository</localRepository> 

镜像地址:注意name和url这些不要搞错了

通过Docker部署SpringBoot项目

<mirror>       <id>alimaven</id>       <name>aliyun maven</name>        <url>http://maven.aliyun.com/nexus/content/groups/public/</url>       <mirrorOf>central</mirrorOf> </mirror> 

修改完以上的两处,保存并退出就行。

配置环境变量

接下来是,依旧是配置环境变量

通过Docker部署SpringBoot项目

vim /etc/profile 

编辑/etc/profile 文件,系统环境变量都在这配置

通过Docker部署SpringBoot项目

export MAVEN_HOME=/usr/local/apache-maven-3.6.3 export PATH=$PATH:$MAVEN_HOME/bin 

刷新配置文件:

source /etc/profile 

通过Docker部署SpringBoot项目

查看Maven版本信息

mvn -v 

通过Docker部署SpringBoot项目

以下的Mysql和Redis的安装只是因为我的项目用到了,如果只是自己体验整个部署流程的话不需要安装

安装Mysql

到DockerHub找一个mysql镜像,我这里用的mysql8

https://hub.docker.com/_/mysql

到tags下搜索,然后复制命令拉取镜像就行

通过Docker部署SpringBoot项目

  1. 拉取镜像
docker pull mysql:8.0 
  1. 查看镜像
docker images 

通过Docker部署SpringBoot项目

这里DockerHub官方也给了关于如何使用和连接的指南

通过Docker部署SpringBoot项目

  1. 创建并修改配置文件

创建两个文件夹conf和data(映射Docker的目录,放置配置文件和日志等信息)

我把它放在了/usr/local/mysql/路径下(看自己习惯)

创建/修改配置文件信息

vim my.cnf  #用touch新建也一样 

内容如下

[mysql] #设置mysql客户端默认字符集 default-character-set=UTF8MB4 [mysqld] #设置3306端口 port=3306 #允许最大连接数 max_connections=200 #允许连接失败的次数 max_connect_errors=10 #服务端使用的字符集 character-set-server=UTF8MB4 #创建新表时将使用的默认存储引擎 default-storage-engine=INNODB #等待超时时间秒 wait_timeout=60 #交互式连接超时时间秒 interactive-timeout=600 
  1. 启动并运行mysql
docker run    -d    -p 3306:3306    -v /usr/local/mysql/data:/var/lib/mysql    -v /usr/local/mysql/my.cnf:/etc/mysql/conf.d/my.cnf    -e MYSQL_ROOT_PASSWORD=123456    --restart=always    --privileged=true    --name mysql8    mysql:8.0 

通过Docker部署SpringBoot项目

参数说明

-p 3306:3306:将容器内的3306端口映射到实体机3306端口 --name msqyl:给这个容器取一个容器记住的名字 -e MYSQL_ROOT_PASSWORD=xxx:docker的MySQL默认的root密码是随机的,这是改一下默认的root用户密码 -v 宿主机和Docker容器的挂载关系 :前是宿主机的路径,后是Docker中的挂载路径 -d mysql:8.0在后台运行mysql:8.0镜像产生的容器 

后续导入SQL还踩了坑.原因是mysql是通过Docker安装的,而我恢复快照用的是Linux中的路径.

所以dump快照生成的sql文件本身也必须挂载到docker容器中.否则source命令会找不到文件所在.

获取容器/镜像的元数据,通过这个也能看到挂载信息

我这里后续继续挂载到/var/lib/mysql目录下了

docker cp :用于容器与主机之间的数据拷贝 

通过Docker部署SpringBoot项目

安装Redis

拉取镜像

https://registry.hub.docker.com/_/redis

因为我的项目里用到GEO命令,所以要拉取6.2以上的版本

docker pull redis:6.2.7 
  1. 创建redis配置文件目录
mkdir /usr/local/redis/conf mkdir /usr/local/redis/data touch /usr/local/redis/conf/redis.conf 

redis.conf文件内容非常的多(可到redis中文官方或者github里自己下一个)

中文地址:http://www.redis.cn/download.html

配置文件中主要关键的地方

bind 127.0.0.1 #使redis可以外部访问 daemonize no#用守护线程的方式启动 requirepass 你的密码#给redis设置密码 appendonly yes#redis持久化  默认是no tcp-keepalive 300 #防止出现远程主机强迫关闭了一个现有的连接的错误 默认是300 

一启动就闪退的原因:

redis.conf文件中的daemonize为yes,意思是redis服务在后台运行,与docker中的-d参数冲突了。

只要把daemonize的参数值改为no就可以了,再次执行以上命令,容器启动成功。

  1. 启动redis容器
docker run -p 6379:6379 --name redis  -v /usr/local/redis/data:/data  -v /usr/local/redis/redis.conf:/etc/redis/redis.conf  -d redis:6.2.7 redis-server /etc/redis/redis.conf  --appendonly yes 

容器随docker启动自动运行

# mysql docker update mysql --restart=always  # redis docker update redis --restart=always 

2.项目打包部署到Docker

引入Docker依赖

首先在 Maven pom.xml 配置文件中加入 Docker 的 Maven 插件

这里有两个插件可以实现我们需要的功能

docker-maven-plugindockerfile-maven

选择其中一个到maven仓库搜一个版本引入,我这里用的第一个,因为它只需要编写DockerFile就行

Spotify Maven 插件是一个目前比较普遍的选择。它要求应用程序开发人员编写Dockerfile,并把Dockerfile放在项目src/main/docker目录下

			<plugin>                 <groupId>com.spotify</groupId>                 <artifactId>docker-maven-plugin</artifactId>                 <version>1.0.0</version>                 <configuration>                     <!-- 指定 Dockerfile 路径  ${project.basedir}:项目根路径下-->                     <dockerDirectory>${project.basedir}</dockerDirectory>                     <!-- 这里是复制 jar 包到 docker 容器指定目录配置 -->                     <resources>                         <resource>                             <targetPath>/</targetPath>                             <!--jar 包所在的路径  此处配置的 即对应 target 目录-->                             <directory>${project.build.directory}</directory>                             <!-- 需要包含的 jar包 ,这里对应的是 Dockerfile中添加的文件名 -->                             <include>${project.build.finalName}.jar</include>                         </resource>                     </resources>                 </configuration>             </plugin> 

编写Dockerfile

Dockerfile是一种被Docker程序解释的脚本,Dockerfile由一条一条的指令组成,每条指令对应Linux下面的一条命令。Docker程序将这些Dockerfile指令翻译真正的Linux命令。Dockerfile有自己书写格式和支持的命令,Docker程序解决这些命令间的依赖关系,类似于Makefile。Docker程序将读取Dockerfile,根据指令生成定制的image。有了Dockerfile,当我们需要定制自己额外的需求时,只需在Dockerfile上添加或者修改指令,重新生成image即可,省去了敲命令的麻烦.

新建Dockerfile放在src/main/docker目录下(注意file是小写)

通过Docker部署SpringBoot项目

内容如下

#指定基础镜像源,以其为基础进行制作 FROM adoptopenjdk/openjdk8:latest # 维护者信息 MAINTAINER qhy #将jar包添加到容器中 ADD xxx.jar xxx.jar #对外暴露端口 EXPOSE 8080 # 运行jar包  CMD [java","-jar","xxx.jar"] 

注意信息:

ADD 、 COPY 指令用法一样,唯一不同的是 ADD 支持将归档文件(tar, gzip, bzip2, etc)做提取和解压操作。还有需要注意的是,COPY 指令需要复制的目录一定要放在 Dockerfile 文件的同级目录下

ENTRYPOINT 容器启动后执行的命令,让容器执行表现的像一个可执行程序一样,与CMD的区别是不可以被docker run覆盖,会把docker run后面的参数当作传递给ENTRYPOINT指令的参数。Dockerfile中只能指定一个ENTRYPOINT,如果指定了很多,只有最后一个有效。docker run命令的-entrypoint参数可以把指定的参数继续传递给ENTRYPOINT

打包项目

常用的两种构建方式

  • Dockerfile和jar上传到服务器进行构建
  • 利用Maven的Docker打包工具进行应用构建同时推送到远程仓库

这里我选择的第一种方式。最后会在target目录下生成jar包

这里借助的是springboot提供的maven-plugin这个依赖包.

通过Docker部署SpringBoot项目

mvn clean && mvn package 

通过Docker部署SpringBoot项目

执行package之后耐心等待打包成功

通过Docker部署SpringBoot项目

到这之后会在target目录生成一个jar包.

我们在本地把它运行起来进行访问测试,确认一切正常

通过Docker部署SpringBoot项目

制作镜像并运行

之前的准备工作做完,最令人期待的部分就来了.

通过XFTP将打包好的jar包和dockerfile上传到云服务器的指定目录

我这里传到了usr/local/src的新建目录下(目录下只有jar包和dockerFile)

通过Docker部署SpringBoot项目

执行docker build命令,docker就会根据Dockerfile里你定义好的命令进行构建新的镜像。

  • -t代表要构建的镜像
  • .代表当前目录
  • xxx代表镜像名称以及标签

因为Dockerfile我们之前写好了,所以直接执行命令构建镜像

docker build -t xxx . 

如果构建过程很慢,可以把同步时间配置去掉

通过Docker部署SpringBoot项目

查看镜像

docker images  

通过Docker部署SpringBoot项目

指定一个端口运行镜像

docker run -it -d --name xxxx -p 8080:8080 xxx 

基本参数

run:运行的意思 –name: 指定镜像启动的之后的名称 -p: 容器和外部的端口映射 第一个端口:外部 第二个端口:内部 -d: 后台运行 -t:实时运行,窗口关闭,程序结束。 xxx:镜像名称或id,确定你要启动的是哪一个镜像 

跟踪查看日志实时启动情况

docker logs -f xxx 

通过Docker部署SpringBoot项目

3.访问测试

经过之前的一系列折腾,我们已经成功把项目在服务器上部署完了,接下来只需要到云服务器控制台开放端口就完成了.

浏览器通过ip+端口号访问

此外,还可以使用nginx完成反向代理和https配置(需要提前申请并下载SSL证书)就能用自己的域名在浏览器上进行访问了.

这里不是本篇重点,我就不演示了,需要的自行配置即可

通过Docker部署SpringBoot项目

大致的效果就是如此

通过Docker部署SpringBoot项目

docker run -p 80:80 --name nginx   -v /usr/local/nginx/config/nginx.conf:/etc/nginx/nginx.conf   -v /usr/local/nginx/conf.d:/etc/nginx/conf.d   -v /usr/local/nginx/logs:/var/log/nginx   -v /usr/local/nginx/html:/usr/share/nginx/html   -d nginx 

参考文章:

Linux下通过Docker安装配置Mysql8.0

Linux下通过Docker安装配置Redis

win10下数据库快照迁移到Linux(https://blog.csdn.net/sinat_36831355/article/details/107342220)

[Linux安装Maven]https://www.cnblogs.com/fuzongle/p/12825048.html

[DockerFile编写]https://www.cnblogs.com/wangmo/p/6811321.html

[Docker安装Nginx并配置反向代理和SSL证书]https://blog.csdn.net/qq_36252295/article/details/122607203

【整体流程参照】

https://blog.csdn.net/qq_43173523/article/details/106076614

https://blog.csdn.net/qq_33220089/article/details/105104524