2.X项目初始化

• • -

    项目分支说明

2.X 主分支 新2.X版本 稳定发布分支

dev 开发分支 代码随时更新 不推荐使用 经测试后会发布到主分支

future/* 新功能预览分支

项目必备环境

推荐使用 docker 安装 项目内置 docker 编排文件

注意: 禁止使用 oraclejdk(由于spring的bug导致打包运行会报错)

**Spring官方推荐使用JDK https://bell-sw.com/pages/downloads/**

• openjdk-17/21 或 graalvm-community-jdk-17/21 下载地址 版本
• mysql 5.7 8.0 (其他版本未测试 如其他版本没问题 可以告知咱们)
• oracle >= 12c (其他版本未测试 如其他版本没问题 可以告知咱们)
• postgres 13 14 (其他版本未测试 如其他版本没问题 可以告知咱们)
• redis 5.X 6.X 7.X 由于框架大量使用了redis特性 版本必须 >= 5.X (win redis 下载地址)
• minio 本地文件存储 或 阿里云 腾讯云 七牛云等一切支持S3协议的云存储
• maven >= 3.8.X
• nodejs 18.18 (其他版本未测试 如其他版本没问题 可以告知咱们)
• npm >= 8.X (7.X确认有问题)
• idea 2022 2024 (一定不要使用2023后果自负 bug太多影响项目开发)
• nacos >= 2.X(框架已经内置 采用nacos官方jar包)
• sentinel 框架内置(采用sentinel官方jar包)
• seata 框架内置(采用seata官方jar包)

需勾选 maven 对应环境

默认 JDK17 如有变动 需更改以下配置

sql导入

将sql导入到与sql文件名对应的数据库(不要放到一个库下)

默认数据库为mysql如需使用其他数据库 看这里 => 多数据库数据源

使用内置 ruoyi-naocs 服务 从这开始

更改 ruoyi-nacos 数据库地址

**其余流程同下方步骤一致**

自建 Nacos 从这开始

**Nacos 数据库指向 ry-config 数据库(此处重点: 此数据库为定制数据 未使用此库会无法读取配置)**

将项目 config/nacos 下所有配置 复制到 nacos 内(建议手动复制内容 防止编码不一致问题)

注意: 不懂就不要乱改配置文件内容 框架内所有功能都是配置好的!!!不要画蛇添足

注意: 不懂就不要乱改配置文件内容 框架内所有功能都是配置好的!!!不要画蛇添足

注意: 不懂就不要乱改配置文件内容 框架内所有功能都是配置好的!!!不要画蛇添足

更改 主pom文件 对应环境的 nacos 地址

更改 Nacos 自定义配置

忠告: 微服务配置相当复杂 请勿在不懂原理的情况下乱改

忠告: 微服务配置相当复杂 请勿在不懂原理的情况下乱改

忠告: 微服务配置相当复杂 请勿在不懂原理的情况下乱改

application-common.yml 更改

datasource.yml 更改

seata-server.properties 更改

使用内置 ruoyi-seata-server 服务 从这开始

执行 ry-seata.sql 文件 初始化服务端数据库

修改 nacos 内的 seata-server.properties 的数据库地址

启动 ruoyi-seata-server 服务即可

服务启动顺序说明

1. 必须启动基础建设: mysql redis nacos
   
2. 可选启动基础建设: minio(影响文件上传) seata(影响分布式事务 默认开启) sentinel(影响熔断限流) monitor(影响监控) snailjob(影响定时任务)
   
3. 必须启动应用服务: gateway auth system
   
4. 可选启动应用服务: resource(影响资源使用 websocket 文件上传 邮件 短信等) workflow(工作流) gen(代码生成) job(影响定时任务) demo(影响demo使用)