说明：本文介绍基于Ruoyi-Cloud前后端分离nacos版本的微服务从0到1的搭建过程，同时新增一个新的微服务模块。是基于官方文档的补充说明，需要结合Ruoyi-Cloud的官方文档 https://doc.ruoyi.vip/ruoyi-cloud/
如果直接查看官方文档便可成功部署，推荐直接看官方文档。
以下，我将从自己搭建安装过程中，遇到的坑和bug做详细补充说明，主要涵盖以下几个方面：
1、前置环境搭建（重要）：主要包含nacos、redis。
2、运行系统：主要包含前后端运行，以及运行过程中的关键确认点。

1 环境准备

建议下列组件安装在自己的本机上，或者安装在 可以和你的主机相互访问 的另一台服务器上，这样初次部署可以规避很多网络访问的坑。

JDK >= 1.8 (推荐1.8版本) # 独自安装即可
Mysql >= 5.7.0 (推荐5.7版本) # 独自安装即可
Redis >= 3.0 # 可以docker安装，参看 https://blog.csdn.net/MoastAll/article/details/129221742
Maven >= 3.0 # 独自安装接口
Node >= 12 # 独自安装即可
nacos >= 2.0.4 (ruoyi-cloud < 3.0 需要下载nacos >= 1.4.x版本) # docker安装

nacos的安装，可以参考我的另一个文章：docker安装nacos

2 运行系统

安装官方的操作进行代码下载和数据库配置

