如何在.NET 4.8上托管MS Orleans 7.0并通过ASP.NET使用？

核心前提 #

Orleans与Microsoft.Hosting均支持.NET Standard 2.0，而.NET 4.8完全兼容该标准，因此可以在经典ASP.NET（如MVC4）中实现集成。

初始化位置 #

经典ASP.NET应用的启动入口为Global.asax的Application_Start方法，Orleans Host的初始化与启动需放在此处；应用关闭时的资源释放则放在Application_End方法中。

实现步骤与示例代码 #

1. 安装依赖NuGet包 #

需安装以下兼容.NET Standard 2.0的包：

• Microsoft.Extensions.Hosting
• Orleans.Server
• Orleans.Client
• Orleans.Configuration
• Orleans.Persistence.Memory（开发环境用，生产环境替换为持久化存储包）

2. 在Global.asax中初始化Orleans Host #

public class MvcApplication : System.Web.HttpApplication
{
    // 全局保存Orleans Host实例，供应用内调用
    public static IHost OrleansHost { get; private set; }

    protected void Application_Start()
    {
        // 保留原有ASP.NET MVC初始化代码
        AreaRegistration.RegisterAllAreas();
        FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
        RouteConfig.RegisterRoutes(RouteTable.Routes);
        BundleConfig.RegisterBundles(BundleTable.Bundles);

        // 构建并启动Orleans Host
        OrleansHost = new HostBuilder()
            .UseOrleans(builder =>
            {
                // 本地开发集群配置（生产环境需替换为实际集群管理器）
                builder.UseLocalhostClustering();
                
                // 配置集群标识
                builder.Configure<ClusterOptions>(options =>
                {
                    options.ClusterId = "AspNetDotNet48OrleansCluster";
                    options.ServiceId = "AspNetMvc4OrleansService";
                });
                
                // 开发环境使用内存存储，生产环境替换为持久化方案
                builder.AddMemoryGrainStorageAsDefault();
            })
            .Build();

        // 同步启动Host（因Application_Start为同步方法）
        OrleansHost.StartAsync().Wait();
    }

    protected void Application_End()
    {
        // 关闭并释放Orleans Host资源
        OrleansHost?.StopAsync().Wait();
        OrleansHost?.Dispose();
    }
}

3. 定义并实现Orleans Grain #

Grain接口

public interface IHelloGrain : IGrainWithStringKey
{
    Task<string> SayHello(string name);
}

Grain实现

public class HelloGrain : Grain, IHelloGrain
{
    public Task<string> SayHello(string name)
    {
        return Task.FromResult($"Hello, {name}! This message comes from Orleans Grain in .NET 4.8 ASP.NET MVC.");
    }
}

4. 在ASP.NET控制器中调用Grain #

public class HomeController : Controller
{
    public async Task<ActionResult> Index()
    {
        // 从全局Host中获取Grain工厂
        var grainFactory = MvcApplication.OrleansHost.Services.GetRequiredService<IGrainFactory>();
        
        // 获取指定Grain实例并调用方法
        var helloGrain = grainFactory.GetGrain<IHelloGrain>("user_001");
        var greeting = await helloGrain.SayHello("Chris");
        
        ViewBag.Greeting = greeting;
        return View();
    }
}

注意事项 #

• 版本兼容：选择Orleans 3.x系列版本（完全支持.NET Standard 2.0），避免使用要求更高.NET版本的Orleans 4.x。
• IIS配置：应用池需设置为.NET CLR版本v4.0，托管管道模式推荐使用集成模式。
• 生产环境调整：替换内存存储为持久化方案（如SQL Server、Azure Table），集群配置改用Consul、ZooKeeper等成熟的集群管理器。
• 异步处理：Application_Start中使用Wait()是为了适配同步启动场景，确保Orleans Host完全就绪后再处理请求。

内容的提问来源于stack exchange，提问作者Chris Hayes