SignalR Scaleout with Azure Service Bus

by Patrick Fletcher

Warning

This documentation isn't for the latest version of SignalR. Take a look at ASP.NET Core SignalR.

In this tutorial, you will deploy a SignalR application to a Windows Azure Web Role, using the Service Bus backplane to distribute messages to each role instance. (You can also use the Service Bus backplane with web apps in Azure App Service.)

Diagram that shows arrows from Topic to Web Roles to computers. An arrow labeled publish starts at Web Roles and goes to Topic.

Prerequisites:

The service bus backplane is also compatible with Service Bus for Windows Server, version 1.1. However, it is not compatible with version 1.0 of Service Bus for Windows Server.

Pricing

The Service Bus backplane uses topics to send messages. For the latest pricing information, see Service Bus. At the time of this writing, you can send 1,000,000 messages per month for less than $1. The backplane sends a service bus message for each invocation of a SignalR hub method. There are also some control messages for connections, disconnections, joining or leaving groups, and so forth. In most applications, the majority of the message traffic will be hub method invocations.

Overview

Before we get to the detailed tutorial, here is a quick overview of what you will do.

  1. Use the Windows Azure portal to create a new Service Bus namespace.

  2. Add these NuGet packages to your application:

  3. Create a SignalR application.

  4. Add the following code to Startup.cs to configure the backplane:

    public void Configuration(IAppBuilder app)
    {
        string connectionString = "Service Bus connection string";
        GlobalHost.DependencyResolver.UseServiceBus(connectionString, "YourAppName");
    
        app.MapSignalR();
        // ...
    }
    

This code configures the backplane with the default values for TopicCount and MaxQueueLength. For information on changing these values, see SignalR Performance: Scaleout Metrics.

For each application, pick a different value for "YourAppName". Do not use the same value across multiple applications.

Create the Azure Services

Create a Cloud Service, as described in How to Create and Deploy a Cloud Service. Follow the steps in the section "How to: Create a cloud service using Quick Create". For this tutorial, you do not need to upload a certificate.

Screenshot of the option Cloud Service circled in red.

Create a new Service Bus namespace, as described in How to Use Service Bus Topics/Subscriptions. Follow the steps in the section "Create a Service Namespace".

Screenshot of window titled add a new namespace with options below.

Note

Make sure to select the same region for the cloud service and the Service Bus namespace.

Create the Visual Studio Project

Start Visual Studio. From the File menu, click New Project.

In the New Project dialog box, expand Visual C#. Under Installed Templates, select Cloud and then select Windows Azure Cloud Service. Keep the default .NET Framework 4.5. Name the application ChatService and click OK.

Screenshot that shows the New Project dialog box. Cloud is selected in the Office Share Point folder. Chat Service is in the Name field.

In the New Windows Azure Cloud Service dialog, select ASP.NET Web Role. Click the right-arrow button (>) to add the role to your solution.

Hover the mouse over the new role, so the pencil icon visible. Click this icon to rename the role. Name the role "SignalRChat" and click OK.

Screenshot that shows the New Windows Azure Cloud Service dialog box. Signal R Chat is typed above A S P dot NET Web Role.

In the New ASP.NET Project dialog, select MVC, and click OK.

Screenshot that shows the New A S P dot NET Project dialog box. M V C is the selected template.

The project wizard creates two projects:

  • ChatService: This project is the Windows Azure application. It defines the Azure roles and other configuration options.
  • SignalRChat: This project is your ASP.NET MVC 5 project.

Create the SignalR Chat Application

To create the chat application, follow the steps in the tutorial Getting Started with SignalR and MVC 5.

Use NuGet to install the required libraries. From the Tools menu, select NuGet Package Manager, then select Package Manager Console. In the Package Manager Console window, enter the following commands:

Install-Package -ProjectName SignalRChat Microsoft.AspNet.SignalR
Install-Package -ProjectName SignalRChat Microsoft.AspNet.SignalR.ServiceBus

Use the -ProjectName option to install the packages to the ASP.NET MVC project, rather than the Windows Azure project.

Configure the Backplane

In your application's Startup.cs file, add the following code:

public void Configuration(IAppBuilder app)
{
    // Any connection or hub wire up and configuration should go here
    string connectionString = "";
    GlobalHost.DependencyResolver.UseServiceBus(connectionString, "Chat");  

    app.MapSignalR();
}

Now you need to get your service bus connection string. In the Azure portal, select the service bus namespace that you created and click the Access Key icon.

Screenshot that shows a plus sign labeled Create, a key labeled Access Key, and a trash can labeled Delete.

Copy the connection string to the clipboard, then paste it into the connectionString variable.

Screenshot that shows the Access Key Connect to your namespace dialog box.

string connectionString = "Endpoint=sb://xxxx.servicebus.windows.net/;
SharedSecretIssuer=owner;SharedSecretValue=XXXXXXXX";

Deploy to Azure

In Solution Explorer, expand the Roles folder inside the ChatService project.

Screenshot that shows an open folder titled Roles. Signal R Chat is selected.

Right-click the SignalRChat role and select Properties. Select the Configuration tab. Under Instances select 2. You can also set the VM size to Extra Small.

Screenshot that shows Instances. The Instance count is set to 2 and the V M Size is set to Extra small.

Save the changes.

In Solution Explorer, right-click the ChatService project. Select Publish.

Screenshot that shows Solution Explorer. Publish is selected in the Chat Service context menu.

If this is your first time publishing to Windows Azure, you must download your credentials. In the Publish wizard, click "Sign in to download credentials". This will prompt you to sign into the Windows Azure portal and download a publish settings file.

Screenshot that shows the Publish Windows Azure Application dialog box. Sign in to download credentials is circled in red.

Click Import and select the publish settings file that you downloaded.

Click Next. In the Publish Settings dialog, under Cloud Service, select the cloud service that you created earlier.

Screenshot that shows the Windows Azure Publish Settings page.

Click Publish. It can take a few minutes to deploy the application and start the VMs.

Now when you run the chat application, the role instances communicate through Azure Service Bus, using a Service Bus topic. A topic is a message queue that allows multiple subscribers.

The backplane automatically creates the topic and the subscriptions. To see the subscriptions and message activity, open the Azure portal, select the Service Bus namespace, and click on "Topics".

Screenshot of navigation menu with topics selected.

It make take a few minutes for the message activity to show up in the dashboard.

Screenshot that shows a graph of subscription and message activity on a timeline.

SignalR manages the topic lifetime. As long as your application is deployed, don't try to manually delete topics or change settings on the topic.

Troubleshooting

System.InvalidOperationException "The only supported IsolationLevel is 'IsolationLevel.Serializable'."

This error can occur if the transaction level for an operation is set to something other than Serializable. Verify that no operations are being performed with other transaction levels.