Skip to main content
net8.0

Hosting utilities for Azure Cloud Services of Microsoft Orleans.

Published
Jul 16, 2025
1y ago
Total Downloads
215.7K
215,653

Install

dotnet add package Microsoft.Orleans.Hosting.AzureCloudServices --version 9.2.1
ProductVersions
.NET
net8.0

README

Microsoft Orleans Hosting for Azure Cloud Services

Introduction

Microsoft Orleans Hosting for Azure Cloud Services provides support for hosting Orleans silos in Azure Cloud Services. This package integrates Orleans with the Azure Cloud Services lifecycle, allowing your silos to properly start, stop, and take advantage of Azure Cloud Services features.

Getting Started

To use this package, install it via NuGet:

dotnet add package Microsoft.Orleans.Hosting.AzureCloudServices

Example - Configuring Orleans with Azure Cloud Services

using Microsoft.Extensions.Hosting;
using Orleans.Hosting;

// In your CloudService WorkerRole entry point
public class WorkerRole : RoleEntryPoint
{
    private ISiloHost _silo;

    public override bool OnStart()
    {
        // Create the silo host
        _silo = Host.CreateApplicationBuilder(args)
            .UseOrleans(builder =>
            {
                // Configure Orleans for Azure Cloud Services
                builder.UseAzureStorageClustering(options =>
                {
                    options.ConnectionString = "YOUR_AZURE_STORAGE_CONNECTION_STRING";
                });

                // Add other Orleans configurations as needed
            })
            .Build();

        // Start the silo
        _silo.StartAsync().GetAwaiter().GetResult();
        
        return base.OnStart();
    }

    public override void OnStop()
    {
        // Properly shutdown the silo
        _silo.StopAsync().GetAwaiter().GetResult();
        
        base.OnStop();
    }
}

Documentation

For more comprehensive documentation, please refer to:

Feedback & Contributing

Changes from Previous Version

No structural changes between v9.2.0 and v9.2.1.

Adoption Assessment

A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.

Compatibility metadata lists 1 target framework; confirm the exact target used by your application.The published metadata declares 28 direct dependency entries across framework groups. Inspect the resolved dependency graph for your target framework.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.