Jenkins+Gitee+Docker+Ruoyi项目前后端分离部署

前言

描述：本文主要是用来记录如何用标题上的技术，部署到云服务器上通过ip正常访问。

一、总览

1.1、Docker做的事

拉取 mysql 镜像
拉取 redis 镜像
拉取 jdk 镜像
拉取 nginx 镜像

解释说明：前端项目的打包文件放在 nginx容器运行。后端的jar包放在jdk容器运行。另外两个是后端项目需要用到的数据库。

1.2、Jenkins做的事

解释说明：去 Gitee仓库拉取源代码，自动化构建、打包、部署到云服务器上运行。

二、Docker 实战

2.1 拉取 mysql 镜像

命令如下所示：

shell 复制代码

# 拉取镜像
docker pull mysql:8.0
# 启动命令
docker run -p 3306:3306 --name mysql -v $PWD/conf/my.cnf:/etc/mysql/my.cnf -v $PWD/logs:/logs -v $PWD/data:/mysql_data -e MYSQL_ROOT_PASSWORD=000000 -d mysql:8.0

通过远程连接工具，测试mysql是否创建成功，然后创建数据库，导入数据表。

需要在后端的 ruoyi-admin模块的某个配置文件内，修改相关配置，包括url、端口号、账户、密码。

2.2 拉取 redis 镜像

命令如下所示：

shell 复制代码

# 拉取镜像
docker pull redis

2.2.1 配置文件

（1）创建目录

shell 复制代码

mkdir -p /docker/redis 
mkdir -p /docker/redis/data 
touch /docker/redis/redis.conf 
touch /docker/redis/redis.bash

（2）编辑配置文件 vim /docker/redis/redis.conf

shell 复制代码

# Redis默认不是以守护进程的方式运行，可以通过该配置项修改，使用yes启用守护进程
daemonize no

# 指定Redis监听端口，默认端口为6379
port 6379

# 绑定的主机地址，不要绑定容器的本地127.0.0.1地址，因为这样就无法在容器外部访问
bind 0.0.0.0

#需要密码则打开
requirepass 000000

# 持久化
appendonly yes

（3）编辑bash文件 - vi /docker/redis/redis.bash

shell 复制代码

docker run -p 6379:6379 --name redis -v /docker/redis/redis.conf:/etc/redis/redis.conf -v /docker/redis/data:/data -d redis redis-server /etc/redis/redis.conf

（4）开放执行权限

shell 复制代码

chmod 777 /docker/redis/redis.bash

（5）修改代码配置文件

需要在后端的 ruoyi-admin模块的某个配置文件内，修改相关配置，包括url、端口号、账户、密码。

2.3 拉取 jdk 镜像

shell 复制代码

# 拉取 jdk 镜像
docker pull kdvolder/jdk8

（2）前提：需要把jar包放在 /root/ruoyi-admin/target目录下（可自定义->配合启动命令即可）

（3）编辑bash文件 - vi /docker/ruoyi-admin/ruoyi-admin.bash

shell 复制代码

docker stop ruoyi-admin;docker rm ruoyi-admin;docker run -d --restart=always -v /root/ruoyi-admin/target:/jar -v /home/ruoyi/logs:/home/ruoyi/logs -p 8080:8080 --name ruoyi-admin kdvolder/jdk8 /usr/bin/java -jar -Duser.timezone=GMT+08 /jar/ruoyi-admin.jar

（4）开放执行权限

shell 复制代码

chmod 777 /docker/ruoyi-admin/ruoyi-admin.bash

（5）执行命令

shell 复制代码

/docker/ruoyi-admin/ruoyi-admin.bash

2.4 拉取 nginx 镜像

shell 复制代码

# 拉取镜像
docker pull nginx

（2）创建bash文件- vi /docker/ruoyi-ui/ruoyi-ui.bash

shell 复制代码

cp -rf /root/nginx/* /mydata/nginx/html;docker stop ruoyi-ui;docker rm ruoyi-ui;docker run -d --privileged=true --name ruoyi-ui -v /mydata/nginx/html:/usr/share/nginx/html -v /mydata/nginx/nginx.conf:/etc/nginx/nginx.conf -p 80:80 nginx

解释：为什么要先复制一下文件，因为Jenkins那边构建好了，传送文件过来就是/root目录下，所以本人给它复制到我规定的目录下。

（3）创建配置文件

shell 复制代码

worker_processes  1;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  65;

    server {
        listen       80;
        server_name  localhost;
		charset utf-8;

		location / {
            root   /usr/share/nginx/html;
	        try_files $uri $uri/ /index.html;
            index  index.html index.htm;
        }
    	error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}

解释：需要注意 root /usr/share/nginx/html;配置，需要对应启动命令里面容器内部存放的实际路径。本人因为设置成外部路径，然后通过ip访问遇到500 Internal Server Error的错误。

二、Jenkins 实战

实验环境：Windows 安装的 Jenkins 安装包

启动命令：在安装包所在目录下：java -jar jenkins.war 启动，通过端口号访问。具体的使用方法不在此文赘述。

描述：本次实验中没有用到流水线，通过安装插件，后端创建 maven 的项目，前端创建 freeStyle project。

2.1 安装的插件如下所示：

Maven Integration plugin
- 描述：主要是后端构建用到
Publish Over SSH
- 描述：推送文件到远程服务器
NodeJS Plugin
- 描述：主要是前端构建需要用到

（1）安装完Publish Over SSH插件后，需要在 Manage Jenkins-> Jenkins下面配置远程服务器的信息

（2）安装完 NodeJS Plugin 以后，需要在 Manage Jenkins->Tools 配置 windows实际安装的 node路径即可。(顺便把 Maven 的安装路径也配置一下)

2.2 构建后端

构建一个 maven 项目即可。

2.2.1 填写源码仓库信息

解释：第二个框指的是 gitee 上面的仓库地址。

2.2.2 Post Steps设置

（1）勾选 SSH 设置

（2）填写包路径配置信息

描述：

第一个配置是选择jenkins系统配置的ssh服务器
第二个指后端项目打包后的路径和文件
第三个指远程服务器执行的命令

（3）保存以后，构建即可。

声明：如果构建失败，有可能是配置出问题，这个需要自己排查了。本文主要记录个大概思路，也许会漏掉一些细节，导致最后实验失败。

（4）如果构建成功，检查云服务器的docker容器是否启动。浏览器访问路径ip:port，即可。

2.3 构建前端

（1）创建一个 freestyle project 项目。

（2）配置源码管理，如上面后端所示：

（3）构建环境，勾选Provide Node & npm bin/ folder to PATH，需要安装上面的插件，才会有这个选项

（4）Build Steps：由于我是windows环境，这里需要新增 Execute Windows batch command，在方框下输入构建命令 npm install --registry=https://registry.npmmirror.com & npm run build:stage，如下图所示：

（5）构建后操作：配置ssh服务器以及相关命令

需要新增勾选 Send build artifacts over SSH，配置信息如下图所示：

解释：主要是告诉它，构建后的目录是什么，需要过滤掉 dist目录，以及最后存放在远程服务器的nginx目录下，最后发送完文件后，执行 bash脚本命令。

（6）保存后，点击Build Now即可。测试路径是IP:Port即可，前端一般是默认80端口，用ip访问即可。

当很重要的是在前端代码里面，需要把ip改成后端实际服务的ip。

提示：更改文件是 .env.staging文件的 VUE_APP_BASE_API = 'IP:Port'。

总结

整个构建过程大概就是这样。全部完成以后，就可以通过jenkins完成一整套的流程了。