1.X项目初始化

• • -

    项目分支说明

    master 主分支 稳定发布分支
    
    dev 开发分支 代码随时更新 不推荐使用 经测试后会发布到主分支
    
    2.X 新2.X大版本分支
    
    future/* 新功能预览分支

项目必备环境

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

• oracle jdk 8 11 (暂时不支持 17 不支持大于 jdk8_202 因为202是最后一个免费版本)
• mysql 5.7 8.0 (5.6未适配可能会有问题)
• oracle 11g 12c
• postgres 13 14
• redis 5.X 6.X 7.X 由于框架大量使用了redis特性 版本必须 >= 5.X (win redis 下载地址)
• minio 本地文件存储 或 阿里云 腾讯云 七牛云等一切支持S3协议的云存储
• maven 3.6.3 3.8.X
• nodejs >= 12
• npm 6.X 8.X (7.X确认有问题)
• nacos >= 2.X(框架1.3.0内置nacos)
• sentinel 框架内置
• seata 框架内置

需勾选 maven 对应环境

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

sql导入

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

使用内置 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(影响监控) xxljob(影响定时任务)
   
3. 必须启动应用服务: gateway auth system
   
4. 可选启动应用服务: resource(影响资源使用 文件上传 邮件 短信等) gen(代码生成) job(影响定时任务) demo(影响demo使用)