.NET Core API网关Ocelot(十)【Websockets】

àì夳堔傛蜴生んèń 2021-06-26 16:06 688阅读 0赞

Ocelot额外支持代理`websockets`。这个功能在问题 212中被提出。

为了是Ocelot代理websocket，你需要做如下事情。

在你的`Configure`方法中，你要告知应用程序使用`WebSockets`。

Configure(app =>
    { 
        app.UseWebSockets();
        app.UseOcelot().Wait();
    })

然后在你的ocelot.json中添加如下代码，用于配置`WebSockets`代理一个`Route`。

{ 
         "DownstreamPathTemplate": "/ws",
         "UpstreamPathTemplate": "/",
         "DownstreamScheme": "ws",
         "DownstreamHostAndPorts": [
             { 
                 "Host": "localhost",
                 "Port": 5001
             }
         ],
     }

使用这个配置，Ocelot将匹配所有进入`/`的`Websocket`流量并将其代理到`localhost:5001/ws`。更清晰的解释一下就是，Ocelot将接收来自上游客户端的消息，并将它们代理到下游服务，从下游服务接收消息并将这些消息代理到上游客户端。

## SignalR ##

Ocelot支持代理`SignalR`。 在发行344中要求此功能。

为了使`Websocket`代理与`Ocelot`一起使用，您需要执行以下操作。

安装`Microsoft.AspNetCore.SignalR.Client 1.0.2`，您可以尝试其他软件包，但此软件包已经过测试。

不要在`IISExpress`中运行它，也不要在`IIS`功能中安装`websockets`功能

在您的`Configure`方法中，您需要告诉您的应用程序使用`SignalR`。

Configure(app =>
    { 
        app.UseWebSockets();
        app.UseOcelot().Wait();
    })

然后在您的`ocelot.json`中添加以下内容以使用`SignalR`代理`Route`。 请注意，通常的`Ocelot`路由规则适用的主要是设置为“ws”的方案。

{ 
     "ReRoutes": [
       { 
         "DownstreamPathTemplate": "/{catchAll}",
         "DownstreamScheme": "ws",
         "DownstreamHostAndPorts": [
           { 
             "Host": "localhost",
             "Port": 50000
           }
         ],
         "UpstreamPathTemplate": "/gateway/{catchAll}",
         "UpstreamHttpMethod": [ "GET", "POST", "PUT", "DELETE", "OPTIONS" ]
       }
    ]
    }

使用此配置集，Ocelot将匹配`/`上出现的任何`SignalR`通信并将其代理到`localhost:5001/ws`。 为了更加清楚，Ocelot将接收来自上游客户端的消息，将它们代理到下游服务，接收来自下游服务的消息，并将它们代理给上游客户端。

## 已支持的 ##

1.  负载均衡
2.  路由
3.  服务发现

这意味着您可以运行`websockets`的下游服务，并在您的`Route`配置中使用多个`DownstreamHostAndPorts`，或将您的`Route`挂接到服务发现提供程序上，然后负载均衡上游请求…我认为这很酷:)

## 不支持的 ##

不幸的是，很多Ocelot的功能都是非`websocket`所特有的，比如`header`和`http`客户端填充。 我列出了以下不适用的功能。

1.  跟踪
2.  请求Id
3.  请求聚合
4.  流量限制
5.  服务质量
6.  中间件注入
7.  转换Header
8.  委托处理程序
9.  转换声明
10. 缓存
11. 认证 - 如果有人请求它，我们可能可以使用基本身份验证做些事情
12. 授权

我不是100％确定这个功能在进入高速运转时会发生什么，所以请确保您彻底测试过！