Surging 自2017年6月16日開源以來，已收到不少公司的關註或者使用，其中既有以海克斯康超大型等外企的關註，也不乏深圳泓達康、重慶金翅膀等傳統行業的正式使用，自2019年年初，surging2.0 便已正式進入研發階段，也受到了surging 用戶的關註，本文將為您解讀2.0的新特性和新功能 ...
Surging 自2017年6月16日開源以來，已收到不少公司的關註或者使用，其中既有以海克斯康超大型等外企的關註，也不乏深圳泓達康、重慶金翅膀等傳統行業的正式使用，自2019年年初，surging2.0 便已正式進入研發階段，也受到了surging 用戶的關註，本文將為您解讀2.0的新特性和新功能。在開始之前先解答一下經常被提到的疑問
1.Surging 有沒有文檔、Demo、官網
因為需要完善Surging，暫時個人還沒有時間去寫文檔，準備官網，但是大家可以通過關註liuhll，因為他正在寫surging文檔和 基於surging 的案例，
liuhll 文檔：https://liuhll.github.io/hexo-blog-deploy/categories/%E5%BE%AE%E6%9C%8D%E5%8A%A1/
surging案例：https://github.com/liuhll/Surging.Sample
2. Surging 有沒有公司正在使用
因為Surging 是開源產品，無法統計哪家公司正在使用，所以我提交了《surging 誰在使用》的issues, 大家可以去查看issues來知曉哪家公司正在使用，也請使用了surging的公司留下你所在公司的聯繫方式，以便收集有意向在生產上使用surging的客戶，從而讓surging社區和donetcore生態變得更加繁榮。
3. 何時支持Stage組件
對於Surging現在有一套獨立的 surging 網關，而網關的設計違反了引擎組件化思想， 所以新的版本會基於KestrelHttpServer 組件擴展Stage，這樣就能以組件模塊化生成，以代替之前網關無法做到的緩存服務降級，複雜業務服務的聚合，文件服務的支持，大概8月底完工
4. 是否會支持灰度發佈
因為.net core 設計問題，暫時無法做到surging 灰度發佈， 已將問題提交給coreclr，現已得到解決，等到3.0發佈後，surging 也會開始支持灰度發佈。
基於 Zookeeper 和 Consul 多註冊中心集群支持
Surging 可以支持pull 和 push 兩種方式來更新服務路由，而這兩種方式是由consul 和zookeeper 來實現的，而pull 是利用心跳的方式，而 push 是利用Watch 的機制，而 同時 註冊中心可以支持向多個註冊中心註冊服務路由,以同步註冊服務。當基於pull 和watch更新的時候，可以通過隨機演算法來負載獲取最新的服務路由來更新本地路由，可以通過以下代碼配置多註冊中心
Consul (surgingSettings.json):
"Consul": { "ConnectionString": "${Register_Conn}|127.0.0.1:8500,127.0.0.1:9500", "SessionTimeout": "${Register_SessionTimeout}|50", "RoutePath": "${Register_RoutePath}", "ReloadOnChange": true, "EnableChildrenMonitor": false }
Zookeeper(surgingSettings.json)
Zookeeper:{
"ConnectionString": "${Zookeeper_ConnectionString}|127.0.0.1:2181, 127.0.0.1:2281",
"SessionTimeout": 50,
"ReloadOnChange": true
}
ApiGateway
"Register": { "Provider": "Consul", "Address": "${Register_Conn}|127.0.0.1:8500,127.0.0.1:9500" }
基於swagger 利用業務模塊生成API文檔
ASP.NET Core Web API 使用Swagger 可以生成線上幫助測試文檔，而surging 維護了一套 基於surging 的swagger 的引擎組件，以便支持業務模塊使用Swagger 生成線上幫助測試文檔。具體可以按照以下代碼進行配置：
"Swagger": {
"Info": {
"Version": "${SwaggerVersion}|V1", // "127.0.0.1:8500",
"Title": "${SwaggerTitle}|Surging Demo",
"Description": "${SwaggerDes}|surging demo",
"Contact": {
"Name": "API Support",
"Url": "https://github.com/dotnetcore/surging",
"Email": "[email protected]"
},
"License": {
"Name": "MIT",
"Url": "https://github.com/dotnetcore/surging/blob/master/LICENSE"
}
},
"Options": {
"IgnoreFullyQualified": true
}
}
而針對於業務模塊生產的測試文檔，我們可以通過設置AssemblyInfo.cs，具體代碼如下：
using System.Reflection;
[assembly: AssemblyTitle("CommonModule")]
[assembly: AssemblyDescription("業務模塊")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("fanly")]
[assembly: AssemblyProduct("surging Micro Service Framework")]
[assembly: AssemblyCopyright("Copyright © fanly All Rights Reserved.")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]
[assembly: AssemblyVersion("1.1.0.0")]
[assembly: AssemblyFileVersion("1.1.0.0")]
界面生成如下：
總結
希望大家研究下surging ，surging 會讓你對.NET CORE微服務有個全新的認識，也希望大家大力宣傳，讓surging 發展越來越好。
