服務端配置
Silo通過SiloHostBuilder和許多補充選項類以編程方式進行配置，
Silo配置有幾個關鍵方面：
- Orleans集群資訊
- 集群提供程式（不知道咋翻譯）
- Silo到Silo和Client到Silo通信的端點
- 應用部分
這是Silo配置的示例，該Silo配置定義群集資訊，使用Azure群集并配置應用程式部分：
var silo = new SiloHostBuilder()
// 集群資訊
.Configure<ClusterOptions>(options =>
{
options.ClusterId = "my-first-cluster";
options.ServiceId = "AspNetSampleApp";
})
// 群集提供程式
.UseAzureStorageClustering(options => options.ConnectionString = connectionString)
// 埠設定
.ConfigureEndpoints(siloPort: 11111, gatewayPort: 30000)
// 應用程式部分：只需參考我們使用的一個grain實作類即可
.ConfigureApplicationParts(parts => parts.AddApplicationPart(typeof(HelloGrain).Assembly).WithReferences())
// 創建Silo!
.Build();
注意：使用UseAzureStorageClustering需要參考Microsoft.Orleans.Clustering.AzureStorage
下面讓我們細分該示例中使用的步驟：
Orleans集群資訊
[...]
// 集群資訊
.Configure<ClusterOptions>(options =>
{
options.ClusterId = "my-first-cluster";
options.ServiceId = "AspNetSampleApp";
})
[...]
這里我們做了兩件事：
將設定ClusterId為"my-first-cluster"：這是Orleans集群的唯一ID，使用此ID的所有客戶端和Silo將能夠直接相互通信，但是，您可以選擇ClusterId對不同的部署使用不同的名稱，
設定ServiceId為"AspNetSampleApp"：這是您的應用程式的唯一ID，將由某些提供程式（例如持久性提供程式）使用，此ID應該保持穩定，并且在整個部署中都不應更改，
集群提供商（什么鬼）
[...]
// 群集提供程式
.UseAzureStorageClustering(options => options.ConnectionString = connectionString)
[...]
通常，基于Orleans構建的服務會部署在專用硬體或Azure上的節點群集上，對于開發和基本測驗，可以將Orleans部署在單節點配置中，當部署到節點集群中時，Orleans內部實作一組協議以發現和維護集群中Orleans孤島的成員身份，包括節點故障檢測和自動重新配置，
為了可靠地管理群集成員身份，Orleans使用Azure Table，SQL Server或Apache ZooKeeper進行節點同步，
在此示例中，我們使用Azure Table作為成員資格提供程式，（現在微軟官網的東西都在推Azure，但是用它多少還是有點麻煩，還好能用SQL Server，后面的筆記中，我更多的可能會去使用SQL Server）
埠
var silo = new SiloHostBuilder()
[...]
// 埠設定
.ConfigureEndpoints(siloPort: 11111, gatewayPort: 30000)
[...]
Orleans的Silo有兩種典型的端點配置型別：
Silo到Silo的端點，用于同一集群中Silo之間的通信
客戶端到Silo（或網關），用于同一集群中的客戶端和Silo之間的通信
在示例中，我們使用幫助程式方法.ConfigureEndpoints(siloPort: 11111, gatewayPort: 30000)，該方法將用于Silo到Silo通信11111的埠設定為，將網關的埠設定為30000，此方法將檢測要監聽的介面，
在大多數情況下，此方法應該足夠了，但是如果需要，我們可以進一步對其進行自定義，
下面是一個如何通過一些埠轉發使用外部IP地址的示例：
[...]
.Configure<EndpointOptions>(options =>
{
// 用于 Silo-to-Silo 的埠
options.SiloPort = 11111;
// gateway 的埠
options.GatewayPort = 30000;
// 在集群中進行注冊的IP地址
options.AdvertisedIPAddress = IPAddress.Parse("172.16.0.42");
// 監聽的silo 遠程連接點
options.GatewayListeningEndpoint = new IPEndPoint(IPAddress.Any, 40000);
// 監聽的silo 遠程埠連接點
options.SiloListeningEndpoint = new IPEndPoint(IPAddress.Any, 50000);
})
//監聽的主silo 遠程連接點 為空則創建一個主silo連接點
.UseDevelopmentClustering(new IPEndPoint(IPAddress.Parse("192.168.8.1"),11111))
[...]
在內部，Silo將偵聽0.0.0.0:40000和0.0.0.0:50000，但是在成員資格提供程式中發布的值將是172.16.0.42:11111和172.16.0.42:30000，
應用部分
[...]
// Application parts: just reference one of the grain implementations that we use
.ConfigureApplicationParts(parts => parts.AddApplicationPart(typeof(ValueGrain).Assembly).WithReferences())
[...];
盡管從技術上來說這不是必需的步驟（如果未配置，Orleans將掃描當前檔案夾中的所有程式集），但鼓勵開發人員進行配置，此步驟將幫助Orleans加載用戶程式集和型別，這些組件稱為應用程式零件，所有粒度，粒度介面和序列化程式都是使用“應用程式部件”發現的，
應用部件使用配置IApplicationPartsManager，這可以使用IClientBuilder和ISiloHostBuilder下的ConfigureApplicationParts擴展方法，該ConfigureApplicationParts方法接受委托Action<IApplicationPartManager>，
以下擴展方法IApplicationPartManager支持常用功能：
AddApplicationPart(assembly)可以使用此擴展方法添加單個裝配件，AddFromAppDomain()添加當前加載到中的所有程式集AppDomain，AddFromApplicationBaseDirectory()在當前基本路徑中加載并添加所有程式集（請參閱參考資料AppDomain.BaseDirectory），
通過上述方法添加的程式集可以在其回傳型別上使用以下擴展方法進行補充IApplicationPartManagerWithAssemblies：
WithReferences()從添加的零件中添加所有參考的裝配，這將立即加載所有傳遞參考的程式集，程式集加載錯誤將被忽略，WithCodeGeneration()為添加的零件生成支持代碼，并將其添加到零件管理器中，請注意，這要求Microsoft.Orleans.OrleansCodeGenerator安裝該軟體包，通常稱為運行時代碼生成，
型別發現要求提供的應用程式部分包括特定屬性，建議將構建時代碼生成程式包（Microsoft.Orleans.CodeGenerator.MSBuild或Microsoft.Orleans.OrleansCodeGenerator.Build）添加到每個包含Grains，Grain介面或序列化程式的專案中，以確保存在這些屬性，生成時代碼生成僅支持C＃，對于F＃，Visual Basic和其他.NET語言，可以通過上述WithCodeGeneration()方法在配置期間生成代碼，有關代碼生成的更多資訊，請參見相應的部分，
便捷路由
目錄 ： Orleans[NET Core 3.1] 學習筆記（一）.NET環境下的分布式應用程式
上一節 ： Orleans[NET Core 3.1] 學習筆記（三）（ 2 ）客戶端配置
下一節 ：Orleans[NET Core 3.1] 學習筆記（四）（ 1 ）創建專案
轉載請註明出處，本文鏈接：https://www.uj5u.com/net/81939.html
標籤：.NET Core