【Ruoyi框架】SpringCloud 微服务版 超详细安装步骤

本文参考：
官方的文档地址：
http://doc.ruoyi.vip/ruoyi-cloud/
若依下载地址：
https://gitee.com/y_project/RuoYi-Cloud
教程参考地址
https://www.bilibili.com/video/BV1E5411J7L9?p=2&share_source=copy_web

一、若依框架

RuoYi-Cloud 是一个 Java EE 分布式微服务架构平台，基于经典技术组合（Spring Boot、Spring Cloud & Alibaba、Vue、Element），内置模块如：部门管理、角色用户、菜单及按钮授权、数据权限、系统参数、日志管理、代码生成等。在线定时任务配置；支持集群，支持多数据源。

简单来说：基于Spring Boot、Spring Cloud & Alibaba的分布式微服务架构权限管理系统

---

技术选型

1、系统环境

• Java EE 8
• Servlet 3.0
• Apache Maven 3

2、主框架

• Spring Boot 2.3.x
• Spring Cloud Hoxton.SR9
• Spring Framework 5.2.x
• Spring Security 5.2.x

3、持久层

• Apache MyBatis 3.5.x
• Hibernate Validation 6.0.x
• Alibaba Druid 1.2.x

4、视图层

• Vue 2.6.x
• Axios 0.21.0
• Element 2.14.x

二、部署准备

需要以下组件

JDK >= 1.8 (推荐1.8版本)
Mysql >= 5.7.0 (推荐5.7版本)
Redis >= 3.0
Maven >= 3.0
Node >= 12
nacos >= 1.1.0 (ruoyi-cloud >= 3.0.0需要下载nacos >= 2.x.x版本)
sentinel >= 1.6.0

三、正式开始

步骤预览：

1、安装Redis服务端和客户端

2、导入数据库

3、安装Nacos并配置MySQL数据库连接

4、引入RuoYi-Cloud

5、启动后端

6、启动前端

官网下载解压若依的压缩包：RuoYi-Cloud-master.zip

一、Redis安装

略，安装以下两个即可，进入manager测试可行即可

二、导入数据库

按官网的步骤来

3、创建数据库ry-cloud并导入数据脚本ry_2021xxxx.sql（必须），quartz.sql（可选）
4、创建数据库ry-config并导入数据脚本ry_config_2021xxxx.sql（必须）

三、安装nacos并配置MySQL数据库连接

1. 目前已安装nacos2.1.0。（可以从官网下载）

2. 修改nacos目录下的 conf/application.properties

   # 若依框架所需要的数据库依赖
   spring.datasource.platform=mysql
   db.num=1
   db.url.0=jdbc:mysql://localhost:3306/ry-config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
   db.user=root
   db.password=password
   

   添加的位置如下
   

3. 将nacos的启动模式设置为单机模式 standalone

4. 启动nacos，进入目录localhost:8848，进入后刷新出如下配置表就算成功

   

#配置nacos

nacos启动完毕，需要注意部分配置有关数据库和Redis的部分要进行修改

已查找到关于mysql的配置有：

• ruoyi-system-dev.yml 系统模块

• ruoyi-gen-dev.yml ：有关代码生成部分

• ruoyi-job-dev.yml配置如上

  • 每个模块修改完成后，要点击右下角的“发布”才能生效
    
    

---

四、引入RuoYi-Cloud

1. 打开IEDA，点击open，选择目录，可以引入项目。如下

• 加载需要一些时间

• 注意检查maven 配置目录，是否有误。最终加载结果如下:

2. 模块可以简单理解为两个部分：前端和后端

五、启动后端

启动前准备：回顾一下redis和数据库相关的配置——检查数据库是否创建、检查nacos配置是否已修改完成。并且确保mysql、nacos和redis服务都已经启动

启动后端的顺序：根据官网推荐来启动，打开运行基础模块（启动没有先后顺序）

• RuoYiGatewayApplication （网关模块 必须）
  • 前端访问的端口，将请求转发后端的微服务
• RuoYiAuthApplication （认证模块 必须）
  • 用户登陆的认证，可以获取token，结合token进行权限管理
• RuoYiSystemApplication （系统模块 必须）
  • 账号、权限、密码登陆在这个模块
• RuoYiMonitorApplication （监控中心 可选）
• RuoYiGenApplication （代码生成 可选）
• RuoYiJobApplication （定时任务 可选）
• RuoYFileApplication （文件服务 可选）

---

1. 第一次启动项目，就选择前三个必选模块进行测试

进入nacos检查确认都已经成功注册微服务。

如果启动时报错了，一定要检查一下对应的数据库和nacos是否已开启

2. 访问地址(http://localhost:8080 )出现提示后，就接下来可以进入尝试启动前端

六、启动前端

1. 使用npm启动前端项目，先复制前端所在的目录

2. （推荐）使用管理员模式打开cmd，切换到rouyi-ui所在的文件夹地址，输入指令：

   npm install或npm install --registry=http://registry.npm.taobao.org开始下载

最终不报错（ERROR）即可成功操作下一步

3. 输入指令npm run dev，下载相关的依赖后，即可启动本地的服务器

• 直接访问localhost就可以访问前端了（启动页面出现就算成功了）

若依的作者提醒

因为本项目是前后端分离的，所以需要前后端都部署好，才能进行访问

---