Orleans NuGet パッケージ
Orleans のコンシューマーは、特定の目的の動作を実現するために、さまざまな NuGet パッケージに依存しています。 いくつかの一般的なパッケージと抽象化、および多数の単一目的の個別パッケージがあります。 この記事では、開発者が使用する必要がある Orleans パッケージを確認するのに役立つ分析情報を提供します。
主要なパッケージ
Orleans アプリを作成するときは、選んだワークロードに応じて、相互に排他的な 2 つの NuGet パッケージのいずれかを参照します。 たとえば、Orleans サイロを記述するときは、Microsoft.Orleans.Server NuGet パッケージを参照します。 Orleans クライアント アプリを作成するときは、Microsoft.Orleans.Client NuGet パッケージを参照します。 抽象化やグレイン クラス ライブラリなど、すべての Orleans プロジェクトでは、Microsoft.Orleans.Sdk NuGet パッケージを参照します。 Microsoft.Orleans.Sdk パッケージは、Client と Server パッケージの両方に含まれています。
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.Client | Orleans クライアントに必要なクライアント専用パッケージ。 |
| Microsoft.Orleans.Sdk | すべての Orleans アプリで必要なメタパッケージ。サーバーとクライアントのパッケージは、このパッケージに依存します。 |
| Microsoft.Orleans.Server | Orleans サイロに必要なサーバー専用パッケージ。 |
NuGet パッケージのインストールについては、次のオプションをご覧ください。
Hosting
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.Hosting.AzureCloudServices | Orleans の Azure Cloud Services 用のホスティング ユーティリティ。 |
| Microsoft.Orleans.Hosting.Kubernetes | Kubernetes 用の Orleans ホスティング サポート。 |
| Microsoft.Orleans.Runtime | サイロ内でグレインをホストおよび実行する Orleans のコア ランタイム ライブラリ。 |
クラスタリング プロバイダー
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.Clustering.AzureStorage | Azure Table Storage によってサポートされる Orleans クラスタリング プロバイダー。 |
| Microsoft.Orleans.Clustering.AdoNet | ADO.NET によってサポートされる Orleans クラスタリング プロバイダー。 |
| Microsoft.Orleans.Clustering.DynamoDB | AWS DynamoDB によってサポートされる Orleans クラスタリング プロバイダー。 |
リマインダー プロバイダー
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.Reminders | サーバーで使われる Microsoft Orleans 用のリマインダー ライブラリ。 |
| Microsoft.Orleans.Reminders.AzureStorage | Azure Table Storage によってサポートされる Orleans リマインダー プロバイダー。 |
| Microsoft.Orleans.Reminders.AdoNet | ADO.NET によってサポートされる Orleans リマインダー プロバイダー。 |
| Microsoft.Orleans.Reminders.DynamoDB | AWS DynamoDB によってサポートされる Orleans リマインダー プロバイダー。 |
グレイン ストレージ プロバイダー
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.Persistence.AdoNet | ADO.NET によってサポートされる Orleans 永続化プロバイダー。 |
| Microsoft.Orleans.Persistence.AzureStorage | Azure Table Storage によってサポートされる Orleans 永続化プロバイダー。 |
| Microsoft.Orleans.Persistence.DynamoDB | AWS DynamoDB によってサポートされる Orleans 永続化プロバイダー。 |
| Microsoft.Orleans.Persistence.Memory | Orleans 用のメモリ内ストレージ。 |
Stream プロバイダー
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.Streaming | クライアントとサーバーの両方で使われる Orleans 用のストリーミング ライブラリ。 |
| Microsoft.Orleans.Streaming.AzureStorage | Azure Queue Storage によってサポートされる Orleans ストリーミング プロバイダー。 |
| Microsoft.Orleans.Streaming.EventHubs | Azure Event Hubs によってサポートされる Orleans ストリーミング プロバイダー。 |
| Microsoft.Orleans.Streaming.SQS | AWS SQS によってサポートされる Orleans ストリーミング プロバイダー。 |
その他のパッケージ
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.Analyzers | Orleans 用の C# アナライザー。 |
| Microsoft.Orleans.CodeGenerator | Microsoft.Orleans.Serialization 用のコード生成ライブラリ。 |
| Microsoft.Orleans.EventSourcing | イベント ソース状態で Orleans グレインを作成するための基本型。 |
| Microsoft.Orleans.Connections.Security | Orleans での TLS を使用したセキュリティ通信のサポート。 |
開発とテスト
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.TestingHost | テスト プロジェクトでサイロをホストするための Orleans ライブラリ。 |
| Microsoft.Orleans.Transactions.TestKit.Base | トランザクション用のテスト キットの基本ライブラリ。 |
| Microsoft.Orleans.Transactions.TestKit.xUnit | トランザクション用の xUnit テスト キット ライブラリ。 |
| Microsoft.Orleans.Serialization.TestKit | Microsoft.Orleans.Serialization を使用するプロジェクト用のテスト キット。 |
シリアライザー
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.Serialization | .NET 用の高速で柔軟でバージョン トレラントなシリアライザー。 |
| Microsoft.Orleans.Serialization.Abstractions | Orleans 用のシリアル化抽象化。 |
| Microsoft.Orleans.Serialization.SystemTextJson | Microsoft.Orleans.Serialization 用の System.Text.Json 統合。 |
| Microsoft.Orleans.Serialization.FSharp | Microsoft.Orleans.Serialization 用の F# コア型のサポート。 |
| Microsoft.Orleans.Serialization.NewtonsoftJson | Microsoft.Orleans.Serialization 用の Newtonsoft.Json 統合。 |
トランザクション
| NuGet パッケージ | 説明 |
|---|---|
| Microsoft.Orleans.Transactions | サーバーで使用される Orleans のコア トランザクション ライブラリ。 |
| Microsoft.Orleans.Transactions.AzureStorage | Azure Storage によってサポートされる Orleans トランザクション ストレージ プロバイダー。 |
ツール
人気のある Orleans ツールの 1 つは、OrleansDashboard NuGet パッケージです。 このダッシュボードでは、Orleans アプリ内で起きていることについての簡単なメトリックと分析情報がいくつか提供されます。 詳細については、GitHub の Orleans ダッシュボードに関するページを参照してください。
主要なパッケージ
ほとんどのシナリオでは、5 つの主要な NuGet パッケージを使う必要があります。
Orleans コア抽象化
Install-Package Microsoft.Orleans.Core.Abstractions
アプリケーション コード (グレイン インターフェイスとクラス) の開発に必要な Orleans のパブリック型が定義されている Orleans.Core.Abstractions.dll が含まれます。 Orleans プロジェクトでは、このパッケージを直接または間接的に参照する必要があります。 グレイン インターフェイスとクラスを定義するプロジェクトにそれを追加します。
Orleans ビルド時のコード生成
Microsoft.Orleans.OrleansCodeGenerator.Build。
Install-Package Microsoft.Orleans.OrleansCodeGenerator.BuildOrleans 1.2.0 で導入されました。 グレイン インターフェイスと実装プロジェクトのビルド時のサポート。 グレイン参照とシリアライザーのコードを生成できるようにするには、それをグレイン インターフェイスと実装プロジェクトに追加します。
Microsoft.Orleans.CodeGenerator.MSBuild。
Install-Package Microsoft.Orleans.CodeGenerator.MSBuildOrleans 2.1.0 の一部として導入されました。
Microsoft.Orleans.OrleansCodeGenerator.Buildパッケージの代替。 Roslyn をコード分析に利用して、アプリケーション バイナリの読み込みを回避し、インクリメンタル ビルドのサポートを改善します。これにより、ビルド時間が短縮されます。
Orleans サーバー ライブラリ
Install-Package Microsoft.Orleans.Server
サイロを簡単に構築して開始するためのメタパッケージ。 次のパッケージを含んでいます。
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansRuntimeMicrosoft.Orleans.OrleansProviders
Orleans クライアント ライブラリ
Install-Package Microsoft.Orleans.Client
Orleans クライアント (フロントエンド) を簡単にビルドして開始するためのメタパッケージ。 次のパッケージを含んでいます。
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansProviders
Orleans コア ライブラリ
Install-Package Microsoft.Orleans.Core
アプリケーション コードと Orleans クライアント (フロントエンド) で使われるほとんどの Orleans パブリック型の実装が含まれます。 Orleans 型を使用するが、ホスティングやサイロを処理しないライブラリとクライアント アプリケーションをビルドするには、これを参照します。 Microsoft.Orleans.Client と Microsoft.Orleans.Server メタパッケージに含まれており、他のほとんどのパッケージによって直接または間接に参照されます。
Hosting
Orleans ランタイム
Install-Package Microsoft.Orleans.OrleansRuntime
サイロを構成および開始するためのライブラリ。 サイロ ホスト プロジェクトで参照します。 Microsoft.Orleans.Server メタパッケージに含まれます。
Orleans ランタイム抽象化
Install-Package Microsoft.Orleans.Runtime.Abstractions
Microsoft.Orleans.OrleansRuntime で実装されている型のインターフェイスと抽象化が含まれます。
Azure Cloud Services での Orleans ホスティング
Install-Package Microsoft.Orleans.Hosting.AzureCloudServices
サイロと Orleans クライアントを Azure Cloud Services (worker ロールと Web ロール) としてホストするためのヘルパー クラスが含まれます。
Orleans の Service Fabric ホスティング サポート
Install-Package Microsoft.Orleans.Hosting.ServiceFabric
ステートレス Service Fabric サービスとしてサイロをホストするためのヘルパー クラスが含まれます。
クラスタリング プロバイダー
以下のパッケージには、さまざまなストレージ テクノロジでクラスター メンバーシップ データを保持するためのプラグインが含まれます。
Azure Table Storage 用の Orleans クラスタリング プロバイダー
Install-Package Microsoft.Orleans.Clustering.AzureStorage
クラスター メンバーシップ データの格納用に Azure Tables を使うためのプラグインが含まれます。
ADO.NET プロバイダー用の Orleans クラスタリング プロバイダー
Install-Package Microsoft.Orleans.Clustering.AdoNet
サポートされているいずれかのデータベースでのクラスター メンバーシップ データの格納用に ADO.NET を使うためのプラグインが含まれます。
Orleans Consul ユーティリティ
Install-Package Microsoft.Orleans.OrleansConsulUtils
クラスター メンバーシップ データの格納用に Consul を使うためのプラグインが含まれます。
Orleans ZooKeeper ユーティリティ
Install-Package Microsoft.Orleans.OrleansZooKeeperUtils
クラスター メンバーシップ データの格納用に ZooKeeper を使うためのプラグインが含まれます。
AWS DynamoDB 用 Orleans クラスタリング プロバイダー
Install-Package Microsoft.Orleans.Clustering.DynamoDB
クラスター メンバーシップ データの格納用に AWS DynamoDB を使うためのプラグインが含まれます。
リマインダー プロバイダー
以下のパッケージには、さまざまなストレージ テクノロジでリマインダーを保持するためのプラグインが含まれます。
Orleans リマインダー Azure Table Storage
Install-Package Microsoft.Orleans.Reminders.AzureStorage
リマインダーの格納用に Azure Tables を使うためのプラグインが含まれます。
Orleans リマインダー ADO.NET プロバイダー
Install-Package Microsoft.Orleans.Reminders.AdoNet
サポートされているいずれかのデータベースでのリマインダーの格納用に ADO.NET を使うためのプラグインが含まれます。
AWS DynamoDB 用 Orleans リマインダー プロバイダー
Install-Package Microsoft.Orleans.Reminders.DynamoDB
リマインダーの格納用に AWS DynamoDB を使うためのプラグインが含まれます。
グレイン ストレージ プロバイダー
以下のパッケージには、さまざまなストレージ テクノロジでグレインの状態を保持するためのプラグインが含まれます。
Orleans 永続化 Azure Storage
Install-Package Microsoft.Orleans.Persistence.AzureStorage
グレインの状態の格納用に Azure Tables または Azure BLOB を使うためのプラグインが含まれます。
Orleans 永続化 ADO.NET プロバイダー
Install-Package Microsoft.Orleans.Persistence.AdoNet
サポートされているいずれかのデータベースでのグレインの状態の格納用に ADO.NET を使うためのプラグインが含まれます。
Orleans 永続化 DynamoDB
Install-Package Microsoft.Orleans.Persistence.DynamoDB
グレインの状態の格納用に AWS DynamoDB を使うためのプラグインが含まれます。
Stream プロバイダー
以下のパッケージには、ストリーミング イベントを配信するためのプラグインが含まれます。
Orleans ServiceBus ユーティリティ
Install-Package Microsoft.Orleans.OrleansServiceBus
Azure Event Hubs 用のストリーム プロバイダーが含まれます。
Orleans ストリーミング Azure Storage
Install-Package Microsoft.Orleans.Streaming.AzureStorage
Azure Queue 用のストリーム プロバイダーが含まれます。
Orleans ストリーミング AWS SQS
Install-Package Microsoft.Orleans.Streaming.SQS
AWS SQS サービス用のストリーム プロバイダーが含まれます。
Orleans Google Cloud Platform ユーティリティ
Install-Package Microsoft.Orleans.OrleansGCPUtils
GCP PubSub サービス用のストリーム プロバイダーが含まれます。
その他のパッケージ
Orleans コード生成
Install-Package Microsoft.Orleans.OrleansCodeGenerator
ランタイム コード ジェネレーターが含まれています。
Orleans イベント ソーシング
Install-Package Microsoft.Orleans.EventSourcing
イベント ソース状態でグレイン クラスを作成するための基本データ型のセットが含まれます。
開発とテスト
Orleans プロバイダー
Install-Package Microsoft.Orleans.OrleansProviders
メモリ内にデータを保持する永続化とストリームのプロバイダーのセットが含まれます。 テスト用です。 一般に、サイロで障害が発生してデータの損失が許容される場合を除き、運用環境での使用は推奨されません。
Orleans テスト ホスト ライブラリ
Install-Package Microsoft.Orleans.TestingHost
テスト プロジェクトでサイロとクライアントをホストするためのライブラリが含まれます。
シリアライザー
Orleans Bond シリアライザー
Install-Package Microsoft.Orleans.Serialization.Bond
Bond シリアライザーのサポートが含まれます。
Orleans Google ユーティリティ
Install-Package Microsoft.Orleans.OrleansGoogleUtils
Google プロトコル バッファー シリアライザーが含まれます。
Orleans protobuf-net シリアライザー
Install-Package Microsoft.Orleans.ProtobufNet
プロトコル バッファー シリアライザーの protobuf-net バージョンが含まれます。
テレメトリ
Orleans テレメトリ コンシューマー - パフォーマンス カウンター
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters
Orleans Telemetry API の Windows パフォーマンス カウンターの実装。
Orleans テレメトリ コンシューマー - Azure Application Insights
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI
Azure Application Insights 用のテレメトリ コンシューマーが含まれます。
Orleans テレメトリ コンシューマー - NewRelic
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic
NewRelic 用のテレメトリ コンシューマーが含まれます。
トランザクション
Orleans トランザクション サポート
Install-Package Microsoft.Orleans.Transactions
クロスグレイン トランザクション (ベータ) のサポートが含まれます。
Azure での Orleans トランザクション
Install-Package Microsoft.Orleans.Transactions.AzureStorage
Azure Table にトランザクション ログを保持するためのプラグインが含まれます (ベータ)。
ツール
Orleans パフォーマンス カウンター ツール
Install-Package Microsoft.Orleans.CounterControl
Orleans の統計情報とデプロイされたグレイン クラスのための Windows パフォーマンス カウンター カテゴリを登録する OrleansCounterControl.exe が含まれます。 昇格が必要です。 ロールのスタートアップ タスクの一部として Azure で実行できます。
.NET