介绍

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

环境部署（我这里采用ruoyi-cloud3.1.0为例）

前期准备工作

若依官网：http://ruoyi.vip(opens new window)

演示地址：http://cloud.ruoyi.vip(opens new window)

代码下载：https://gitee.com/y_project/RuoYi-Cloud

注册中心（nacos）下载：https://www.aliyundrive.com/s/rUZZHURrY2K

JDK 、Maven、Mysql、Node、IDEA基本的开发环境。

• JDK >= 1.8 （推荐1.8版本）
• MySQL >= 5.7.0（推荐5.7版本）
• Maven >= 3.0
• Redis >= 3.0
• Node >= 10
• nacos >= 1.1.0（ruoyi-cloud >= 3.0.0需要下载nacos >= 2.x.x版本）
• sentinel >= 1.6.0

运行系统

第一步：下载压缩包使用idea选择pom文件作为项目打开

第二步：初始化数据库（建库建表）

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

3、执行完上述操作将会得到三个数据库

至此数据库初始化完成

第三步：完成注册中心（nacos）的配置和启动

解压下载好的nacos压缩包，打开nacos文件夹找到conf文件夹下的application.properties并修改以下配置

# db mysql
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

修改好配置以后返回上一级目录找到bin目录并进入找到 startup.cmd 文件

打开此文件找到下面这行代码

set MODE="cluster"  --修改为standalone
set FUNCTION_MODE="all"
set SERVER=nacos-server
set MODE_INDEX=-1
set FUNCTION_MODE_INDEX=-1
set SERVER_INDEX=-1
cluster 表示以集群的方式运行
standalone 表示以单机的方式运行
修改完后保存运行 startup.cmd
nacos启动成功

浏览器打开 http://localhost:8848/nacos 登录的用户名和密码都为nacos

进入后可看到初始化数据库时建的表中的配置文件

以系统模块的配置文件ruoyi-system-dev.yml为例

修改后发布即可完成配置文件的更新。

至此注册中心（nacos）配置完成

--提示
nacos配置文件里面一定要把数据库的用户名和密码修改成自己的

第四步：启动后端项目

在启动后端项目之前，你需要本地启动Redis服务端，以及Nacos

然后打开运行基础模块（启动没有先后顺序）

RuoYiGatewayApplication （网关模块 必须）

RuoYiAuthApplication （认证模块 必须）

RuoYiSystemApplication （系统模块 必须）

RuoYiMonitorApplication （监控中心 可选）

RuoYiGenApplication （代码生成 可选）

RuoYiJobApplication （定时任务 可选）

RuoYFileApplication （文件服务 可选）

至此后端配置完成

第五步：启动前端项目

在启动前端项目之前，你需要完成了nodejs的安装与配置

# 进入项目目录
cd ruoyi-ui

# 安装依赖
npm install

# 强烈建议不要用直接使用 cnpm 安装，会有各种诡异的 bug，可以通过重新指定 registry 来解决 npm 安装速度慢的问题。
npm install --registry=https://registry.npm.taobao.org

# 本地开发 启动项目
npm run dev

至此微服务版开发环境部署成功。

常见问题

• 启动nacos时报错，提示没有数据源。原因：配置没修改对。需要检查配置文件。
• 启动系统模块时报错，原因就是注册中心没配置或者是数据库的密码没修改成本地的，只要nacos成功运行启动了，能进入看到几个配置文件，基本上没啥问题。
• 如果使用Mac需要修改application.yml文件路径profile
• 如果使用Linux提示表不存在，设置大小写敏感配置在/etc/my.cnf添加lower_case_table_names=1，重启MYSQL服务
• 如果提示当前权限不足，无法写入文件请检查application.yml中的profile路径或logback.xml中的log.path路径是否有可读可写操作权限

http://doc.ruoyi.vip/ruoyi-cloud/ （RuoYi-Cloud官方文档）