Microsoft.Orleans.Server
10.3.1
Prefix Reserved
dotnet add package Microsoft.Orleans.Server --version 10.3.1
NuGet\Install-Package Microsoft.Orleans.Server -Version 10.3.1
<PackageReference Include="Microsoft.Orleans.Server" Version="10.3.1" />
<PackageVersion Include="Microsoft.Orleans.Server" Version="10.3.1" />
<PackageReference Include="Microsoft.Orleans.Server" />
paket add Microsoft.Orleans.Server --version 10.3.1
#r "nuget: Microsoft.Orleans.Server, 10.3.1"
#:package Microsoft.Orleans.Server@10.3.1
#addin nuget:?package=Microsoft.Orleans.Server&version=10.3.1
#tool nuget:?package=Microsoft.Orleans.Server&version=10.3.1
Microsoft Orleans Server
Introduction
Microsoft Orleans Server is a metapackage that includes all the necessary components to run an Orleans silo (server). It simplifies the process of setting up an Orleans server by providing a single package reference rather than requiring you to reference multiple packages individually.
Getting Started
To use this package, install it via NuGet:
dotnet add package Microsoft.Orleans.Server
Example - Creating an Orleans Silo Host
using Microsoft.Extensions.Hosting;
using Orleans.Configuration;
using Orleans.Hosting;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Threading.Tasks;
// Define a grain interface
namespace MyGrainNamespace;
public interface IMyGrain : IGrainWithStringKey
{
Task<string> DoSomething();
}
// Implement the grain interface
public class MyGrain : Grain, IMyGrain
{
public Task<string> DoSomething()
{
return Task.FromResult("Done something!");
}
}
// Create the host
var builder = Host.CreateApplicationBuilder(args)
.UseOrleans(siloBuilder =>
{
siloBuilder
.UseLocalhostClustering();
});
// Start the host
var host = builder.Build();
await host.StartAsync();
// Get a reference to a grain and call it
var client = host.Services.GetRequiredService<IClusterClient>();
var grain = client.GetGrain<IMyGrain>("my-grain-id");
var result = await grain.DoSomething();
// Print the result
Console.WriteLine($"Result: {result}");
// Keep the host running until the application is shut down
await host.WaitForShutdownAsync();
Documentation
For more comprehensive documentation, please refer to:
- Microsoft Orleans Documentation
- Orleans server (silo) configuration
- .NET Generic Host
- Grain persistence
Feedback & Contributing
- If you have any issues or would like to provide feedback, please open an issue on GitHub
- Join our community on Discord
- Follow the @msftorleans Twitter account for Orleans announcements
- Contributions are welcome! Please review our contribution guidelines
- This project is licensed under the MIT license
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- Microsoft.AspNetCore.Connections.Abstractions (>= 10.0.3)
- Microsoft.CodeAnalysis.Analyzers (>= 3.11.0)
- Microsoft.CodeAnalysis.Common (>= 5.0.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 5.0.0)
- Microsoft.Extensions.Configuration (>= 10.0.5)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.5)
- Microsoft.Extensions.Configuration.Json (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.DependencyModel (>= 10.0.5)
- Microsoft.Extensions.Hosting (>= 10.0.5)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Logging (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Logging.Console (>= 10.0.5)
- Microsoft.Extensions.Logging.Debug (>= 10.0.5)
- Microsoft.Extensions.ObjectPool (>= 10.0.5)
- Microsoft.Extensions.Options (>= 10.0.5)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.5)
- Microsoft.Orleans.Persistence.Memory (>= 10.3.1)
- Microsoft.Orleans.Runtime (>= 10.3.1)
- Microsoft.Orleans.Sdk (>= 10.3.1)
- Newtonsoft.Json (>= 13.0.4)
- Polly (>= 8.6.4)
- Polly.Extensions (>= 8.6.5)
- System.IO.Hashing (>= 10.0.3)
- System.Memory.Data (>= 10.0.3)
-
net8.0
- Microsoft.AspNetCore.Connections.Abstractions (>= 8.0.24)
- Microsoft.CodeAnalysis.Analyzers (>= 3.11.0)
- Microsoft.CodeAnalysis.Common (>= 4.5.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 4.5.0)
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.2)
- Microsoft.Extensions.Configuration.Json (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.DependencyModel (>= 8.0.2)
- Microsoft.Extensions.Hosting (>= 8.0.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Logging (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.3)
- Microsoft.Extensions.Logging.Console (>= 8.0.1)
- Microsoft.Extensions.Logging.Debug (>= 8.0.1)
- Microsoft.Extensions.ObjectPool (>= 8.0.24)
- Microsoft.Extensions.Options (>= 8.0.2)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
- Microsoft.Orleans.Persistence.Memory (>= 10.3.1)
- Microsoft.Orleans.Runtime (>= 10.3.1)
- Microsoft.Orleans.Sdk (>= 10.3.1)
- Newtonsoft.Json (>= 13.0.4)
- Polly (>= 8.6.4)
- Polly.Extensions (>= 8.6.5)
- System.IO.Hashing (>= 10.0.3)
- System.IO.Pipelines (>= 8.0.0)
- System.Memory.Data (>= 8.0.1)
NuGet packages (130)
Showing the top 5 NuGet packages that depend on Microsoft.Orleans.Server:
| Package | Downloads |
|---|---|
|
Orleans.Clustering.Redis
Microsoft Orleans clustering provider backed by Redis |
|
|
Orleans.Reminders.Redis
Microsoft Orleans reminder provider backed by Redis |
|
|
Orleans.Persistence.Redis
Microsoft Orleans persistence provider backed by Redis |
|
|
SignalR.Orleans
Orleans backplane for SignalR Core. |
|
|
Orleans.Streams.Utils
Streaming utilities for Microsoft Orleans. |
GitHub repositories (27)
Showing the top 20 popular GitHub repositories that depend on Microsoft.Orleans.Server:
| Repository | Stars |
|---|---|
|
dodyg/practical-aspnetcore
Practical samples of ASP.NET Core 11, 10, 9, 8.0, 7.0, 6.0, 5.0, 3.1, 2.2, and 2.1,projects you can use. Readme contains explanations on all projects.
|
|
|
microsoft/aspire
Aspire is the tool for code-first, extensible, observable dev and deploy.
|
|
|
dotnet/samples
Sample code referenced by the .NET documentation
|
|
|
Dotnet-Boxed/Templates
.NET project templates with batteries included, providing the minimum amount of code required to get you going faster.
|
|
|
microsoft/dotnet-podcasts
.NET reference application shown at .NET Conf featuring ASP.NET Core, Blazor, .NET MAUI, Microservices, Orleans, Playwright, and more!
|
|
|
SteveDunn/Vogen
A semi-opinionated library which is a source generator and a code analyser. It Source generates Value Objects
|
|
|
microsoft/aspire-samples
Browse the sample apps demonstrating Aspire integration across C#, JavaScript, TypeScript, Python, Go, containers, databases, cloud, AI, and observability scenarios.
|
|
|
dotnetGame/MineCase
Minecraft server based on Orleans
|
|
| OrleansContrib/Orleankka |