- A+
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版本信息
docker version
安装JDK
耐心等待安装完成
yum -y install java-1.8.0-openjdk
查找java所在位置
whereis java
配置环境变量
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
安装Maven
方式有很多种,自己到Maven官网下载上传到服务器解压或者直接wget命令安装(通过yum安装weget命令).我这里选用第一种.
本质上和在win10下安装没什么区别都是下载->解压->配置镜像和仓库->配置环境变量这几个步骤
下载Maven
Maven官网:
https://maven.apache.org/docs/history.html
下载Linux版本,然后传到云服务器手动解压安装
可以直接下载最新版本,但我个人一般习惯往前找几个版本的,所以继续往下滑
1.看到标题停下来,它给我们指明了更早的版本在哪去找
2.二进制文件就是我们要的,source指的是源码
3.选择对应Linux的版本
上传到服务器并解压
把它下载然后上传到服务器指定目录下(我这里用XFTP传到了usr/local目录下)
这时候解压它就行
通过如下命令解压
tar -zxvf apache-maven-3.6.3-bin.tar.gz
配置镜像和本地仓库信息
上面这个就是解压后的文件夹,只需要配置下国内镜像地址和本地仓库位置信息就可以用了。
cd apache-maven-3.6.3 #进入apache-maven-3.6.3目录
这时候可以新建一个目录,用作后续修改配置文件,存放maven下载的jar
mkdir repository #创建目录存放后续maven下载jar包
进入conf目录,通过vim修改settings.xml,配置镜像和本地仓库信息
vim基本操作:
i
:进入编辑模式
esc +!:wq
: 保存并退出
cd conf #进入conf目录
vim settings.xml #编辑配置文件
配置文件里我们只关心mirrors根节点下的镜像和localRepository根节点下的本地仓库位置
本地仓库:解除注释,把位置改成之前自己创建的仓库目录的完整路径
<localRepository>/usr/local/apache-maven-3.6.3/repository</localRepository>
镜像地址:注意name和url这些不要搞错了
<mirror> <id>alimaven</id> <name>aliyun maven</name> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror>
修改完以上的两处,保存并退出就行。
配置环境变量
接下来是,依旧是配置环境变量
vim /etc/profile
编辑/etc/profile 文件,系统环境变量都在这配置
export MAVEN_HOME=/usr/local/apache-maven-3.6.3 export PATH=$PATH:$MAVEN_HOME/bin
刷新配置文件:
source /etc/profile
查看Maven版本信息
mvn -v
以下的Mysql和Redis的安装只是因为我的项目用到了,如果只是自己体验整个部署流程的话不需要安装
安装Mysql
到DockerHub找一个mysql镜像,我这里用的mysql8
https://hub.docker.com/_/mysql
到tags下搜索,然后复制命令拉取镜像就行
- 拉取镜像
docker pull mysql:8.0
- 查看镜像
docker images
这里DockerHub官方也给了关于如何使用和连接的指南
- 创建并修改配置文件
创建两个文件夹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
- 启动并运行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
参数说明
-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 :用于容器与主机之间的数据拷贝
安装Redis
拉取镜像
https://registry.hub.docker.com/_/redis
因为我的项目里用到GEO命令,所以要拉取6.2以上的版本
docker pull redis:6.2.7
- 创建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就可以了,再次执行以上命令,容器启动成功。
- 启动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-plugin
和dockerfile-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是小写)
内容如下
#指定基础镜像源,以其为基础进行制作 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这个依赖包.
mvn clean && mvn package
执行package之后耐心等待打包成功
到这之后会在target目录生成一个jar包.
我们在本地把它运行起来进行访问测试,确认一切正常
制作镜像并运行
之前的准备工作做完,最令人期待的部分就来了.
通过XFTP将打包好的jar包和dockerfile上传到云服务器的指定目录
我这里传到了usr/local/src的新建目录下(目录下只有jar包和dockerFile)
执行docker build命令,docker就会根据Dockerfile里你定义好的命令进行构建新的镜像。
- -t代表要构建的镜像
- .代表当前目录
- xxx代表镜像名称以及标签
因为Dockerfile我们之前写好了,所以直接执行命令构建镜像
docker build -t xxx .
如果构建过程很慢,可以把同步时间配置去掉
查看镜像
docker images
指定一个端口运行镜像
docker run -it -d --name xxxx -p 8080:8080 xxx
基本参数
run:运行的意思 –name: 指定镜像启动的之后的名称 -p: 容器和外部的端口映射 第一个端口:外部 第二个端口:内部 -d: 后台运行 -t:实时运行,窗口关闭,程序结束。 xxx:镜像名称或id,确定你要启动的是哪一个镜像
跟踪查看日志实时启动情况
docker logs -f xxx
3.访问测试
经过之前的一系列折腾,我们已经成功把项目在服务器上部署完了,接下来只需要到云服务器控制台开放端口就完成了.
浏览器通过ip+端口号访问
此外,还可以使用nginx完成反向代理和https配置(需要提前申请并下载SSL证书)就能用自己的域名在浏览器上进行访问了.
这里不是本篇重点,我就不演示了,需要的自行配置即可
大致的效果就是如此
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
参考文章:
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
【整体流程参照】