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