首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >高性能微服务网关.NETCore客户端Kong.Net开源发布

高性能微服务网关.NETCore客户端Kong.Net开源发布

作者头像
梁规晓
发布2019-07-08 19:45:38
1.2K0
发布2019-07-08 19:45:38
举报
文章被收录于专栏:DotNet程序园DotNet程序园

前言

项目地址:https://github.com/lianggx/Kong.Net

你的支持使我们更加强大,请单击 star 让更多的 .NETCore 认识它。

拥抱开源的脚步,我们从来都是一直在路上;.NETCore作为后起之秀,带给我们太多的惊喜和感动;但是也正是由于年轻,.NETCore 的生态还是不够完善,这就非常需要我们社区的力量,需要大家一起参与,把开源社区好的工具、组件、应用接入到 .NETCore 应用中。

他山之石,可以攻玉!

在很多时候,我们想要在项目中引入高性能开源网关 Kong 的时候,苦于没有 .NETCore 客户端而放弃,Nuget 仓库曾经有一个 .NETFramework 版本的客户端,但是已经年久失修了,可见开源项目的维护极其不易。

Kong 是什么?

Github 地址:https://github.com/Kong/kong

Kong 的 Logo 是金刚,是一个支持云原生应用的高性能网关,于 2015 年开源,其核心价值在于高性能和可扩展性,Kong 的贡献值高达 151 人,目前为止共有 5073 次代码提交记录,976 个关注,22353 个 star 和 2736 个fork;Kong 的有点非常多,特别是其基于 lua 编写,性能卓越,且具有平台无关性,还有丰富的第三方插件,以及用户体验良好的的仪表盘操作界面(Konga另一个开源作品),可以说,Kong 具备了一个优秀网关的所必须的所有能力,支持 docker 部署,使用 postgresql 进行数据持久化,高可扩展性,可轻松升级为服务网格方案,REST API 访问,非常灵活的接入控制方式。

技术选型

Consul

我是由于在最近的技术选型中了解到 Kong 的,在此之前,我曾经考虑过 Nginx+Consul 方案(详情见我的博客),对 Consul 也进行了深入的了解和测试,但是由于 Consul 始终只是一个服务发现的组件,不具备网关能力,且维护复杂(脚本维护),虽然在 .NETCore 下接入非常的方便,但是还是只能放弃了。

Spring-cloud

也考察了 Spring-cloud Gateway,Spring 大法好,特别是阿里的 Nacos 的支持和跟进,使得 Spring 占据了80%的江山(不知道我是否高估了),而且搭建 Spring Gateway 的步骤非常简单,一个小白,只要花2天时间,就能快速的搭建出一个 Spring-cloud Gateway,Java 的生态真的是让人垂涎欲滴,没办法,惯性太大了。同时,由于 Spring-cloud Gateway 的 .NetCore 客户端不提供(废话来的,人家是玩 Java 的),所以从成本上考虑,也得放弃。

kong

终于还是选择了 Kong,Kong 的平台无关性和设计良好的 REST API ,让我们有机会快速的接入到这款高性能的网关中,我个人开发 Kong.Net 这款客户端,用时 3 天,REST API 共有 81 个 API,支持Kong:latest最新版本为1.2.x。

Kong.Net

项目结构

项目结构比较简单,就是一个标准的开源框架的样子,包含了 examples、src、test 三大块的内容,其中 src 包含两个项目 Kong/Kong.Extensions,单元测试一共有 80 个,已全部测试通过。

使用 Kong.Net

在 .NETCore 项目中使用 Kont.Net 非常简单,只需要在项目中进行 Nuget 包的引用即可,截止本文发文时,版本号为 Kong.Net-0.0.4。为了更方便的使用 Kong.Net ,建议同时引用 Kong.Extension-0.0.4 包,扩展包封装了一些初始化配置信息,比如健康检查路径和响应,非常方便。

完全基于 .NetCore ,目前依赖 Json.Net

在配置文件中加入以下配置,以初始化客户端

"kong": {    "host": "http://10.23.11.1:8001",    "upstream": {      "tags": [ "example", "low-priority" ],      "name": "Kong.Example",      "hash_on": "none",      "healthchecks": {        "active": {          "unhealthy": {            "http_statuses": [ 429, 500, 501, 502, 503, 504, 505 ],            "tcp_failures": 1,            "timeouts": 1,            "http_failures": 1,            "interval": 5          },          "type": "http",          "http_path": "/kong/healthchecks",          "timeout": 1,          "healthy": {            "successes": 1,            "interval": 5,            "http_statuses": [ 200, 302 ]          },          "https_verify_certificate": true,          "concurrency": 1        },        "passive": {          "unhealthy": {            "http_statuses": [ 429, 500, 501, 502, 503, 504, 505 ]          },          "healthy": {            "http_statuses": [ 200, 302 ]          },          "type": "http"        }      },      "hash_on_cookie_path": "/",      "hash_fallback": "none",      "slots": 10000    },    "target": {      "tags": [ "example", "low-priority" ],      "target": "192.168.1.10:5200",      "weight": 100    }  }

