ServiceStack.Azure​
ServiceStack.Azure package provides support to Azure ServiceBus and Azure Blob Storage. All features are incapsulated in single ServiceStack.Azure package. To install package run from NuGet
<PackageReference Include="ServiceStack.Azure" Version="8.*" />
ServiceStack.Azure includes implementation of the following ServiceStack providers:
- ServiceBusMqServer - MQ Server for invoking ServiceStack Services via Azure ServiceBus
- AzureBlobVirtualFiles - Virtual file system based on Azure Blob Storage
- AzureTableCacheClient - Cache client over Azure Table Storage
ServiceBusMqServer​
The code to configure and start an ServiceBus MQ Server is similar to other MQ Servers:
container.Register<IMessageService>(c => new ServiceBusMqServer(ConnectionString));
var mqServer = container.Resolve<IMessageService>();
mqServer.RegisterHandler<ServiceDto>(ExecuteMessage);
AfterInitCallbacks.Add(appHost => mqServer.Start());
Where ConnectionString is connection string to Service Bus, how to obtain it from Azure Portal you can find in Get Started with Service Bus queues article
When an MQ Server is registered, ServiceStack automatically publishes Requests accepted on the "One Way" pre-defined route to the registered MQ broker. The message is later picked up and executed by a Message Handler on a background Thread.
Virtual FileSystem backed by Azure Blob Storage​
You can use an Azure Blob Storage Container to serve website content with the AzureBlobVirtualFiles.
public class AppHost : AppHostBase
{
public override void Configure(Container container)
{
//All Razor Views, Markdown Content, imgs, js, css, etc are served from an Azure Blob Storage container
//Use connection string to Azure Storage Emulator. For real application you should use connection string
//to your Azure Storage account
var azureBlobConnectionString = "UseDevelopmentStorage=true";
//Azure container which hold your files. If it does not exist it will be automatically created.
var containerName = "myazurecontainer";
VirtualFiles = new AzureBlobVirtualFiles(connectionString, containerName);
AddVirtualFileSources.Add(VirtualFiles);
}
}
Caching support with Azure Table Storage​
The AzureTableCacheClient implements ICacheClientExteded and IRemoveByPattern using Azure Table Storage.
public class AppHost : AppHostBase
{
public override void Configure(Container container)
{
string cacheConnStr = "UseDevelopmentStorage=true;";
container.Register<ICacheClient>(new AzureTableCacheClient(cacheConnStr));
}
}
Deploying to Azure​
See Rockwind.Azure for a working configuration and step-by-step guide to deploy .NET Core Web Apps to Azure using Docker.
Community Resources​
- Using the Azure Cache With ServiceStack by @emmanuelnelson
- Securing ServiceStack using Azure Authentication Library and WPF Client by @randompunter
- ServiceStack.Azure, supporting VirtualPathProvider backed by Azure Blob Storage, and ICacheProvider backed by Azure Table Storage