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/

<https://liuhll.github.io/hexo-blog-deploy/categories/%E5%BE%AE%E6%9C%8D%E5%8A%A1/>

surging案例:https://github.com/liuhll/Surging.Sample
<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": "fanliang1@hotmail.com" },
"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 发展越来越好。