第一章 开发环境搭建

目录

第一章 开发环境搭建

前言

一、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 -versionjava 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 -vDocker version 20.10.22, build 3a2c30b

3.下载mysql镜像

在terminal中进行pull

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

wusq@helloworld ~ % docker pull mysql:5.7.375.7.37: Pulling from library/mysqlno 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.328.0.32: Pulling from arm64v8/mysql7d4ed4ca78bc: 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:6499d4392110bbcd65518b96cb64d67110dd191bb462c2f77a81a4c01e4c52ebStatus: Downloaded newer image for arm64v8/mysql:8.0.32docker.io/arm64v8/mysql:8.0.32

4.下载redis镜像

wusq@helloworld ~ % docker pull arm64v8/redis:6.2.106.2.10: Pulling from arm64v8/redis5731adb3a4ab: Pull complete e78ad00da4bd: Pull complete acf81d284940: Pull complete 3bb4963eea7d: Pull complete 0e96d949c48c: Pull complete 1f7b3a0544b2: Pull complete Digest: sha256:ee3fedb5b4af9efb8208d191bd1b148f134287bf52ac2c64354b1de06ef9c4e5Status: Downloaded newer image for arm64v8/redis:6.2.10docker.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-slimv2.2.0-slim: Pulling from nacos/nacos-servera9fe95647e78: Pull complete 4015b6e8cc8d: Pull complete 0e86b181efa0: Pull complete94abd992e68d: Pull complete 661feaa45879: Pull complete e0106ef68e8d: Pull complete 40988fbfabef: Pull complete 80ac9b361435: Pull complete 0c728ca010e6: Pull complete 4f4fb700ef54: Pull complete Digest: sha256:e9a4a10384399fce92f47e9115f5f3ee6375fef899735747b24f72468984619cStatus: Downloaded newer image for nacos/nacos-server:v2.2.0-slimdocker.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