單體升級為微服務3.4 · JeecgBoot 開發文檔

# 單體升級微服務 >[info] Version: 3.4以上版本 | 20220806 > >**3.4+重大升級說明** > - 升級[Spring Cloud Alibaba 2021.0.1.0](https://github.com/alibaba/spring-cloud-alibaba/blob/2021.x/spring-cloud-alibaba-docs/src/main/asciidoc-zh/sca-upgrade-guide.adoc)，使用 spring.config.import 方式引入nacos配置 > - 拆分jeecg-boot-starter出來，使用獨立項目維護 [jeecg-boot-starter項目新地址](https://gitee.com/jeecg/jeecg-boot-starter) [TOC] *示例：將模塊 system、demo ，快速切換成 SpringCloud微服務啟動* ## 一、配置host >[warning] 提醒：必須配置，不然啟動會報錯。 ``` 127.0.0.1 jeecg-boot-redis 127.0.0.1 jeecg-boot-mysql 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-sentinel 127.0.0.1 jeecg-boot-xxljob 127.0.0.1 jeecg-boot-rabbitmq ``` ## 二、勾選中Maven Profile `dev和SpringCloud` ![](https://img.kancloud.cn/6c/ac/6cacc5934bec336f10f95c27f969c298_382x326.png =250x200) 切換成功效果 >[warning] 注意：`dev`和`SpringCloud` 需要同時勾選，不然會出錯。 ![](https://img.kancloud.cn/ea/df/eadfde53252089c73268555f54053951_484x792.png =400x650) ## 三、創建微服務所需數據庫手工執行jeecgboot提供的 [初始化SQL](https://gitee.com/jeecg/tree/master/jeecg-boot/db)，創建`jeecg-boot`、`nacos`、`xxl_job` 三個庫。 ![](https://img.kancloud.cn/6e/37/6e37fee6ce9187a0f163336fe044d8b0_597x216.png ) >[warning] **重要提示：** nacos庫默認加入jeecg所需要配置。 > 如果用自己的nacos，請[ 手工加 jeecg.yaml、jeecg-dev.yaml、jeecg-gateway-dev.yaml等配置](https://gitee.com/jeecg/jeecg-boot/tree/master/jeecg-cloud-module/jeecg-cloud-nacos/docs/config) ## 四、啟動微服務項目 ### 4.1 啟動`nacos` 找到下面的啟動類，右鍵執行 ``` 項目：jeecg-cloud-module\jeecg-cloud-nacos 啟動類：com.alibaba.nacos.JeecgNacosApplication ``` 訪問：http://localhost:8848/nacos 賬號密碼：nacos/nacos ![](https://img.kancloud.cn/ef/e3/efe315b8d0150fdc81f11fe6a1a10370_1635x382.png) ### 4.2 啟動`jeecg-demo`服務找到下面的啟動類打開注釋，右鍵啟動 ``` 項目：jeecg-cloud-module/jeecg-demo-cloud-start 啟動類：org.jeecg.JeecgDemoCloudApplication ``` ### 4.3 啟動`jeecg-system`服務 1 找到下面的啟動類，右鍵啟動 ``` 項目：jeecg-cloud-module/jeecg-system-cloud-start 啟動類：org.jeecg.JeecgSystemCloudApplication ``` 2 單體啟動類可以刪掉或者注釋掉 ``` jeecg-boot-module-system/src/main/java/org/jeecg/JeecgSystemApplication.java ``` ### 4.4 啟動網關`gateway` - 找到下面的啟動類，右鍵啟動 ``` 項目：jeecg-cloud-module\jeecg-cloud-gateway 啟動類：org.jeecg.JeecgGatewayApplication ``` - 所有服務啟動效果 ![](https://img.kancloud.cn/68/69/686907ded39caffdb00d988d9f116dc8_331x198.png =320x200) - 訪問gateway看接口文檔 http://localhost:9999 ![](https://img.kancloud.cn/3d/de/3dde7e22ee00ce42a6c83231b448ada5_1283x692.png =700x550) ### 4.5 啟動更多服務模塊 >[info] 跟上面類同，這里不做詳細介紹了。 Xxljob服務端 ~~~ 項目：jeecg-cloud-module\jeecg-cloud-xxljob 啟動類：src\main\java\com\xxl\job\admin\XxlJobAdminApplication.java - 訪問：http://localhost:9080/xxl-job-admin - 賬號：admin/123456 ~~~ ![](https://img.kancloud.cn/c1/8a/c18afc571fc7e199013316bf4edab9c3_936x573.png =830x450) Sentinel服務端 ~~~ 項目： jeecg-cloud-module\jeecg-cloud-sentinel 啟動類：src\main\java\com\alibaba\csp\sentinel\dashboard\JeecgSentinelApplication.java -訪問：http://localhost:9000 -賬號密碼：sentinel/sentinel ~~~ ![](https://img.kancloud.cn/1e/6e/1e6eb07dd91d4d80d66680df46e07ee7_925x498.png =830x450) SpringBoot Admin服務監控 ~~~ 項目：jeecg-cloud-module\jeecg-cloud-monitor 啟動類：src\main\java\org\jeecg\monitor\JeecgMonitorApplication.java - 訪問：http://localhost:9111/login - 賬號：admin/admin ~~~ ![](https://img.kancloud.cn/4f/ee/4fee78d065fcbb59ae0ffe4924123a0f_768x552.png =500x350) **特殊配置** * [ ] 默認是關閉了xxljob，需要啟動請修改`nacos`中`jeecg-dev.yaml`中的屬性 ![](https://img.kancloud.cn/67/5c/675c6cb172b938aa06f687d7cd6424da_207x66.png) * [ ] Sentinel已做了深度改造，支持持久化配置到nacos中 * [ ] 微服務做了很多示例，需要請打開`jeecg-cloud-system-start`項目`pom.xml`注釋 * [ ] 另外測試MQ需要 [安裝rabitmq服務](消息隊列集成2.3.2+.md)、測試seata也需要 [安裝服務端](分布式事務seata集成.md) * [ ] 更多微服務文檔： [Sentinel限流熔斷降級](Sentinel熔斷降級用法.md) | [ 分庫分表文檔](分開分表shardingsphere集成案例.md) | [分布式鎖](分布式鎖集成2.3.2+.md) | [消息總線](消息總線用法.md) **其他服務測試地址** | 軟件服務 | 測試地址 | 賬號密碼 | 是否必須 | | --- | --- | ---| ---| | nacos（服務注冊發現和統一配置中心） | http://localhost:8848/nacos | nacos/nacos | 是 | | rabitmq （消息中間件） | http://localhost:15672 | guest/guest | 否 | | xxl-job-admin（分布式定時任務）| http://localhost:9080/xxl-job-admin | admin/123456 | 否 | | sentinel （Sentinel監控）| http://localhost:9000 |sentinel/sentinel | 否 | ## 五-1、Vue2前端對接 (ant-design-vue-jeecg) 修改.env.development，配置接口地址為gateway地址。 ``` VUE_APP_API_BASE_URL=http://localhost:9999 ``` 啟動訪問： http://localhost:3000 ## 五-2、Vue3前端對接 (jeecgboot-vue3) 修改.env.development，配置接口地址為gateway地址。 ``` VITE_PROXY = [["/jeecgboot","http://localhost:9999"],["/upload","http://localhost:3300/upload"]] VITE_GLOB_DOMAIN_URL=http://localhost:9999 ``` 啟動訪問： http://localhost:3100 ## 六、深入高級功能 ### 6.1. 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 =600x400) 3、啟動system，rabbitmq隊列和交換機會自動生成詳細文檔見[ rabitmq消息隊列集成2.4+](http://doc.jeecg.com/2043897) ### 6.2. xxljob服務啟動 1. 手工執行腳本[ jeecg-cloud-xxljob/doc/db/tables_xxl_job.sql](https://github.com/zhangdaiscott/jeecg-boot/blob/master/jeecg-boot/jeecg-cloud-module/jeecg-cloud-xxljob/doc/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)