1、前往Gitee下载页面(https://gitee.com/y_project/RuoYi-Cloud (opens new window))下载解压到工作目录
2、导入到Eclipse，菜单 File -> Import，然后选择 Maven -> Existing Maven Projects，点击 Next> 按钮，选择工作目录，然后点击 Finish 按钮，即可成功导入。
Eclipse会自动加载Maven依赖包，初次加载会比较慢（根据自身网络情况而定）
3、创建数据库ry-cloud并导入数据脚本ry_2021xxxx.sql（必须），quartz.sql（可选）
4、创建数据库ry-config并导入数据脚本ry_config_2021xxxx.sql（必须）
5、配置nacos持久化，修改conf/application.properties文件，增加支持mysql数据源配置 # 在上文的docker安装nacos中，进行数据库配置。

需要注意的是，当我们吧ry-config数据导入完成后，请重启nacos，并登录nacos控制台，理论上是可以看到该界面的：
如果没有看到该界面，请查看你的

  • nacos是否有问题，有没有同时打开8848 9848 9849这三个端口
  • 是否存在网络问题：确保你的nacos所在服务器能够访问你在nacos配置文件中配置的数据库
  • 数据库配置是否错误：确保在ry-cloud.config_info表中配置的content数据连接内容（mysql、redis等），是可以被你的微服务直接访问的
    图一：nacos

2.1 后端运行

打开运行基础模块（启动没有先后顺序）
RuoYiGatewayApplication （网关模块 必须）
RuoYiAuthApplication （认证模块 必须）
RuoYiSystemApplication （系统模块 必须）
RuoYiMonitorApplication （监控中心 可选）
RuoYiGenApplication （代码生成 可选）
RuoYiJobApplication （定时任务 可选）
RuoYFileApplication （文件服务 可选）

2.2 前端运行

进入项目目录
cd ruoyi-ui
强烈建议不要用直接使用 cnpm 安装，会有各种诡异的 bug，可以通过重新指定 registry 来解决 npm 安装速度慢的问题。
npm install --registry=https://registry.npmmirror.com
本地开发 启动项目
npm run dev
4、打开浏览器，输入：(http://localhost:80 (opens new window)) 默认账户/密码 admin/admin123）
若能正确展示登录页面，并能成功登录，菜单及页面展示正常，则表明环境搭建成功

在这里插入图片描述

3 新建一个微服务module：ruoyi-jxbd

通过前两步骤，我们已经完成ruoyi-Cloud的启动，接下来我们需要做的基于该框架额外搭建一个微服务module，module名称就叫做：jxbd（不用问我为什么叫这个，随便起的）。

3.1 使用postman调用接口

做开发的第一步是模仿ruoyi的接口实现方式，首先我们要能使用postman调用若依的接口。
登录进ruoyi控制台，打开F12，然后刷新页面。可以看到一些请求接口，这里我们选择getInfo接口，如下图：
我们需要的三个信息：

  • 请求url：http://localhost/dev-api/system/user/getInfo
  • 请求方式：GET
  • 鉴权：Authorization
    在这里插入图片描述
    打开postman，并配置上述信息，发送请求即可，如下：
    在这里插入图片描述

3.2 模仿ruoyi-system模块，新建一个ruoyi-jxbd模块

先放截图：
在这里插入图片描述
基于ruoyi搭建一个新的module需要做的事情有如下几个方面：

  • 1、新增上图所述的目录结构和代码
  • 2、修改主pom文件，增加新模块
  • 3、在ry-cloud.config_info表中，新增一条记录，该记录用于新服务注册到nacos。
  • 4、启动新模块

3.2.1 新建ruoyi-jxbd模块

这个模块的创建，我是参考ruoyi-modules ruoyi-system进行创建的。学习的第一步，像素级复刻，开始！
在这里插入图片描述
完整的目录树，见上上图。需要重点关注的文件有：
pom.xml文件：该文件是参考system下面的pom修改的，需要修改的已在下文标注

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://maven.apache.org/POM/4.0.0"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>com.ruoyi</groupId>
        <artifactId>ruoyi</artifactId>
        <version>3.6.3</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    
	<!-- 修改为自己的名字 -->
    <artifactId>ruoyi-jxbd</artifactId>

    <description>
    	<!-- 修改为自己的名字 -->
        ruoyi-jxbd系统模块
    </description>

    <dependencies>

        <!-- SpringCloud Alibaba Nacos -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>

        <!-- SpringCloud Alibaba Nacos Config -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>

        <!-- SpringCloud Alibaba Sentinel -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
        </dependency>

        <!-- SpringBoot Actuator -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>

        <!-- Swagger UI -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>${swagger.fox.version}</version>
        </dependency>

        <!-- Mysql Connector -->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
        </dependency>

        <!-- RuoYi Common DataSource -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common-datasource</artifactId>
        </dependency>

        <!-- RuoYi Common DataScope -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common-datascope</artifactId>
        </dependency>

        <!-- RuoYi Common Log -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common-log</artifactId>
        </dependency>

        <!-- RuoYi Common Swagger -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common-swagger</artifactId>
        </dependency>

    </dependencies>

    <build>
        <finalName>${project.artifactId}</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

</project>

bootstrap.yml文件，需要注意的点：

  • 1、port，要注意不要和系统已占用的端口、若依的其他模块端口冲突，可以在ReadMe.md中查看ruoyi配置的默认端口。
  • 2、应用名称，修改为ruoyi-jxbd
# Tomcat
server:
  port: 9888

# Spring
spring: 
  application:
    # 应用名称
    name: ruoyi-jxbd
  profiles:
    # 环境配置
    active: dev
  cloud:
    nacos:
      discovery:
        # 服务注册地址
        server-addr: 127.0.0.1:8848
      config:
        # 配置中心地址
        server-addr: 127.0.0.1:8848
        # 配置文件格式
        file-extension: yml
        # 共享配置
        shared-configs:
          - application-${spring.profiles.active}.${spring.cloud.nacos.config.file-extension}

在这里插入图片描述
其余代码，像素级复刻SysConfigController的具体实现逻辑即可。

3.2.2 修改主pom文件

添加ruoyi-jxbd模块
在这里插入图片描述

3.2.3 新增nacos配置

在ry-cloud.config_info表中，新增一条记录：
该记录也是借鉴system模块修改的，主要关注的点：

  • 1、redis和mysql配置
  • 2、mybatis的包名称
INSERT INTO `ry-config`.config_info (id, data_id, group_id, content, md5, gmt_create, gmt_modified, src_user, src_ip, app_name, tenant_id, c_desc, c_use, effect, type, c_schema, encrypted_data_key) VALUES (10, 'ruoyi-jxbd-dev.yml', 'DEFAULT_GROUP', '# spring配置
spring:
  redis:
    host: 192.168.10.15
    port: 6379
    password:
  datasource:
    druid:
      stat-view-servlet:
        enabled: true
        loginUsername: admin
        loginPassword: 123456
    dynamic:
      druid:
        initial-size: 5
        min-idle: 5
        maxActive: 20
        maxWait: 60000
        connectTimeout: 30000
        socketTimeout: 60000
        timeBetweenEvictionRunsMillis: 60000
        minEvictableIdleTimeMillis: 300000
        validationQuery: SELECT 1 FROM DUAL
        testWhileIdle: true
        testOnBorrow: false
        testOnReturn: false
        poolPreparedStatements: true
        maxPoolPreparedStatementPerConnectionSize: 20
        filters: stat,slf4j
        connectionProperties: druid.stat.mergeSql\\=true;druid.stat.slowSqlMillis\\=5000
      datasource:
          # 主库数据源
          master:
            driver-class-name: com.mysql.cj.jdbc.Driver
            url: jdbc:mysql://xxxx:3306/database?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
            username: root
            password: xxxx
          # 从库数据源
          # slave:
            # username: 
            # password: 
            # url: 
            # driver-class-name: 

# mybatis配置
mybatis:
    # 搜索指定包别名
    typeAliasesPackage: com.ruoyi.jxbd
    # 配置mapper的扫描，找到所有的mapper.xml映射文件
    mapperLocations: classpath:mapper/**/*.xml

# swagger配置
swagger:
  title: 系统模块接口文档
  license: Powered By ruoyi
  licenseUrl: https://ruoyi.vip', '00678c89684ec0b825cb9b71e032db65', '2020-11-20 00:00:00', '2023-12-04 07:51:28', 'nacos', '0:0:0:0:0:0:0:1', '', '', '数据模块', 'null', 'null', 'yaml', '', '');

3.2.3 启动新的微服务模块

  • 1、重新编译整个代码工程
  • 2、重启nacos，确保nacos中有ruoyi-jxbd的配置
  • 3、启动gateway、auth、system、jxbd模块
    postman调用接口，即可，至此完工。

参考资料：
RuoYi-Cloud介绍 ：https://doc.ruoyi.vip/ruoyi-cloud/
Ruoyi-Cloud讨论：https://gitee.com/y_project/RuoYi-Cloud/issues/I4956F

# 微服务 # 架构 # 云原生
Logo
GitCode 开源社区

旨在为数千万中国开发者提供一个无缝且高效的云端环境，以支持学习、使用和贡献开源项目。

更多推荐

cover

GitTalk | 使用面向业务的狮偶编程语言提升开发效率

avatar GitCode 开源社区
cover

GitTalk | DevUI Suits 场景解决方案

avatar GitCode 开源社区
cover

GitTalk | DevUI Admin 前端项目构建

avatar GitCode 开源社区