- 介绍
- 环境部署（我这里采用ruoyi-cloud3.1.0为例）
- 前期准备工作
- JDK 、Maven、Mysql、Node、IDEA基本的开发环境。
- 运行系统
- 第一步：下载压缩包使用idea选择pom文件作为项目打开
- 第二步：初始化数据库（建库建表）
- 第三步：完成注册中心（nacos）的配置和启动
- 第四步：启动后端项目
- 第五步：启动前端项目
- 常见问题
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
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官方文档）
