.NET Core + Spring Cloud:API 閘道器
API閘道器是系統的唯一入口,呼叫任何服務的請求都需要經過閘道器層,最終才可能到達目標服務,既然是必經之路,那我們可以在閘道器層進行一些通用的操作,如:認證、鑑權、限流、智慧路由、快取、日誌、監控、超時、熔斷、重試等等,這樣既使整個框架條理清晰,也讓開發者更多注重功能的邏輯實現。
常見的 API 閘道器專案有: Kong 、 Tyk 、 Netflix zuul 、 Ocelot 等。在 Spring Cloud 中,Zuul 是其核心元件,下面將介紹 .NET Core 中通過 Zuul 來進行統一 API 呼叫。
搭建 Zuul Server
Eureka Server 的搭建請參考 .NET Core + Spring Cloud:服務註冊與發現
-
在 IntelliJ IDEA 中新建專案,選 Spring Initializr 完成專案建立
-
在 pom.xml 新增 zuul 和 eureka-client 的依賴,我們將會把 Zuul Server 註冊到 Eureka Server
<dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-netflix-zuul</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId> </dependency>
-
在啟動類上新增 EnableZuulProxy 註解
@EnableZuulProxy @SpringBootApplication public class EurekaServiceApplication { public static void main(String[] args) { SpringApplication.run(EurekaServiceApplication.class, args); } }
-
修改 application.yml 配置檔案( 叢集模式通過一個類似 gateway.xxx.com 的域名指向多個 Zuul Server 例項即可 )
spring: application: name: zuul-service server: port: 5555 eureka: instance: hostname: server1 # 超過這個時間沒收到心跳就剔除這個服務,這個配置一般為服務重新整理時間配置的三倍,預設90s lease-expiration-duration-in-seconds: 15 # 服務重新整理時間,預設30s lease-renewal-interval-in-seconds: 5 client: service-url: defaultZone: http://server1:8001/eureka/,http://server2:8002/eureka/,http://server3:8003/eureka/
-
啟動服務,訪問: http://server1:8001/(*請確保 Eureka Server 已啟動*),可以發現 Zuul Server 已在 5555 埠啟動
建立 .NET Core 服務
這裡直接基於文章 .NET Core + Spring Cloud:服務註冊與發現 中的測試專案,修改 .NET Core 客戶端服務的配置檔案 services:base-service:url
"services": { "base-service": { "url": "http://server1:5555/base-service/" // 原來 http://base-service/ } }
因為我們的 Zuul Server 是啟動在 server1 的 5555 埠,通過 Zuul 閘道器呼叫服務的路由規則是 http://server1:5555/ + {Application 小寫},而基礎服務的 Application名稱為 BASE-SERVICE,所以 url 設定為 http://server1:5555/base-service/
測試
訪問 base-service
通過閘道器的路由地址 http://server1:5555/base-service/ 訪問 api/values 介面,多次請求可測試負載均衡效果