RuoYi-Cloud微服务开发实战

第一章 开发环境搭建

---

目录

第一章 开发环境搭建

前言

一、RuoYi-Cloud是什么？

二、环境部署

1.安装JDK

2.安装docker

3.下载mysql镜像

4.下载redis镜像

5.下载nacos-server 镜像

6.安装node.js

三、项目启动

---

---

前言

• 开发设备：

        MacBook Pro（14英寸，2021年）

        系统版本：macOS Monterey

        芯片：Apple M1 Pro

        内存：16GB

• 开发相关工具：

        ideaIU-2022.3.2-aarch64

        navicat161_premium_en

---

一、RuoYi-Cloud是什么？

        RuoYi-Cloud是一款基于Spring Boot、Spring Cloud & Alibaba、Vue、Element的前后端分离微服务极速后台开发框架。基于经典技术组合（Spring Boot、Spring Cloud & Alibaba、Vue、Element），内置模块如：部门管理、角色用户、菜单及按钮授权、数据权限、系统参数、日志管理、代码生成等。在线定时任务配置；支持集群，支持多数据源。

1、系统环境

• Java EE 8
• Servlet 3.0
• Apache Maven 3

2、主框架

• Spring Boot 2.3.x
• Spring Cloud Hoxton.SR9
• Spring Framework 5.2.x
• Spring Security 5.2.x

3、持久层

• Apache MyBatis 3.5.x
• Hibernate Validation 6.0.x
• Alibaba Druid 1.2.x

4、视图层

• Vue 2.6.x
• Axios 0.21.0
• Element 2.14.x

二、环境部署

1.安装JDK

 首先打开Oracle官网的 JDK 下载地址，下载需要jdk版本，我下载的是jdk8版本

下载好安装包后，打开安装包，按下一步直接安装即可

检查是否安装成功 

wusq@helloworld ~ % java -version
java version "1.8.0_361"
Java(TM) SE Runtime Environment (build 1.8.0_361-b09)
Java HotSpot(TM) 64-Bit Server VM (build 25.361-b09, mixed mode)

2.安装docker

手动下载，请点击以下链接下载 Install Docker Desktop on Mac 

如同 macOS 其它软件一样，安装也非常简单，双击下载的 .dmg 文件，然后将鲸鱼图标拖拽到 Application 文件夹即可。

检查是否安装成功   

wusq@helloworld ~ % docker -v
Docker version 20.10.22, build 3a2c30b

3.下载mysql镜像

在terminal中进行pull

第一次下载报错，因为我使用的是apple m1 silicon，选择正确的芯片架构版本 arm64v8 

wusq@helloworld ~ % docker pull mysql:5.7.37
5.7.37: Pulling from library/mysql
no matching manifest for linux/arm64/v8 in the manifest list entries

Tips：Docker Documentation: How to Build, Share, and Run | Docker Documentation 在docker官网进行镜像查找，筛选支持arm64v8 版本即可

下载正确版本arm64v8/mysql:8.0.32，后续在idea中使用docker-compose启动

wusq@helloworld ~ % docker pull arm64v8/mysql:8.0.32
8.0.32: Pulling from arm64v8/mysql
7d4ed4ca78bc: Pull complete 
657a7ca448ac: Pull complete 
53bd78ce95ca: Pull complete 
c0e937b70acc: Pull complete 
c2bf3d14eb5e: Pull complete 
4f675b4a4ac0: Pull complete 
53482ccac7fa: Pull complete 
828f28210871: Pull complete 
1db57577e20b: Pull complete 
314e3cb90a9a: Pull complete 
408e09447dc6: Pull complete 
Digest: sha256:6499d4392110bbcd65518b96cb64d67110dd191bb462c2f77a81a4c01e4c52eb
Status: Downloaded newer image for arm64v8/mysql:8.0.32
docker.io/arm64v8/mysql:8.0.32

4.下载redis镜像

