Azure SignalR Service의 복원력 및 재해 복구

구성을 통해

Azure:SignalR:ConnectionString이라는 구성 항목에서 환경 변수/애플리케이션 설정/web.cofig로 SignalR Service 연결 문자열을 설정하는 방법을 미리 알고 있어야 합니다. 여러 엔드포인트가 있는 경우 여러 구성 항목에서 각각 다음 형식으로 설정할 수 있습니다.

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 Service 인스턴스를 사용하도록 설정하려면 다음을 수행해야 합니다.

1. Persistent 전송 형식을 사용합니다.

   기본 전송 형식은 Transient 모드입니다. Azure의 local.settings.json 파일이나 애플리케이션 설정에 다음 항목을 추가해야 합니다.

   {
       "AzureSignalRServiceTransportType":"Persistent"
   }
   

   참고 항목

   Transient 모드에서 Persistent 모드로 전환할 때, Transient 모드에서는 허브 메서드의 인수를 직렬화하는 데 Newtonsoft.Json 라이브러리가 사용되지만, Persistent 모드에서는 기본적으로 System.Text.Json 라이브러리가 사용되므로 JSON serialization 동작이 변경될 수 있습니다. System.Text.Json은 Newtonsoft.Json과 기본 동작에 있어 몇 가지 주요 차이점이 있습니다. Persistent 모드에서 Newtonsoft.Json을 사용하려면 local.settings.json 파일에 "Azure:SignalR:HubProtocol":"NewtonsoftJson" 구성 항목을 추가하거나 Azure Portal에 Azure__SignalR__HubProtocol=NewtonsoftJson을 추가할 수 있습니다.

2. 구성에서 여러 SignalR Service 엔드포인트 항목을 구성합니다.

   ServiceEndpoint 개체를 사용하여 SignalR Service 인스턴스를 나타냅니다. <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 Portal의 App Service에서 Azure SignalR 엔드포인트를 구성할 때 키에서 ":"을 이중 밑줄인 "__"로 바꿔야 합니다. 자세한 내용은 환경 변수를 참조하세요.

   • {ConnectionStringSetting} 키로 구성된 연결 문자열(기본값은 "AzureSignalRConnectionString")도 이름이 비어 있는 기본 서비스 엔드포인트로 인식됩니다. 하지만 이러한 구성 스타일은 여러 엔드포인트에는 권장되지 않습니다.

관리 SDK용

구성에서 여러 엔드포인트 추가

SignalR Service 연결 문자열에 대해 키 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 Service 엔드포인트의 속성을 설명합니다. Azure SignalR Management 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();