后端基于 master 分支 fd17c6486a11688072cf870e2c1a5b74269e78c2

前端基于 ts 分支 cc9b67d4

笔记

此项目主要在 gitee 运营，推荐使用 gitee.com 的仓库

后端

git clone [email protected]:dromara/RuoYi-Cloud-Plus.git

• 2.X 主分支、新 2.X 版本、稳定发布分支
• JDK 要求：17

scoop bucket add java
scoop install java/openjdk17

初始化数据库

（MySQL）

文件名	参考库名	说明
ry-cloud.sql	ry-cloud	业务数据库，需要自行选择数据库
test.sql	-	业务测试表及数据，需插入到 ry-cloud 表中
ry-job.sql	ry-job	定时服务表，可创建一个新库，也可以插入 ry-cloud 库
ry-config.sql	ry-config	nacos 配置中心库（可选），内置 DROP DATABASE IF EXISTS ry-config; ，按需修改；由于我使用的外置 nacos，不需要此库。
ry-seata.sql	ry-seata	seata 分布式事务库（可选），内置 DROP DATABASE IF EXISTS ry-seata; ，按需修改；由于我使用的外置 seata，不需要此库。

• 创建一个库，如 ry-cloud
• 使用 idea 连接数据库
• 右键 \sql\ry-cloud.sql ， 运行'ry-cloud.sql'

Nacos 配置

以 NACOS 2.1.2 为例

• 命名空间 - 新建命名空间
  • 命名空间 ID： ruoyi_cloud_plus
  • 命名空间名： ruoyi_cloud_plus
  • 描述： ruoyi_cloud_plus
• 配置管理 - 配置列表 - 命名空间 ID ruoyi_cloud_plus
  • 新增配置
  • 将 /config/nacos 目录下，除 README.md 外的文件都配置进来。
    • Data ID 为文件名（含后缀），如 application-common.yml
    • 其他按需调整
• 修改项目主 pom.xml 文件中 nacos 相关连接配置，重新加载配置

修改项目读取的Nacos命名空间

由于项目默认使用 profiles.active 作为 nacos 配置的命名空间，即命名空间为 dev 、 prod ，如命名空间为其他时，则需要以下操作

• 主 pom.xml 文件 <properties> 新增 <nacos.namespace>命名空间ID</nacos.namespace>

<properties>
    <!-- 环境标识，需要与配置文件的名称相对应 -->
    <profiles.active>dev</profiles.active>
    <nacos.server>nacos.cloud-dev1:8848</nacos.server>
    <nacos.discovery.group>DEFAULT_GROUP</nacos.discovery.group>
    <nacos.config.group>DEFAULT_GROUP</nacos.config.group>
    <nacos.namespace>ruoyi_cloud_plus</nacos.namespace>
    <logstash.address>127.0.0.1:4560</logstash.address>
</properties>

• 全局替换 namespace: ${spring.profiles.active} 为 namespace: @nacos.namespace@ ，不包括 ruoyi-common 模块下的。

提示如以下错误

found character '@' that cannot start any token. (Do not use @ for indentation)
 in 'reader', line 14, column 13:

可尝试

mvn clean install
# 或是
mvn clean install -Dmaven.test.skip=true

调整配置

笔记

如果本地开发环境和部署到 k8s 集群的开发环境（前端对接使用）共用同一个配置，且数据库也是 k8s 集群中的，建议将数据库连接配置中的地址填写 MySQL、Redis 的 k8s service 的 DNS，如 mysql.cloud-dev1 ，而由于本地 DNS 无法解析此域名，因此需要再在 hosts 配置 mysql.cloud-dev1对应的service ip ，当然这里还有一个前提是实现 k8s 与本地互联互通（基于 Tailscale 实现的云组网）

Nacos：

• application-common.yml
  • 修改 redis 配置
• datasource.yml
  • 修改数据库配置
• seata-server.properties（使用自建 seata 时跳过）
  • 修改 seata 数据库配置

启动服务

• ruoyi-seata-server（使用自建 seata 时跳过）
  • ruoyi-seata-server：分布式事务服务，默认账号密码 seata/seata
• ruoyi-gateway：网关服务
• ruoyi-auth：鉴权服务

笔记

如提示 程序包org.dromara.common.mybatis.config不存在 ，可尝试

• maven clean 后重新 compile 编译
• 删除项目根目录下的.idea 文件，重新导入项目

java: 程序包 org.dromara.common.mybatis.config 不存在・Issue #I90HUF・dromara/RuoYi-Cloud-Plus - Gitee.com (opens new window)

前端

git clone [email protected]:JavaLionLi/plus-ui.git

npm install

npm run dev