*注意:配置节点 kong.target.target 这个值就是要注册到 Kong 网关的地址,如果配置了,这个过程是自动的,否则需要手动指定客户端地址 上面的配置,和 Kong 内部的 UpStream 完全一致,在Kong 中怎么配置 UpStream ,在 Kong.Net 中就怎么配置,字段名称和类型完全平移。

修改 startup.cs 服务注入和配置

public void ConfigureServices(IServiceCollection services){    services.AddSingleton<KongClient>(fat =>    {        var options = new KongClientOptions(HttpClientFactory.Create(), this.Configuration["kong:host"]);        var client = new KongClient(options);        return client;    });    ...}public void Configure(IApplicationBuilder app, IHostingEnvironment env, KongClient kongClient){    app.UseKong(Configuration, kongClient);    ...}

到这里就配置完成,可以启动了。

自定义启动

如果需要在系统启动的时候动态的传入服务地址,参考下面的代码

修改Program.cs为外部参数启动

 public static IWebHostBuilder CreateWebHostBuilder(string[] args) {     var config = new ConfigurationBuilder().AddCommandLine(args).Build();     var url = config["server.urls"];
     return WebHost.CreateDefaultBuilder(args)           .UseStartup<Startup>()           .UseUrls(url); }

获得命令行传入的参数配置 --server.urls

 // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. public void Configure(IApplicationBuilder app, IHostingEnvironment env, KongClient kongClient) {     UseKong(app, kongClient);    ... }
 public void UseKong(IApplicationBuilder app, KongClient kongClient) {     var upStream = Configuration.GetSection("kong:upstream").Get<UpStream>();     var target = Configuration.GetSection("kong:target").Get<TargetInfo>();     var uri = new Uri(Configuration["server.urls"]);     target.Target = uri.Authority;     app.UseKong(kongClient, upStream, target); }

到这里,就大功告成了

启动项目,完成服务自动注册、健康检查

输入命令

dotnet run --server.urls http://172.16.10.227:5200

上面绿色输出部分,表示服务注册成功,蓝色部分,表示 Kong 正在执行对 Kong.Net 客户端的检查,从运行情况来看,已经完美运行成功了。

健康检查

使用 Kong.Extensions 客户端扩展包,内部自动将健康检查地址设置为:/kong/healthchecks,然后在内部自动应答,其代码实现为:

private static IApplicationBuilder UseKongHealthChecks(this IApplicationBuilder app, UpStream upStream){    app.Map(upStream.HealthChecks.Active.Http_path, s =>    {        s.Run(async context =>        {            Console.ForegroundColor = ConsoleColor.Blue;            Console.WriteLine("Healthchecks at: {0}", DateTime.Now);            Console.ForegroundColor = ConsoleColor.Gray;            await context.Response.WriteAsync("ok");        });    });    return app;}

结束语

拥抱开源的脚步,我们从来都是一直在路上;.NETCore作为后起之秀,带给我们太多的惊喜和感动;但是也正是由于年轻,.NETCore 的生态还是不够完善,这就非常需要我们社区的力量,需要大家一起参与,把开源社区好的工具、组件、应用接入到 .NETCore 应用中。

项目地址:https://github.com/lianggx/Kong.Net 你的支持使我们更加强大,点击 star 让更多的 .NETCore 认识它,从而能在 .NETCore 的路上更快速的前行。

如果你非常喜欢这个项目,想成为该项目的贡献者,请及时联系博主,我希望有更多的朋友加入进来,毕竟一个人维护太难了。

本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2019-07-08,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 DotNet程序园 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
  • Kong 是什么?
    • 技术选型
      • Consul
      • Spring-cloud
      • kong
  • Kong.Net
    • 项目结构
      • 使用 Kong.Net
        • 在配置文件中加入以下配置,以初始化客户端
          • 修改 startup.cs 服务注入和配置
          • 自定义启动
            • 修改Program.cs为外部参数启动
              • 获得命令行传入的参数配置 --server.urls
                • 启动项目,完成服务自动注册、健康检查
                  • 健康检查
                  • 结束语
                  相关产品与服务
                  容器服务
                  腾讯云容器服务(Tencent Kubernetes Engine, TKE)基于原生 kubernetes 提供以容器为核心的、高度可扩展的高性能容器管理服务,覆盖 Serverless、边缘计算、分布式云等多种业务部署场景,业内首创单个集群兼容多种计算节点的容器资源管理模式。同时产品作为云原生 Finops 领先布道者,主导开源项目Crane,全面助力客户实现资源优化、成本控制。
                  领券
                  问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档