Orleans 2.0 官方文档 —— 6.1 部署 -> 运行程序

Orleans应用程序

典型的Orleans应用程序，由一组Grain所在的服务器进程（silo）和一组客户端进程（通常是Web服务器）组成。客户端进程接收外部请求，将它们转换为grain方法调用，然后返回结果。因此，运行Orleans应用程序需要做的第一件事就是启动一个silo集群。出于测试目的，集群可以由单个silo组成。为了实现可靠的生产部署，我们显然希望集群中有多个silo用于容错和扩展。

一旦集群启动后，我们可以启动一个或多个连接到集群的客户端进程，并可以向grain发送请求。客户端连接到silo上的一个特殊的TCP端点（称为网关）。默认情况下，集群中的每个silo都启用了客户端网关。因此，客户可以并行连接所有silo，以获得更好的性能和弹性。

配置和启动silo

silo通过ClusterConfiguration对象，以编程的方式配置。它可以从文件加载设置，直接被实例化和填充，或者使用一些可用的帮助方法对不同的部署环境来创建。对于本地测试，最简单的方法是使用ClusterConfiguration.LocalhostPrimarySilo()帮助方法。然后将配置对象传递给SiloHost类的一个新实例，然后初始化并启动该实例。

您可以创建一个空控制台应用程序项目，目标是.NET Framework 4.6.1或更高版本，来承载一个silo。将Microsoft.Orleans.ServerNuGet元数据包添加到项目中。

PM> Install-Package Microsoft.Orleans.Server

以下是如何启动本地silo的示例：

var siloConfig = ClusterConfiguration.LocalhostPrimarySilo(); 
var silo = new SiloHost("Test Silo", siloConfig); 
silo.InitializeOrleansSilo(); 
silo.StartOrleansSilo();

Console.WriteLine("Press Enter to close."); 
// wait here
Console.ReadLine(); 

// shut the silo down after we are done.
silo.ShutdownOrleansSilo();

配置和连接客户端

通过ClientConfiguration对象和一个ClientBuilder，以编程的方式，配置用于连接到silo集群并向grain发送请求的客户端。 ClientConfiguration对象可以从文件加载设置，直接实例化和填充，或者使用一些可用的帮助方法对不同的部署环境来创建。对于本地测试，最简单的方法是使用ClientConfiguration.LocalhostSilo()帮助方法。然后将配置对象传递给ClientBuilder类的新实例。

ClientBuilder公开了更多的方法，用来配置客户端功能。然后，调用ClientBuilder对象的Build方法，来获得一个IClusterClient接口的实现。最后，我们在返回的对象上调用Connect()方法，来连接到集群。

您可以创建一个面向.NET Framework 4.6.1或更高版本的空控制台应用程序项目，以运行客户端，或重用您为承载silo而创建的控制台应用程序项目。将Microsoft.Orleans.ClientNuGet元数据包添加到项目中。

PM> Install-Package Microsoft.Orleans.Client

以下是客户端如何连接到本地silo的示例：

var config = ClientConfiguration.LocalhostSilo();
var builder = new ClientBuilder().UseConfiguration(config).
var client = builder.Build();
await client.Connect();

生产配置

我们在这里使用的配置示例，用于测试在同一台机器（localhost）上运行的silo和客户端。在生产中，silo和客户端通常在不同的服务器上运行，并使用可靠的集群配置选项之一进行配置。您可以在“配置指南”（../ clusters_and_clients / configuration_guide / index.md）和“ 集群管理”的说明中找到有关该内容的更多信息。

•