JeeSite Spring Cloud安裝搭建

叫我小鍋鍋發表於2021-12-19

引言

JeeSite Cloud 具備 JeeSite 4.x 的所有功能，是在 JeeSite 4.x 基礎之上，完成的 Spring Cloud 分散式系統套件的整合。它利用 JeeSite 4.x 的開發便利性巧妙地簡化了分散式系統開發。

JeeSite Cloud 並沒有重複製造輪子，它只是將目前比較成熟的、經得起實際考驗的服務框架組合起來，通過 Spring Boot 風格進行再封裝遮蔽掉了複雜的配置和實現原理，最終給開發者留出了一套簡單易懂、易部署和易維護的分散式系統開發工具包。

整合阿里優秀元件 Nacos 服務治理與配置中心、整合 Sentinel 流量衛兵；整合 Zipkin 鏈路追蹤；整合 LCN 分散式事務等，詳見技術選型章節。

特點：用經典開發模式，開發分散式應用，兩個字【簡單】，一個字【快】。

原始碼倉庫地址：https://gitee.com/thinkgem/jeesite4-cloud

優勢（只寫別人沒有的）

在 JeeSite 單應用基礎之上，完成的 Cloud 功能，使用經典開發模式，就像開發單應用一樣開發分散式應用
它提供了微服務模組的程式碼生成工具，快速生成開發微服務功能，包含微服務的釋出和呼叫介面
我們將 api 和 client 合體為一個工程，自動適應自己呼叫自己 client 的影響，簡化工程數量
解決 Feign 介面不能多重繼承問題，如一些通用操作（增刪改查）微服務介面基類實現，這些都不用自己寫了
統一的授權認證、基礎資料微服務，都已經提供查詢 client 介面，其他微服務應用模組中可直接獲取使用者、組織、許可權、字典等基礎資料。微服務之間呼叫中，出現的會話及快取的一致性統一得到解決。
如 UserUtils、EmpUtils、EmpUserService、OfficeService 等等眾多的基礎服務工具類，都可以直接從基礎資料的微服務中獲取資料，你不必考慮跨 web 服務的資料互動，我們已經幫你做了。
微服務元件 Nacos、Sentinel、Zipkin 提供原始碼方式啟動部署，方便開發除錯。
寫一個別人有的，使用柔性事務解決，跨 web 服務的情況，入侵性非常小哦。
整合工作流，提供BPM引擎獨立的服務，客戶端只需呼叫API，無需載入複雜流程引擎。
其它優勢（按 Ctrl + Shift 點選連結）：http://jeesite.com/docs/feature/

技術選型

分散式系統套件版本：Spring Cloud 2020.0.4 + Alibaba 2021.1
服務治理註冊與發現：Spring Cloud Eureka / Consul / Nacos 2.0
分散式統一配置中心：Spring Cloud Config / Nacos 2.0
閘道器路由代理呼叫：Spring Cloud Gateway (動態閘道器)
宣告式服務呼叫：Spring Cloud OpenFeign
客戶端負載均衡：Spring Cloud LoadBalancer
阿里流量防衛兵：Sentinel 1.8 (限流、熔斷降級、負載保護)
分散式事務框架：Seata 1.4 / TX-LCN 5.0 (可選元件)
分散式鏈路追蹤：Zipkin 2.23 (可選元件)
工作流引擎框架：Flowable 6.6 (可選元件)

子專案介紹

