單體升級為微服務2.4~3.1 · JeecgBoot 開發文檔

# JeecgBoot 單體改為微服務 >[info] Version:`2.4~3.1版本` | 20201201 *示例：將模塊 system、demo ，快速切換成 SpringCloud微服務方式啟動* **目錄：** [TOC] ## 一、配置host ``` 127.0.0.1 jeecg-boot-redis 127.0.0.1 jeecg-boot-mysql 127.0.0.1 jeecg-boot-rabbitmq 127.0.0.1 jeecg-boot-nacos 127.0.0.1 jeecg-boot-gateway 127.0.0.1 jeecg-boot-system 127.0.0.1 jeecg-boot-xxljob 127.0.0.1 jeecg-boot-sentinel ``` ## 二、放開微服務注釋修改 jeecg-boot根目錄下的pom文件，將此處的注釋打開 ![](https://img.kancloud.cn/55/0f/550fcf4a5a5f245245910c0e0773a247_614x182.png) ## 三、啟動Nacos * a. 創建nacos的數據庫，需要執行 [Nacos腳本](https://gitee.com/jeecg/jeecg-boot/tree/v3.1.0/jeecg-boot/db/tables_nacos.sql) ![](https://img.kancloud.cn/e4/fa/e4fa740b5e9063ea83050ea350c4b29f_365x218.png) * b.啟動nacos服務找到項目 jeecg-cloud-module/jeecg-cloud-nacos，右鍵執行類com.alibaba.nacos.JeecgNacosApplication ![](https://img.kancloud.cn/39/9e/399e2761547622d23a0bee52301eb16a_1746x506.png) * c.訪問nacos地址地址：http://127.0.0.1:8848/nacos（賬號密碼都是nacos）默認所需配置已初始化好 ![](https://img.kancloud.cn/44/81/448124e51cc8f28ecda373150fead760_1635x382.png) 經常需要改的配置在jeecg-dev.yaml,可以自己調整相關參數，也可以創建多個模式配置jeecg-{模式}.yaml。 ## 四、啟動jeecg-system服務 * 1.注釋system項目的pom中demo的引入依賴將 jeecg-boot-module-system/pom.xml 中的 demo 依賴注釋掉或者刪掉 ![](https://img.kancloud.cn/f6/0e/f60ed2287fdf7cad92150b812ab26658_549x223.png) * 2.修改打包配置修改 jeecg-boot-module-system/pom.xml 文件中spring-boot-maven-plugin 打包插件configuration.skip=true ![](https://img.kancloud.cn/1e/c0/1ec0ea5318e1d1c4045469bba0475c16_1222x624.png) * 3. 啟動system微服務 (jeecg-cloud-system-start) 找到jeecg-cloud-module/jeecg-cloud-system-start 下面的啟動類 org.jeecg.JeecgSystemCloudApplication 右鍵運行啟動。 ## 五、啟動jeecg-demo服務升級某個模塊為微服務模塊, 這里以demo為例 * 1. 添加微服務啟動依賴 `jeecg-boot-starter-cloud` ~~~  <dependency> <groupId>org.jeecgframework.boot</groupId> <artifactId>jeecg-boot-starter-cloud</artifactId> </dependency> ~~~ * 2.添加配置文件application.yml `（可以忽略）` 如果沒有則新建,內容如下： ~~~ server: port: 7002 spring: application: name: jeecg-demo ~~~ * 3.在org.jeecg包下新建啟動類`(如果沒有)` ~~~ package org.jeecg; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.cloud.openfeign.EnableFeignClients; @SpringBootApplication @EnableFeignClients public class JeecgDemoApplication { public static void main(String[] args) { SpringApplication.run(JeecgDemoApplication.class, args); } } ~~~ 上述步驟完成即可啟動 demo 微服務模塊，前提nacos配置啟動成功。 ## 六、啟動gateway jeecgboot 路由加載默認用的是`database數據庫`模式，同時支持三種模式：`yml本地配置` 、 `nacos配置` 、 `database數據庫`，其中nacos和數據庫方式支持動態刷新路由，詳細 [見路由配置](gateway高級配置.md)。啟動類： org.jeecg.JeecgGatewayApplication 啟動完成后nacos服務列表如下所示 ![](https://img.kancloud.cn/1d/6b/1d6b1e9e36bcd52468be3e8b94fd09de_1863x547.png) 查看在線接口文檔： http://127.0.0.1:9999/doc.html ![](https://img.kancloud.cn/01/cb/01cba09b5a246e4ba9d54ce86637f138_1869x850.png) ## 七、啟動前端前端項目找到環境配置文件.env.development 修改地址：`VUE_APP_API_BASE_URL=http://localhost:9999` 其中端口號 `9999`和`gateway`的端口保持一致 >[info] 注意：微服務方式訪問，對接的是gateway的地址，不再是system。 ![](https://img.kancloud.cn/8b/4b/8b4b155115b262682be04fa275148d0f_1125x485.png) 訪問系統首頁： http://localhost:3000 ![](https://img.kancloud.cn/1a/8e/1a8ef30e449e6f7c009999993b469b62_1916x993.png) ***** ## 八、高級應用 ### rabbitmq服務啟動 1、[安裝rabbitmq](https://my.oschina.net/jeecg/blog/4729143) 2、修改nacos中jeecg-dev.yaml的rabbitmq鏈接配置 ![](https://img.kancloud.cn/92/33/92335223ee614ad4fc87117e0b8ab310_814x506.png) 3、啟動system，rabbitmq隊列和交換機會自動生成詳細文檔見[ rabitmq消息隊列集成2.4+](http://doc.jeecg.com/2043897) ### xxljob服務啟動 1. 手工執行腳本[ jeecg-cloud-xxljob/doc/db/tables_xxl_job.sql](https://gitee.com/jeecg/jeecg-boot/blob/v3.1.0/jeecg-boot/db/tables_xxl_job.sql) 創建xxl_job庫 2. xxljob服務啟動，請右鍵執行` jeecg-cloud-xxljob/com.xxl.job.admin.XxlJobAdminApplication` 詳細文檔見[ xxl-job定時任務集成2.4+](http://doc.jeecg.com/2043895)