Skip to main content
net8.0

Microsoft Orleans Grain Directory provider backed by Azure Storage

Published
Jun 4, 2025
1y ago
Total Downloads
181.6K
181,649

Install

dotnet add package Microsoft.Orleans.GrainDirectory.AzureStorage --version 9.2.0-preview2
ProductVersions
.NET
net8.0

README

Microsoft Orleans Grain Directory for Azure Storage

Introduction

Microsoft Orleans Grain Directory for Azure Storage provides a grain directory implementation using Azure Storage. The grain directory is used to locate active grain instances across the cluster, and this package allows Orleans to store that information in Azure Storage.

Getting Started

To use this package, install it via NuGet:

dotnet add package Microsoft.Orleans.GrainDirectory.AzureStorage

Example - Configuring Azure Storage Grain Directory

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

var builder = Host.CreateApplicationBuilder(args)
    .UseOrleans(siloBuilder =>
    {
        siloBuilder
            .UseLocalhostClustering()
            // Configure Azure Storage as grain directory
            .UseAzureStorageGrainDirectoryAsDefault(options =>
            {
                options.ConnectionString = "YOUR_AZURE_STORAGE_CONNECTION_STRING";
                options.TableName = "GrainDirectory";
            });
    });

// Run the host
await builder.RunAsync();

Documentation

For more comprehensive documentation, please refer to:

Feedback & Contributing

Changes from Previous Version

No structural changes between v9.2.0-preview1 and v9.2.0-preview2.

Adoption Assessment

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

This version is marked prerelease. Validate its API and upgrade path before production use.Compatibility metadata lists 1 target framework; confirm the exact target used by your application.The published metadata declares 32 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.