第二章:环境搭建:从零开始,手把手教你IDEA中搭建RuoYi-Cloud

2,664 阅读4分钟

RuoYi-Cloud系统要求

RuoYi-Cloud作为一个基于Spring Boot和Spring Cloud的分布式微服务架构平台,它的运行环境通常需要满足一定的硬件和软件条件。以下是RuoYi-Cloud运行所需的最低系统配置概述:

最低系统配置要求

硬件要求

  • 处理器: 至少双核CPU
  • 内存: 至少4GB RAM
  • 硬盘空间: 至少10GB可用空间

软件要求

  • 操作系统: Linux发行版(如Ubuntu、CentOS)、macOS或Windows(对于开发目的)
  • JDK: Java Development Kit 8 或更高版本
  • MySQL: 数据库版本5.7或8.0
  • Nacos: 配置中心和注册中心,版本2.x.x
  • Redis: 缓存服务,版本3.0或更高
  • Docker: 可选,用于容器化部署
  • Docker Compose: 可选,用于管理多容器应用
  • Node.js: 版本12或更高,用于前端构建
  • Nginx: 可选,用于反向代理和静态资源托管
  • 其他依赖: 如Quartz用于定时任务,以及其他特定业务需求的服务

开发工具

  • IDE: IntelliJ IDEA Community Edition 或 Ultimate Edition, Eclipse, Visual Studio Code等
  • Git: 版本控制工具
  • Maven或Gradle: 构建工具
  • Postman或类似工具: API测试 RuoYi-Cloud对于初学者要在IDEA开发工具中搭建并运行起来,着实不容易。因为工程默认使用的本机运行环境,换在远程服务器的方式,Nacos配置特别要注意,差点整迷糊了。

安装步骤

1. 克隆或下载项目

首先,从GitHub上克隆ruoyi-cloud项目到你的本地计算机。你可以使用Git命令行工具或者IDEA的VCS功能来完成这一步。

git clone https://github.com/ruoyi-framework/ruoyi-cloud.git

2. 导入项目到IDEA

  • 打开IntelliJ IDEA。
  • 选择 Open 或者 Import Project
  • 浏览到你刚才克隆的项目文件夹,并选择 pom.xml 文件。
  • IDEA会自动检测到这是一个Maven项目并提示你导入。点击 OK 或 Import 按钮。

image.png

3. 解析依赖

IDEA会自动解析项目的Maven依赖。如果需要加速依赖下载,可以配置代理服务器。

image.png

4. 配置环境

ruoyi-cloud是一个微服务架构的项目,通常需要配置好相应的环境,比如数据库连接信息、Redis等。确保你的开发环境中已安装并配置好了必要的服务(如MySQL, Redis等)安装这里不做详细介绍,自行安装。 开发服务器IP:192.168.0.100;MySQL数据库8.x,管理员账号root密码root,redis密码:123456 nacos默认账号nacos,密码nacos

  • 找到每个服务的application.ymlapplication.properties配置文件。
  • 根据实际情况修改数据库URL、用户名和密码等信息。 工程列表从上到下,按实际环境修改一遍,一般没什么问题,下面列举了网关、鉴权和系统管理三个工程的修改,其他模块一并修改即可。

image.png

image.png

image.png

5. Nacos配置

Nacos配置文件:

gitee.com/wensheng661…

ruoyi-cloud没有放配置文件,对初学者这地方有点坑。。。 下载配置文件把这些文件新增或导入到nacos并修改这些文件的内容跟开发服务器保持一致即可。 image.png

快速启动

6. 启动服务

ruoyi-cloud项目通常包含多个子模块,例如网关、认证服务、各个业务服务等。

  • 在IDEA中,找到你想启动的服务的主类(通常命名为Application),它位于每个子模块的根目录下。
  • 右键点击该类,选择 Run 'Application' 或者 Debug 'Application' 来启动服务。

image.png

7. 监控与调试

一旦服务启动,你就可以在IDEA的控制台窗口看到输出的日志信息。如果有任何问题,可以通过IDEA的调试功能来定位问题。

8. 使用Swagger文档

ruoyi-cloud通常集成了Swagger UI,用于展示API文档。启动所有必要的服务后,在浏览器中访问如下URL:

http://localhost:8080/swagger-ui/index.html

image.png

其中端口号是你启动的服务所绑定的端口。

以上就是使用IDEA运行ruoyi-cloud项目的步骤。如果你在过程中遇到任何问题,可以查阅项目的官方文档或搜索相关的解决方案。

doc.ruoyi.vip/ruoyi-cloud…