wusq@helloworld ~ % docker pull arm64v8/redis:6.2.10
6.2.10: Pulling from arm64v8/redis
5731adb3a4ab: Pull complete 
e78ad00da4bd: Pull complete 
acf81d284940: Pull complete 
3bb4963eea7d: Pull complete 
0e96d949c48c: Pull complete 
1f7b3a0544b2: Pull complete 
Digest: sha256:ee3fedb5b4af9efb8208d191bd1b148f134287bf52ac2c64354b1de06ef9c4e5
Status: Downloaded newer image for arm64v8/redis:6.2.10
docker.io/arm64v8/redis:6.2.10

下载正确版本arm64v8/redis:6.2.10，后续在idea中使用docker-compose启动 

5.下载nacos-server 镜像

wusq@helloworld ~ % docker pull nacos/nacos-server:v2.2.0-slim
v2.2.0-slim: Pulling from nacos/nacos-server
a9fe95647e78: Pull complete 
4015b6e8cc8d: Pull complete 
0e86b181efa0: Pull complete
94abd992e68d: Pull complete 
661feaa45879: Pull complete 
e0106ef68e8d: Pull complete 
40988fbfabef: Pull complete 
80ac9b361435: Pull complete 
0c728ca010e6: Pull complete 
4f4fb700ef54: Pull complete 
Digest: sha256:e9a4a10384399fce92f47e9115f5f3ee6375fef899735747b24f72468984619c
Status: Downloaded newer image for nacos/nacos-server:v2.2.0-slim
docker.io/nacos/nacos-server:v2.2.0-slim

下载正确版本nacos/nacos-server:v2.2.0-slim，后续在idea中使用docker-compose启动 

在docker应用中查看是否都下载成功 ，忽略截图中status，因为截图时候我已经启动了

6.安装node.js

        使用软件包的安装方式进行安装，到官网进行软件安装包下载安装即可https://nodejs.org/zh-cn/download/

         以上完成了最基础的运行环境相关软件部署

三、项目启动​​​​​​​

1、从gitee上下载项目到本地并打开

        https://gitee.com/y_project/RuoYi-Cloud

2、通过docker-compose启动，ruoyi-mysql,ruoyi-redis,ruoyi-nacos

        在idea的service面板中连接已经安装的macos版本的docker

         修改docker-compose.yml相关内容，主要是修改对应下载的软件mysql,redis,nacos镜像版本

         修改nacos的dockerfile文件，指定下载的镜像版本，再修改nacos的conf下的application.propertion文件中对应的mysql连接地址和用户名密码

 

    在service面板中通过 docker-compose启动mysql,redis,nacos

         都启动完成后，在docker中可以查看启动状态

3、打开运行基础模块（启动无先后顺序）

• RuoYiGatewayApplication （网关模块 必须）
• RuoYiAuthApplication （认证模块 必须）
• RuoYiSystemApplication （系统模块 必须）
• RuoYiMonitorApplication （监控中心 可选）
• RuoYiGenApplication （代码生成 可选）
• RuoYiJobApplication （定时任务 可选）
• RuoYFileApplication （文件服务 可选）

启动RouYiSystemApplication之前需要再nacos中修改对应ip

4、运行前端

        进入 ruoyi-ui目录下命令行

         执行相关部署启动命令

# 安装依赖
wusq@helloworld ruoyi-ui % npm install

# 解决由m1芯片和高版本node.js引起的错误需要设置node v17中的OpenSSL3.0对允许算法和密钥大小增加了严格的限制，可能会对生态系统造成一些影响
wusq@helloworld ruoyi-ui % export NODE_OPTIONS=--openssl-legacy-provider

# 本地开发 启动项目
wusq@helloworld ruoyi-ui % npm run dev  

---

总结

        启动完成后，通过ip+1024/index访问应用

        http://localhost:1024/index

        http://localhost:8848/nacos/index.html#/login