服務註冊：jeesite-cloud-eureka ： http://127.0.0.1:8970
配置中心：jeesite-cloud-config ： http://127.0.0.1:8971/project/default
服務註冊和配置中心 Nacos 版本（推薦）：http://127.0.0.1:8848/nacos/index.html
閘道器路由：jeesite-cloud-gateway ： http://127.0.0.1:8980/js/a/login
核心模組（統一授權認證服務、平臺基礎資料服務）：
- 核心主專案：jeesite-cloud-module-core ： http://127.0.0.1:8981/js
- 客戶端專案（提供其它模組呼叫）：jeesite-cloud-module-core-client
測試模組1（單表增刪改查示例）：
- 模組1主專案：jeesite-cloud-module-test1 ： http://127.0.0.1:8982/js
- 模組1客戶端專案（提供其它模組呼叫）：jeesite-cloud-module-test1-client
測試模組2（樹表增刪改查示例）：
- 模組2主專案：jeesite-cloud-module-test2 ： http://127.0.0.1:8983/js
- 模組2客戶端專案（提供其它模組呼叫）：jeesite-cloud-module-test2-client
測試模組3（程式碼生成的模組和程式碼生成的增刪改查，該模組完全沒有手寫，全部為生成的）：
- 模組3主專案：jeesite-cloud-module-test3 ： http://127.0.0.1:8985/js
- 模組3客戶端專案（提供其它模組呼叫）：jeesite-cloud-module-test3-client
業務流程基礎服務（流程引擎服務，客戶端只需呼叫介面，無需載入引擎邏輯）：
- 流程主專案：jeesite-cloud-module-bpm ： http://127.0.0.1:8990
- 客戶端專案（提供其它模組呼叫）：jeesite-cloud-module-bpm-client
分散式事務 Seata 服務（推薦）：
- 服務主專案：jeesite-cloud-module-seata ： http://127.0.0.1:8091
- 客戶端專案（提供其它模組呼叫）：jeesite-cloud-module-seata-client
分散式事務 LCN 服務：
- 服務主專案：jeesite-cloud-module-txlcn ： http://127.0.0.1:7970
- 客戶端專案（提供其它模組呼叫）：jeesite-cloud-module-txlcn-client
熔斷限流：jeesite-cloud-sentinel ： http://127.0.0.1:9311
鏈路追蹤：jeesite-cloud-zipkin ： http://127.0.0.1:9411
解釋：主專案為服務提供者、客戶端專案為服務消費者

快速執行

初始化資料庫

JeeSite Cloud 版本的資料庫與 JeeSite 單機版資料庫相同，你可以下載最新的mysql指令碼或者使用 init-data.bat(sh) 命令完成初始化（支援多種資料庫）。

安裝 Redis

Redis 是一個快取資料庫，主要用來集中式管理共享會話和系統快取的，如果你已安裝 Redis，可以忽略這個步驟。

由於 Windows 版本的 Redis 安裝不太方便，所以我們提供了該版本的安裝檔案和安裝指令碼。

下載地址：https://gitee.com/thinkgem/jeesite4-cloud/attach_files 找到 Redis-x64-4.0.2.2.zip 下載檔案。

解壓 Redis-x64-4.0.2.2.zip 壓縮包，執行 service-install.bat 安裝 Windows 系統服務。

預設地址：127.0.0.1；預設埠：6379；預設密碼：1234，可根據自己需要修改 conf 檔案。

啟動 Nacos 服務

Nacos 致力於幫助您發現、配置和管理微服務。 Nacos 提供了一組簡單易用的特性集，幫助您快速實現動態服務發現、服務配置、服務後設資料及流量管理。 Nacos 幫助您更敏捷和容易地構建、交付和管理微服務平臺。 Nacos 是構建以“服務”為中心的現代應用架構 (例如微服務正規化、雲原生正規化) 的服務基礎設施。

如果使用 Nacos 就不用部署 jeesite-cloud-eureka 和 jeesite-cloud-config 了。

JeeSite Cloud 提供了 2 種部署方式，你可以下載 jar 也可以 src 方式執行：

jar 方式：

下載地址：https://github.com/alibaba/nacos/releases/download/2.0.3/nacos-server-2.0.3.zip
解壓 nacos-server-2.0.3.zip 壓縮包，執行 /bin/startup.cmd(sh) 啟動服務。

src 方式：

在 Eclipse 或 IDEA 中找到 jeesite-cloud-nacos 專案。
執行 NacosApplication 類的 main 方法，即可啟動服務。

