Orleans Balíčky NuGet
Spotřebitelé spoléhají na různé balíčky NuGet, aby dosáhli konkrétního požadovaného Orleans chování. Existuje několik běžných balíčků a abstrakcí a mnoho jednotlivých balíčků pro jednotlivé účely. Tento článek obsahuje přehledy, které vývojářům pomůžou zjistit, které Orleans balíčky se mají použít.
Balíčky klíčů
Při psaní Orleans aplikací odkazujete na jeden ze dvou vzájemně se vylučujících balíčků NuGet v závislosti na zvolené úloze. Když třeba napíšete Orleans Silo, budete odkazovat na Microsoft.Orleans. Balíček NuGet serveru Při psaní Orleans klientské aplikace budete odkazovat na Microsoft.Orleans. Balíček NuGet klienta Všechny Orleans projekty, jako jsou abstrakce nebo knihovny tříd zrn, odkazují na Microsoft.Orleans. Balíček NuGet sady SDK Balíček Microsoft.Orleans.Sdk je součástí balíčků Client i Server balíčků.
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. Klient | Balíček s výhradním klientem, který se vyžaduje pro Orleans klienta. |
| Microsoft.Orleans. Sdk | Metabalíč vyžadovaný všemi Orleans aplikacemi, serverovými a klientskými balíčky závisí na tomto balíčku. |
| Microsoft.Orleans. Server | Balíček s výhradním serverem, který se vyžaduje pro Orleans sila. |
Informace o instalaci balíčků NuGet najdete v následujících možnostech:
Hostování
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. Hosting.AzureCloudServices | Hostování nástrojů pro Azure Cloud Services of Orleans. |
| Microsoft.Orleans. Hosting.Kubernetes | Orleans podpora hostování pro Kubernetes. |
| Microsoft.Orleans. Runtime | Core runtime library of Orleans that hosts and executes grain within a silo. |
Poskytovatelé clusteringu
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. Clustering.AzureStorage | Orleans Poskytovatel clusteringu podporovaný službou Azure Table Storage. |
| Microsoft.Orleans. Clustering.AdoNet | Orleans poskytovatel clusteringu podporovaný ADO.NET. |
| Microsoft.Orleans. Clustering.DynamoDB | Orleans poskytovatel clusteringu podporovaný službou AWS DynamoDB. |
Zprostředkovatelé připomenutí
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. Upomínky | Knihovna připomenutí pro Microsoft Orleans , která se používá na serveru |
| Microsoft.Orleans. Reminders.AzureStorage | Orleans poskytovatel připomenutí zálohovaný službou Azure Table Storage. |
| Microsoft.Orleans. Reminders.AdoNet | Orleans poskytovatel připomenutí podporovaný ADO.NET. |
| Microsoft.Orleans. Reminders.DynamoDB | Orleans poskytovatel připomenutí podporovaný službou AWS DynamoDB. |
Poskytovatelé úložiště odstupňovaného úložiště
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. Persistence.AdoNet | Orleans Zprostředkovatel trvalosti založený na ADO.NET. |
| Microsoft.Orleans. Trvalost.AzureStorage | Orleans Zprostředkovatel trvalosti zálohovaný službou Azure Table Storage. |
| Microsoft.Orleans. Persistence.DynamoDB | Orleans Zprostředkovatel trvalosti podporovaný službou AWS DynamoDB. |
| Microsoft.Orleans. Trvalost.Memory | Úložiště v paměti pro Orleans. |
Poskytovatelé streamu
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. Proudem | Knihovna streamování pro Orleans použití na klientovi i na serveru. |
| Microsoft.Orleans. Streaming.AzureStorage | Orleans poskytovatel streamování zálohovaný službou Azure Queue Storage. |
| Microsoft.Orleans. Streaming.EventHubs | Orleans poskytovatel streamování podporovaný službou Azure Event Hubs. |
| Microsoft.Orleans. Streaming.SQS | Orleans poskytovatel streamování podporovaný AWS SQS. |
Další balíčky
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. Analyzátory | Analyzátory jazyka C# pro Orleans. |
| Microsoft.Orleans. CodeGenerator | Knihovna generování kódu pro Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. EventSourcing | Základní typy pro vytváření Orleans zrn se stavem zdroje událostí |
| Microsoft.Orleans. Connections.Security | Podpora komunikace zabezpečení pomocí protokolu TLS v Orleanssystému . |
Vývoj a testování
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. TestingHost | Orleans knihovna pro hostování sila v testovacím projektu. |
| Microsoft.Orleans. Transactions.TestKit.Base | Základní knihovna testovací sady pro transakce |
| Microsoft.Orleans. Transactions.TestKit.xUnit | Knihovna testovacích sad xUnit pro transakce. |
| Microsoft.Orleans. Serialization.TestKit | Testovací sada pro projekty používající Microsoft.Orleans.Serialization. |
Serializátory
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. Serializace | Serializátor odolný proti rychlým, flexibilním a verzím pro .NET |
| Microsoft.Orleans. Serializace.Abstrakce | Abstrakce serializace pro Orleans. |
| Microsoft.Orleans. Serialization.SystemTextJson | System.Text.Json integrace pro Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialization.FSharp | Podpora typu jádra F# pro Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialization.NewtonsoftJson | Newtonsoft.Json integrace pro Microsoft.Orleans.Serialization. |
Transakce
| Balíček NuGet | Popis |
|---|---|
| Microsoft.Orleans. Transakce | Základní knihovna transakcí použitá Orleans na serveru. |
| Microsoft.Orleans. Transactions.AzureStorage | Orleans transakce poskytovatele úložiště zálohovaného službou Azure Storage. |
Nástroje
Jedním z oblíbených Orleans nástrojů je balíček NuGet OrleansDashboard . Tento řídicí panel poskytuje několik jednoduchých metrik a přehledů o tom, co se děje v aplikaci Orleans . Další informace najdete v tématu GitHub: Orleans Řídicí panel.
Balíčky klíčů
Ve většině scénářů budete muset použít 5 klíčových balíčků NuGet:
Orleans Základní abstrakce
Install-Package Microsoft.Orleans.Core.Abstractions
Obsahuje Orleans. Core.Abstractions.dll, která definuje Orleans veřejné typy, které jsou potřeba pro vývoj kódu aplikace (rozhraní a třídy zrnitosti). Tento balíček je potřeba přímo nebo nepřímo odkazovat na jakýkoli Orleans projekt. Přidejte ho do svých projektů, které definují rozhraní a třídy zrnitosti.
Orleans Generování kódu v čase sestavení
Microsoft.Orleans. OrleansCodeGenerator.Build.
Install-Package Microsoft.Orleans.OrleansCodeGenerator.BuildObjevil se ve Orleans verzi 1.2.0. Podpora doby sestavení pro obilná rozhraní a projekty implementace Přidejte ho do rozhraní a projektů implementace, abyste umožnili generování kódu odkazů na zrní a serializátory.
Microsoft.Orleans. CodeGenerator.MSBuild.
Install-Package Microsoft.Orleans.CodeGenerator.MSBuildZobrazí se jako součást verze Orleans 2.1.0. Alternativu k
Microsoft.Orleans.OrleansCodeGenerator.Buildbalíčku. Využívá Roslyn k analýze kódu, aby se zabránilo načítání binárních souborů aplikací a zlepšuje podporu přírůstkových sestavení, což by mělo vést k kratší době sestavení.
Orleans Serverové knihovny
Install-Package Microsoft.Orleans.Server
Metabal pro snadné sestavení a spuštění sila. Zahrnuje následující balíčky:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansRuntimeMicrosoft.Orleans.OrleansProviders
Orleans Klientské knihovny
Install-Package Microsoft.Orleans.Client
Metabalíč pro snadné sestavení a spuštění Orleans klienta (front-end). Zahrnuje následující balíčky:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansProviders
Orleans Základní knihovna
Install-Package Microsoft.Orleans.Core
Obsahuje implementaci pro většinu Orleans veřejných typů používaných kódem aplikace a Orleans klienty (front-endy). Odkazujte na ni pro vytváření knihoven a klientských aplikací, které používají Orleans typy, ale neřeší hostování nebo sila. Součástí Microsoftu.Orleans Klient a Microsoft.Orleans Metabalíky serveru, na které odkazuje většina ostatních balíčků přímo nebo nepřímo.
Hostování
Orleans Runtime
Install-Package Microsoft.Orleans.OrleansRuntime
Knihovna pro konfiguraci a spuštění sila Odkazujte na něj v hostitelském projektu sila. Součástí Microsoftu.Orleans Serverový metabal.
Orleans Abstrakce modulu runtime
Install-Package Microsoft.Orleans.Runtime.Abstractions
Obsahuje rozhraní a abstrakce pro typy implementované v Microsoft.Orleans.OrleansRuntime.
Orleans Hostování v Azure Cloud Services
Install-Package Microsoft.Orleans.Hosting.AzureCloudServices
Obsahuje pomocné třídy pro hostování sila a Orleans klientů jako Azure Cloud Services (role pracovních procesů a webové role).
Orleans Podpora hostování Service Fabric
Install-Package Microsoft.Orleans.Hosting.ServiceFabric
Obsahuje pomocné třídy pro hostování sila jako bezstavovou službu Service Fabric.
Poskytovatelé clusteringu
Následující balíčky zahrnují moduly plug-in pro zachování dat členství v clusteru v různých technologiích úložiště.
Orleans Poskytovatel clusteringu pro Azure Table Storage
Install-Package Microsoft.Orleans.Clustering.AzureStorage
Zahrnuje modul plug-in pro použití tabulek Azure pro ukládání dat členství v clusteru.
Orleans Poskytovatel clusteringu pro poskytovatele ADO.NET
Install-Package Microsoft.Orleans.Clustering.AdoNet
Zahrnuje modul plug-in pro použití ADO.NET pro ukládání dat členství v clusteru v jedné z podporovaných databází.
Orleans Nástroje consul
Install-Package Microsoft.Orleans.OrleansConsulUtils
Zahrnuje modul plug-in pro použití Consul pro ukládání dat členství v clusteru.
Orleans ZooKeeper Utilities
Install-Package Microsoft.Orleans.OrleansZooKeeperUtils
Zahrnuje modul plug-in pro použití ZooKeeper pro ukládání dat členství v clusteru.
Orleans Poskytovatel clusteringu pro AWS DynamoDB
Install-Package Microsoft.Orleans.Clustering.DynamoDB
Zahrnuje modul plug-in pro použití AWS DynamoDB pro ukládání dat členství v clusteru.
Zprostředkovatelé připomenutí
Následující balíčky zahrnují moduly plug-in pro zachování připomenutí v různých technologiích úložiště.
Orleans Připomenutí služby Azure Table Storage
Install-Package Microsoft.Orleans.Reminders.AzureStorage
Zahrnuje modul plug-in pro použití tabulek Azure k ukládání připomenutí.
Orleans Připomenutí ADO.NET zprostředkovatelé
Install-Package Microsoft.Orleans.Reminders.AdoNet
Zahrnuje modul plug-in pro použití ADO.NET pro ukládání připomenutí v některé z podporovaných databází.
Orleans zprostředkovatel připomenutí pro AWS DynamoDB
Install-Package Microsoft.Orleans.Reminders.DynamoDB
Zahrnuje modul plug-in pro použití AWS DynamoDB pro ukládání připomenutí.
Poskytovatelé úložiště odstupňovaného úložiště
Následující balíčky zahrnují moduly plug-in pro zachování stavu agregace v různých technologiích úložiště.
Orleans Trvalost služby Azure Storage
Install-Package Microsoft.Orleans.Persistence.AzureStorage
Zahrnuje moduly plug-in pro použití tabulek Azure nebo objektů blob Azure pro ukládání stavu agregace.
Orleans Zprostředkovatelé trvalosti ADO.NET
Install-Package Microsoft.Orleans.Persistence.AdoNet
Zahrnuje modul plug-in pro použití ADO.NET pro ukládání stavu agregace v některé z podporovaných databází.
Orleans Trvalost DynamoDB
Install-Package Microsoft.Orleans.Persistence.DynamoDB
Zahrnuje modul plug-in pro použití AWS DynamoDB pro ukládání stavu agregace.
Poskytovatelé streamu
Následující balíčky zahrnují moduly plug-in pro doručování událostí streamování.
Orleans Nástroje servicebusu
Install-Package Microsoft.Orleans.OrleansServiceBus
Zahrnuje zprostředkovatele streamu pro Službu Azure Event Hubs.
Orleans Streamování služby Azure Storage
Install-Package Microsoft.Orleans.Streaming.AzureStorage
Zahrnuje poskytovatele streamu pro fronty Azure.
Orleans Streamování AWS SQS
Install-Package Microsoft.Orleans.Streaming.SQS
Zahrnuje poskytovatele streamu pro službu AWS SQS.
Orleans Nástroje Google Cloud Platform
Install-Package Microsoft.Orleans.OrleansGCPUtils
Zahrnuje poskytovatele streamu pro službu GCP PubSub.
Další balíčky
Orleans Generování kódu
Install-Package Microsoft.Orleans.OrleansCodeGenerator
Zahrnuje generátor kódu za běhu.
Orleans Event-Sourcing
Install-Package Microsoft.Orleans.EventSourcing
Obsahuje sadu základních typů pro vytváření tříd agregace se stavem zdroje událostí.
Vývoj a testování
Orleans Poskytovatelů
Install-Package Microsoft.Orleans.OrleansProviders
Obsahuje sadu zprostředkovatelů trvalosti a datových proudů, které udržují data v paměti. Určeno pro testování. Obecně se nedoporučuje pro použití v produkčním prostředí, pokud není přijatelná ztráta dat v případě selhání sila.
Orleans Testování knihovny hostitelů
Install-Package Microsoft.Orleans.TestingHost
Zahrnuje knihovnu pro hostování sila a klientů v testovacím projektu.
Serializátory
Orleans Bond Serializer
Install-Package Microsoft.Orleans.Serialization.Bond
Zahrnuje podporu serializátoru Bond.
Orleans Nástroje Google
Install-Package Microsoft.Orleans.OrleansGoogleUtils
Obsahuje serializátor vyrovnávací paměti protokolu Google.
Orleans protobuf-net Serializer
Install-Package Microsoft.Orleans.ProtobufNet
Obsahuje protobuf-net verzi serializátoru vyrovnávací paměti protokolu.
Telemetrie
Orleans Příjemce telemetrie – Čítače výkonu
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters
Implementace rozhraní API telemetrie v čítačích výkonu Orleans Windows
OrleansPříjemce telemetrie – Aplikace Azure lication Insights
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI
Zahrnuje příjemce telemetrie pro Aplikace Azure lication Insights.
Orleans Příjemce telemetrie – NewRelic
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic
Zahrnuje příjemce telemetrie pro NewRelic.
Transakce
Orleans Podpora transakcí
Install-Package Microsoft.Orleans.Transactions
Zahrnuje podporu pro transakce křížového agregačního intervalu (beta verze).
Orleans Transakce v Azure
Install-Package Microsoft.Orleans.Transactions.AzureStorage
Zahrnuje modul plug-in pro zachování transakčního protokolu v Tabulce Azure (beta verze).
Nástroje
Orleans Nástroj Čítač výkonu
Install-Package Microsoft.Orleans.CounterControl
Zahrnuje OrleansCounterControl.exe, který registruje kategorie čítače výkonu Systému Windows pro Orleans statistiky a nasazené třídy grain. Vyžaduje zvýšení oprávnění. V Azure se dá spustit jako součást spouštěcí úlohy role.
