RuoYi Cloud是基于Spring Cloud、Spring Boot和Vue.js的開源微服務(wù)快速開發(fā)平臺,廣泛應(yīng)用于企業(yè)級后臺管理系統(tǒng)。本文將詳細(xì)介紹如何本地部署RuoYi Cloud v3.6.4,并快速構(gòu)建一個拖車管理后臺。
一、環(huán)境準(zhǔn)備
- JDK 1.8+:確保已安裝Java開發(fā)環(huán)境,推薦JDK 8或11。
- Maven 3.0+:用于項(xiàng)目依賴管理和構(gòu)建。
- MySQL 5.7+:數(shù)據(jù)庫存儲,建議使用MySQL 8.0。
- Redis 5.0+:緩存服務(wù)。
- Node.js 12+:前端環(huán)境,用于運(yùn)行Vue.js項(xiàng)目。
- Git:用于從GitHub克隆項(xiàng)目源碼。
二、下載與配置
1. 獲取源碼:從RuoYi Cloud官方GitHub倉庫下載v3.6.4版本或使用Git命令克隆。
`bash
git clone https://github.com/ruoyi-cloud/ruoyi-cloud.git
`
- 導(dǎo)入數(shù)據(jù)庫:
- 創(chuàng)建數(shù)據(jù)庫(如
ry-cloud)。
- 執(zhí)行
sql目錄下的腳本:ry<em>2023xxxx.sql(基礎(chǔ)表)和ry</em>config_2023xxxx.sql(配置表)。
- 修改配置文件:
- 在
ruoyi-auth、ruoyi-gateway、ruoyi-modules等模塊的application.yml中,更新MySQL和Redis的連接信息(如數(shù)據(jù)庫URL、用戶名、密碼、Redis主機(jī)和端口)。
三、后端啟動
- 啟動順序:
- 先啟動注冊中心(
ruoyi-nacos),默認(rèn)端口8848。
- 再依次啟動
ruoyi-gateway(網(wǎng)關(guān),端口8080)、ruoyi-auth(認(rèn)證服務(wù),端口9200)、ruoyi-modules/system(系統(tǒng)模塊,端口9201)等核心服務(wù)。
- 驗(yàn)證后端:訪問Nacos控制臺(http://localhost:8848/nacos),確認(rèn)所有服務(wù)已注冊。
四、前端部署
1. 安裝依賴:進(jìn)入ruoyi-ui目錄,運(yùn)行以下命令安裝Node.js依賴。
`bash
npm install
`
2. 修改配置:在ruoyi-ui的.env.development文件中,將VUE<em>APP</em>BASE_API設(shè)置為后端網(wǎng)關(guān)地址(如http://localhost:8080)。
3. 啟動前端:運(yùn)行開發(fā)服務(wù)器。
`bash
npm run dev
`
- 訪問系統(tǒng):打開瀏覽器訪問http://localhost:80,使用默認(rèn)賬號admin和密碼admin123登錄。
五、構(gòu)建拖車管理后臺
- 添加拖車管理模塊:
- 在
ruoyi-modules下創(chuàng)建新模塊(如ruoyi-modules/trailer),參考現(xiàn)有模塊結(jié)構(gòu),包含controller、service、mapper和實(shí)體類。
- 定義拖車實(shí)體,包括車牌號、型號、狀態(tài)、所屬公司等字段。
- 數(shù)據(jù)庫擴(kuò)展:在MySQL中創(chuàng)建拖車表(如
trailer_info),并同步更新MyBatis映射文件。 - 前端頁面開發(fā):
- 在
ruoyi-ui的views目錄下新建拖車管理頁面,使用Vue.js和Element UI實(shí)現(xiàn)增刪改查功能。
- 通過API調(diào)用后端服務(wù),接口路徑為
/trailer/**,由網(wǎng)關(guān)路由到拖車模塊。
- 權(quán)限配置:在RuoYi Cloud后臺的“系統(tǒng)管理”中,添加拖車管理的菜單和角色權(quán)限。
六、測試與優(yōu)化
- 功能測試:驗(yàn)證拖車管理的CRUD操作、搜索和分頁功能。
- 性能監(jiān)控:集成Spring Boot Actuator或SkyWalking,監(jiān)控服務(wù)性能。
- 部署優(yōu)化:本地調(diào)試完成后,可打包為Docker鏡像或JAR文件,便于生產(chǎn)環(huán)境部署。
七、常見問題
- 端口沖突:確保各服務(wù)端口未被占用,可在
application.yml中調(diào)整。 - 依賴下載失敗:檢查Maven鏡像配置,或使用阿里云鏡像加速。
- 前端跨域問題:通過網(wǎng)關(guān)配置CORS或Nginx代理解決。
通過以上步驟,您可以在本地成功部署RuoYi Cloud v3.6.4,并快速擴(kuò)展為拖車管理后臺。該平臺提供了豐富的微服務(wù)組件和代碼生成器,可進(jìn)一步加速開發(fā)流程,滿足企業(yè)級應(yīng)用需求。