Ocelot一个优秀的.NET API网关框架
2021-01-14 20:28:56 Author: www.freebuf.com(查看原文) 阅读量:90 收藏

1 什么是Ocelot?

Ocelot是一个用.NET Core实现并且开源的API网关,它功能强大,包括了:路由、请求聚合、服务发现、认证、鉴权、限流熔断、并内置了负载均衡器与Service Fabric、Butterfly Tracing集成。

2 如何使用Ocelot?

首先,创建2个WebApi项目,WebApi01和WebApi02,地址分别https://localhost:44313和https://localhost:44390,其中WebApi01当作网关,WebApi02当作具体的微服务Api。

dotnet addpackage AutoMapperdotnet addpackage AutoMapper.Extensions.Microsoft.DependencyInjection

然后,将Ocelot的NuGet软件包安装到WebApi01项目中。

Ocelot

注意我这里安装的是17.0.0版本,配置方面会有点不一样。

接着,在Startup.ConfigureServices中增加services.AddOcelot;

publicvoidConfigureServices(IServiceCollection services){
    services.AddControllers();
    services.AddSwaggerGen(c =>{
        c.SwaggerDoc("v1", newOpenApiInfo { Title = "Autofac.WebApi", Version = "v1"});
    });

    services.AddOcelot();
}

接着,在Startup.Configure中增加app.UseOcelot().Wait();

publicvoidConfigure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if(env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseSwagger();
        app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "Ocelot.WebApi01 v1"));
    }

    app.UseHttpsRedirection();

    app.UseRouting();

    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });

    app.UseOcelot().Wait();
}

接着,创建ocelot.json文件

{
  "Routes": [ //路由配置(注16.1版本将ReRoutes换成Routes){
      "DownstreamPathTemplate": "/{url}", // 下游(服务提供方)服务路由模板"DownstreamScheme": "https", // 下游Uri方案,http、https"DownstreamHostAndPorts": [ // 服务地址和端口,如果是集群就设置多个{
          "Host": "localhost",
          "Port": 44390}
      ],
      "UpstreamPathTemplate": "/api/{url}", // 上游(客户端,服务消费方)请求路由模板"UpstreamHttpMethod": [ "GET"] // 允许的上游HTTP请求方法,可以写多个}
  ],
  "GlobalConfiguration": { //全局配置"BaseUrl": "https://localhost:44313"//网关对外地址}
}

最后,在Program.CreateHostBuilder中增加AddJsonFile("ocelot.json", optional: false, reloadOnChange: true);

publicstaticIHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((hostingContext, builder) =>{
            builder.AddJsonFile("ocelot.json", optional: false, reloadOnChange: true);
        })
        .ConfigureWebHostDefaults(webBuilder =>{
            webBuilder.UseStartup<Startup>();
        });

Ok,让我们来测试看看,https://localhost:44313/api/WeatherForecast会不会跳转https://localhost:44390/WeatherForecast。


文章来源: https://www.freebuf.com/articles/web/260901.html
如有侵权请联系:admin#unsafe.sh