第一章 开发环境搭建
目录
前言
- 开发设备：
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 3a2c30b3.下载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 entriesTips：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.324.下载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访问应用
