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\": \"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 发展越来越好。