Azure SignalR 服务中的复原能力和灾难恢复

通过配置

你应该已经知道如何通过环境变量/应用设置/web.cofig 在名为 Azure:SignalR:ConnectionString 的配置项中设置 SignalR 服务连接字符串。 如果有多个终结点，可在多个配置项中设置这些终结点，每个项采用以下格式：

Azure:SignalR:ConnectionString:<name>:<role>

在 ConnectionString 中，<name> 是终结点的名称，<role> 是其角色（主要或辅助角色）。 名称是可选的，但如果你想要进一步自定义多个终结点之间的路由行为，则名称非常有用。

通过代码

如果你偏向于将连接字符串存储到其他位置，则也可以在代码中读取连接字符串，并在调用 AddAzureSignalR()（在 ASP.NET Core 中）或 MapAzureSignalR()（在 ASP.NET 中）时将其用作参数。

下面是示例代码：

ASP.NET Core：

services.AddSignalR()
        .AddAzureSignalR(options => options.Endpoints = new ServiceEndpoint[]
        {
            new ServiceEndpoint("<connection_string1>", EndpointType.Primary, "region1"),
            new ServiceEndpoint("<connection_string2>", EndpointType.Secondary, "region2"),
        });

ASP.NET：

app.MapAzureSignalR(GetType().FullName, hub,  options => options.Endpoints = new ServiceEndpoint[]
    {
        new ServiceEndpoint("<connection_string1>", EndpointType.Primary, "region1"),
        new ServiceEndpoint("<connection_string2>", EndpointType.Secondary, "region2"),
    };

可以配置多个主要或次要实例。 如果有多个主要实例和/或次要实例，则协商会按以下顺序返回终结点：

1. 如果有至少一个主要实例处于联机状态，则会返回一个随机的联机主要实例。
2. 如果所有主要实例都停机，则会返回一个随机的联机次要实例。

对于 Azure Functions SignalR 绑定

要启用多个 SignalR 服务实例，应：

1. 使用 Persistent 传输类型。

   默认传输类型为 Transient 模式。 应将以下条目添加到 local.settings.json 文件或 Azure 上的应用程序设置。

   {
       "AzureSignalRServiceTransportType":"Persistent"
   }
   

   注意

   从 Transient 模式切换到 Persistent 模式后，可能会发生 JSON 序列化行为更改，因为在 Transient 模式下，Newtonsoft.Json 库用于序列化中心方法的参数，但在模式 Persistent 下，System.Text.Json 库将用作默认值。 System.Text.Json 在默认行为方面与 Newtonsoft.Json 存在一些关键差异。 如果要在 Persistent 模式下使用 Newtonsoft.Json，可以在 local.settings.json 文件或 Azure 门户上的 Azure__SignalR__HubProtocol=NewtonsoftJson 中添加配置项 "Azure:SignalR:HubProtocol":"NewtonsoftJson"。

2. 在配置中配置多个 SignalR 服务终结点条目。

   我们使用 ServiceEndpoint 对象来表示 SignalR 服务实例。 可以使用服务终结点在条目键中的 <EndpointName> 和 <EndpointType> 以及条目值中的连接字符串来定义服务终结点。 键采用以下格式：

   Azure:SignalR:Endpoints:<EndpointName>:<EndpointType>
   

   <EndpointType> 是可选的，默认值为 primary。 请参阅以下示例：

   {
       "Azure:SignalR:Endpoints:EastUs":"<ConnectionString>",
   
       "Azure:SignalR:Endpoints:EastUs2:Secondary":"<ConnectionString>",
   
       "Azure:SignalR:Endpoints:WestUs:Primary":"<ConnectionString>"
   }
   

   注意

   • 在 Azure 门户的应用服务中配置 Azure SignalR 终结点时，不要忘记将 ":" 替换为键中的双下划线 "__"。 要了解原因，请参阅 [环境变量]。

   • 使用键 {ConnectionStringSetting} 配置的连接字符串（默认为“AzureSignalRConnectionString”）也会识别为名称为空的主服务终结点。 但不建议将此配置样式用于多个终结点。

对于 [管理 SDK]

通过配置添加多个终结点

使用 SignalR 服务连接字符串的键 Azure:SignalR:Endpoints 进行配置。 该键应采用格式 Azure:SignalR:Endpoints:{Name}:{EndpointType}，其中 Name 和 EndpointType 是 ServiceEndpoint 对象的属性，并且可以从代码访问。

可以使用以下 dotnet 命令添加多个实例连接字符串：

dotnet user-secrets set Azure:SignalR:Endpoints:east-region-a <ConnectionString1>
dotnet user-secrets set Azure:SignalR:Endpoints:east-region-b:primary <ConnectionString2>
dotnet user-secrets set Azure:SignalR:Endpoints:backup:secondary <ConnectionString3>

通过代码添加多个终结点

ServiceEndpoint 类描述 Azure SignalR 服务终结点的属性。 使用 Azure SignalR 管理 SDK 时，可通过以下方式配置多个实例终结点：

var serviceManager = new ServiceManagerBuilder()
                    .WithOptions(option =>
                    {
                        options.Endpoints = new ServiceEndpoint[]
                        {
                            // Note: this is just a demonstration of how to set options.Endpoints
                            // Having ConnectionStrings explicitly set inside the code is not encouraged
                            // You can fetch it from a safe place such as Azure KeyVault
                            new ServiceEndpoint("<ConnectionString0>"),
                            new ServiceEndpoint("<ConnectionString1>", type: EndpointType.Primary, name: "east-region-a"),
                            new ServiceEndpoint("<ConnectionString2>", type: EndpointType.Primary, name: "east-region-b"),
                            new ServiceEndpoint("<ConnectionString3>", type: EndpointType.Secondary, name: "backup"),
                        };
                    })
                    .BuildServiceManager();