配置 mysql 儲存：

預設情況 Nacos 採用 Derby 資料庫，你可以將資料庫切換到 MySQL 下。
找到 /nacos/src/main/resources/config/nacos-mysql.sql 檔案匯入資料表。
找到 Nacos 的配置檔案（application.properties 或 application.yml）如下：

spring.datasource.platform: mysql

### Count of DB:
db.num: 1

### Connect URL of DB:
db.url.0: jdbc:mysql://127.0.0.1:3306/nacos?useSSL=false&characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&serverTimezone=UTC
db.user: root
db.password: 123456

# 如果是 application.properties 檔案，將 key 後的冒號換為等號即可。

啟動完成後：

瀏覽器訪問：http://127.0.0.1:8848/nacos/index.html 使用者名稱密碼：nacos

登入後，進入選單 配置管理 -> 配置列表 點選 匯入配置 按鈕，選擇 /config/src/main/resources/jeesite-cloud-43.zip上傳檔案。

然後編輯 Data Id 為 application.yml 的檔案裡的 JDBC 和 Redis 資訊。

啟動 Sentinel 服務

隨著微服務的流行，服務和服務之間的穩定性變得越來越重要。 Sentinel 是面向分散式服務架構的流量控制元件，主要以流量為切入點，從流量控制、熔斷降級、系統自適應保護等多個維度來幫助您保障微服務的穩定性。

在 Eclipse 或 IDEA 中找到 jeesite-cloud-sentinel 專案。
執行 SentinelApplication 類的 main 方法，即可啟動服務。

瀏覽器訪問：http://127.0.0.1:9311 使用者名稱密碼：sentinel

啟動 Zipkin 服務

Zipkin 是一個開放原始碼分散式的跟蹤系統，每個服務向 Zipkin 報告計時資料，Zipkin會根據呼叫關係通過 Zipkin UI 生成依賴關係圖。

在 Eclipse 或 IDEA 中找到 jeesite-cloud-zipkin 專案。
執行 ZipkinApplication 類的 main 方法，即可啟動服務。

瀏覽器訪問：http://127.0.0.1:9411

啟動微服務專案

在每個微服務中可以找的 config/bootstrap.yml 配置服務註冊和配置中心地址。
按順序執行以下啟動類的main方法：（因為服務直接有依賴，請啟動完成一個再啟下一個）
- /jeesite-cloud-gateway/../GatewayApplication.java
- /jeesite-cloud-module-core/../CoreApplication.java
- /jeesite-cloud-module-test1/../Test1Application.java
- /jeesite-cloud-module-test2/../Test2Application.java
以上都啟動成功後，瀏覽器訪問閘道器專案地址即可：
- 訪問地址：http://127.0.0.1:8980/js 使用者名稱密碼： system admin
- 若訪問報錯，請再等待一會，可能服務未完全啟動完成

呼叫例項演示

閘道器代理模組呼叫

代理 test1 模組（單表）：http://127.0.0.1:8980/js/a/test1/testData/list
- 控制器位置：/jeesite-cloud-module-test1/../web/TestData1Controller.java
代理 test2 模組（樹表）：http://127.0.0.1:8980/js/a/test2/testTree/list
- 控制器位置：/jeesite-cloud-module-test2/../web/TestTree2Controller.java

模組之間互相呼叫

test2 模組呼叫 test1 模組（單表）：http://127.0.0.1:8980/js/a/test2/testData/list
- 服務消費者位置：/jeesite-cloud-module-test2/../web/TestData2Controller.java
- 服務提供者位置：/jeesite-cloud-module-test1/../service/TestDataService.java
test1 模組呼叫 test2 模組（樹表）：http://127.0.0.1:8980/js/a/test1/testTree/list
- 服務消費者位置：/jeesite-cloud-module-test1/../web/TestTree1Controller.java
- 服務提供者位置：/jeesite-cloud-module-test2/../service/TestTreeService.java

新增微服務工程

1、新建模組

