背景
若依的基本框架系列,已经构建起来,请参照 小白入门系列 - 鸡毛掸子
这些东西理解,并且实际板砖以后,有必要对现在流行的一些概念做一些升级,现在我们就进入到所谓的cloud版本,其实,前面的概念如果比较清晰,这里就是概念多一些,很多都是人家造好的轮子,直接怼就行。
关键是理解人家的思想和这些场景何时会用到,用到的时候深入也不晚,看一张让人晕的图,这个里面的模块一个个理顺了,这个系列就基本目标达到了。
技术梗概
与若依单体版的相对比,多了要给很重要的主框架
- Spring Cloud Hoxton.SR9
这个框架有个初步认识
SpringCloud框架
1、介绍
Spring Cloud是一系列框架的有序集合。它利用Spring Boot的开发便利性巧妙地简化了分布式系统基础设施的开发, 如服务发现注册、配置中心、消息总线、负载均衡、断路器、数据监控等,都可以用Spring Boot的开发风格做到一键启动和部署。 Spring Cloud并没有重复制造轮子,它只是将目前各家公司开发的比较成熟、经得起实际考验的服务框架组合起来, 通过Spring Boot风格进行再封装屏蔽掉了复杂的配置和实现原理,最终给开发者留出了一套简单易懂、易部署和易维护的分布式系统开发工具包。
2、优点
把模块拆分,使用接口通信,降低模块之间的耦合度。
把项目拆分成若干个子项目,不同的团队负责不同的子项目。
增加功能时只需要再增加一个子项目,调用其他系统的接口就可以。
可以灵活的进行分布式部署。
环境部署
前置配置
JDK >= 1.8 (推荐1.8版本)
Mysql >= 5.7.0 (推荐5.7版本) 5.6试验没问题
Redis >= 3.0 必须安装
Maven >= 3.0
Node >= 12
nacos >= 2.0.4 (ruoyi-cloud < 3.0 需要下载nacos >= 1.4.x版本)
sentinel >= 1.6.0
需要启动redis,nocos配置容易出问题;
下载ruoyi的源码
1、前往Gitee下载页面(https://gitee.com/y_project/RuoYi-Cloud(opens new window))下载解压到工作目录
2、idea 打开pom
3、创建数据库ry-cloud并导入数据脚本ry_2021xxxx.sql(必须),quartz.sql(可选)
4、创建数据库ry-config并导入数据脚本ry_config_2021xxxx.sql(必须)
5、配置nacos持久化,修改conf/application.properties文件,增加支持mysql数据源配置
下载 nacos-server,这个地方多啰嗦两句,这个nacos第一次接触的话,最容易出现问题,启动不了,很烦的,多从配置上找原因,或者读配置文件分析:
配置文件application.properties是在下载的nacos-server包conf目录下。
最新RuoYi-Cloud版本>=3.0.0需要下载的nacos-server必须>=2.x.x版本。
默认配置单机模式,nacos集群/多集群部署模式参考 (Nacos支持三种部署模式(opens new window))
修改对应nacos对应的配置,主要是数据库部分
修改 application.properties 位于noacos的conf目录下
Connect URL of DB: 需要修改对应的数据链接
容易出现的错误
name 'sysConfigServiceImpl': Invocation of init method failed; nested exception is org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.ruoyi.system.mapper.SysConfigMapper.selectConfigList
一般是配置mysql错误,nacos上面几个配置mysql的地方,配置中心,有的地方mysql没有配置
启动 注意端口问题
- mysql启动 数据库配置好
- redis启动
- nacos启动,看默认地址能否登录
- 启动后端三个模块
- RuoYiGatewayApplication (网关模块 必须)
- RuoYiAuthApplication (认证模块 必须)
- RuoYiSystemApplication (系统模块 必须)
- 启动前端 ,浏览器运行,
- 以上都可以的话,基本环境就搭建起来了。
部署
暂时在开发环境跑就可以,部署部分略
项目基本结构
com.ruoyi
├── ruoyi-ui // 前端框架 [80]
├── ruoyi-gateway // 网关模块 [8080]
├── ruoyi-auth // 认证中心 [9200]
├── ruoyi-api // 接口模块
│ └── ruoyi-api-system // 系统接口
├── ruoyi-common // 通用模块
│ └── ruoyi-common-core // 核心模块
│ └── ruoyi-common-datascope // 权限范围
│ └── ruoyi-common-datasource // 多数据源
│ └── ruoyi-common-log // 日志记录
│ └── ruoyi-common-redis // 缓存服务
│ └── ruoyi-common-seata // 分布式事务
│ └── ruoyi-common-security // 安全模块
│ └── ruoyi-common-swagger // 系统接口
├── ruoyi-modules // 业务模块
│ └── ruoyi-system // 系统模块 [9201]
│ └── ruoyi-gen // 代码生成 [9202]
│ └── ruoyi-job // 定时任务 [9203]
│ └── ruoyi-file // 文件服务 [9300]
├── ruoyi-visual // 图形化管理模块
│ └── ruoyi-visual-monitor // 监控中心 [9100]
├──pom.xml
可以看出,和以前基本是大同小异,主要是框架引入微服务,多了与之相关的模块,接下来就过一遍这些东西。