1）進入選單：系統管理 -> 系統設定 -> 模組管理，新建一個模組，填寫：

模組名稱：測試模組
模組編碼：test3
生成基礎路徑：填寫新建模組的根目錄
程式碼生成模板：生成微服務模組程式碼（Cloud）

點選 “儲存並生成程式碼” 按鈕，即可完成微服務模組的工程程式碼新建。

2）新建微服務功能，進入程式碼生成器功能選單，生成時選擇 Cloud 的程式碼生成模板即可。

v4.2.2之前版本：

由於之前版本沒有微服務模組生成器功能，所以需要參考其它模組。舉例新增一個微服務模組模組叫 test3，該模組的所有對映地址均在 ${adminPath}/test3/** 這個路徑下，該模組可以參照 test1 進行，步驟如下：

拷貝 jeesite-cloud-module-test1 專案為 jeesite-cloud-module-test3 資料夾：

1）修改 pom.xml 中的應用名：

<artifactId>jeesite-cloud-module-test1</artifactId>
替換為：
<artifactId>jeesite-cloud-module-test3</artifactId>

<artifactId>jeesite-cloud-module-test1-client</artifactId>
替換為：
<artifactId>jeesite-cloud-module-test3-client</artifactId>

2）修改 application.yml 中的應用名：

spring:
  application:
    name: jeesite-cloud-module-test3

3）修改 *Client.java 裡的應用名：

service.test1 替換為 service.test3

4）修改 *Controller.java 裡的對映路徑：

${adminPath}/test1 替換為 ${adminPath}/test3

2、配置服務引數

在 jeesite-config 或 Nacos 的微服務配置檔案 application.yml 中，新增微服務：

# 微服務列表
service:
  test3:
    name: jeesite-cloud-module-test3
    path: ${server.servlet.context-path}

3、配置閘道器對映

在 jeesite-cloud-gateway 配置檔案中新增閘道器路由

spring:
  cloud:
    gateway:
      routes:
        # 測試模組3
        - id: test3
          uri: lb://jeesite-cloud-module-test3/js/a/test3
          predicates:
            - Path=/js/a/test3/**
        # 測試模組3（系統監控）
        - id: test3_def
          uri: lb://jeesite-cloud-module-test3/js/a/jeesite-cloud-module-test3
          predicates:
            - Path=/js/a/jeesite-cloud-module-test3/**

注意：新增的配置請放到 core 基礎許可權模組之上。

微服務增刪改查

進入 “程式碼生成器” 選單，同單機版使用方法，只需在生成程式碼時，選擇 Cloud 版本的生成模板即可。

授權協議宣告

您可以免費使用、修改和衍生程式碼，但不允許修改後和衍生的程式碼做為閉源軟體釋出。
修改後和衍生的程式碼必須也按照當前協議進行流通，對修改後和衍生的程式碼必須向社會公開。
如果您修改了程式碼，需要在被修改的檔案中進行說明，並遵守程式碼格式規範，幫助他人更好的理解您的用意。
在延伸的程式碼中（修改和有原始碼衍生的程式碼中）需要帶有原來程式碼中的協議、版權宣告和其他原作者規定需要包含的說明（請尊重原作者的著作權，不要刪除或修改檔案中的@author資訊）。
本專案僅用於學習和交流，未得到官方授權不得用於商業用途。

獲得技術服務支援：http://s.jeesite.com

我們深知，沒有資金的支撐就很難得到發展，特別是一個好的產品，如果 JeeSite 幫助了您，請為我們點贊。支援我們，您可以得到一些回報，有了這些我們會把開源事業做的更好，回報社群和社會，請給我們一些動力吧，在此非常感謝已支援我們的朋友！

技術交流方式

QQ 群號：127515876、209330483、223507718、709534275、730390092、1373527、183903863(外包)
問題反饋：https://gitee.com/thinkgem/jeesite4-cloud/issues 　【新手必讀】
碼雲Gitee：https://gitee.com/thinkgem/jeesite4-cloud
GitHub：https://github.com/thinkgem/jeesite4-cloud
作者部落格：https://my.oschina.net/thinkgem
官方網站：http://jeesite.com
官方論壇：http://jeesite.net
微信公眾號：

JeeSite4微信公眾號

Git 全域性設定技巧

1、提交檢出均不轉換換行符

git config --global core.autocrlf false

2、拒絕提交包含混合換行符的檔案

git config --global core.safecrlf true

spring cloud 服務搭建（1）
2018-10-22
SpringCloud
13 Spring Cloud Alibaba簡介和Nacos安裝
2020-12-28
SpringCloud
jeesite檔案結構與jeesite.properties
2017-07-06
Spring Cloud微服務（一）：公共模組的搭建
2020-06-07
SpringCloud微服務
Spring Cloud簡介和服務中心的搭建
2019-05-07
SpringCloud
基於Spring Cloud搭建分散式配置中心
2018-07-20
SpringCloud分散式
Spring Cloud 搭建基礎綜合框架【實操】
2020-11-08
SpringCloud框架
spring cloud 信用盤程式搭建環境配置
2022-03-31
SpringCloud
安裝 Google Cloud CLI（gcloud）
2024-05-03
GoCloudGC
Spring Cloud Seata 系列：Seata-Server （1.7.1）安裝與配置（整合 Nacos）
2023-11-12
SpringCloudServer
【夯實Spring Cloud】Spring Cloud中基於maven的分散式專案框架的搭建
2018-10-31
SpringCloudMaven分散式框架
jeeSite分頁
2017-07-26
整合spring cloud雲架構 --註冊中心搭建
2019-03-19
SpringCloud架構
Alibaba cloud 3 安裝docker
2021-08-28
CloudDocker
Spring Cloud Security OAuth2.0入門: AuthorizationServer搭建（一）
2019-06-06
SpringCloudOAuthServer
Spring Cloud（二）：Spring Cloud Config
2021-09-09
SpringCloud
Spring Boot 安裝
2017-11-17
Spring Boot
Spring cloud
2018-01-12
SpringCloud
服務治理->搭建服務註冊中心： Spring Cloud Eur
2021-09-09
SpringCloud
Spring Cloud雲架構 - commonservice-sso服務搭建
2018-09-10
SpringCloud架構
jeesite專案筆記
2017-12-24
筆記
Cloud Control 13c 安裝
2019-05-02
Cloud
使用 Recipe 安裝 SAP Commerce Cloud
2021-12-13
Cloud
SAP Commerce Cloud SmartEdit 的安裝
2022-02-21
Cloud
安裝Cloud Control 12c
2018-04-02
Cloud
zabbix環境安裝搭建
2017-11-14
spring安裝使用教程
2017-09-14
Spring
Spring Cloud 關於：Spring Cloud Netflix Hystrix
2019-09-02
SpringCloud
spring cloud 和阿里微服務spring cloud Alibaba
2021-10-25
SpringCloud阿里微服務
Spring Cloud介紹 Spring Cloud與Dubbo對比
2016-12-14
SpringCloud
瘋狂Spring Cloud連載（1）Spring Cloud概述
2017-10-31
SpringCloud
微服務Spring Cloud17_Spring Cloud概述3
2024-04-17
微服務SpringCloud
Spring Cloud Eureka 註冊中心叢集搭建，Greenwich 最新版！
2019-04-03
SpringCloud
Spring Cloud雲架構 - commonservice-sso服務搭建（一）
2019-03-19
SpringCloud架構
Spring Cloud Alibaba(10)---Sentinel控制檯搭建+整合SpringCloudAlibaba
2021-05-16
SpringCloudGC
Docker composer搭建Spring Cloud Alibaba 執行環境（二）
2020-10-29
DockerSpringCloud
微服務整合Spring Cloud Alibaba Seata（一）Seata服務搭建
2024-04-01
微服務SpringCloud
Spring Cloud 整合
2023-11-26
SpringCloud