Orleans NuGet-pakketten
Consumenten vertrouwen Orleans op verschillende NuGet-pakketten om specifiek gewenst gedrag te bereiken. Er zijn verschillende algemene pakketten en abstracties, en veel afzonderlijke pakketten met één doel. Dit artikel bevat inzichten om ontwikkelaars te helpen te leren welke Orleans pakketten moeten worden gebruikt.
Sleutelpakketten
U verwijst naar een van de twee wederzijds exclusieve NuGet-pakketten bij het schrijven Orleans van apps, afhankelijk van de gekozen workload. Wanneer u bijvoorbeeld een Orleans silo schrijft, verwijst u naar Microsoft .Orleans. Server NuGet-pakket. Wanneer u een Orleans client-app schrijft, verwijst u naar Microsoft .Orleans. Client NuGet-pakket. Alle Orleans projecten, zoals abstracties of graanklassebibliotheken, verwijzen naar Microsoft .Orleans. Sdk NuGet-pakket. Het Microsoft.Orleans.Sdk pakket is opgenomen in zowel de als Server de Client pakketten.
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. Klant | Client-exclusief pakket, vereist voor Orleans client. |
| Microsoft.Orleans. Sdk | Metapackage vereist voor alle Orleans apps, server- en clientpakketten is afhankelijk van dit pakket. |
| Microsoft.Orleans. Server | Server-exclusief pakket, vereist voor Orleans silo's. |
Zie de volgende opties voor informatie over het installeren van NuGet-pakketten:
Hosting
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. Hosting.AzureCloudServices | Hostinghulpprogramma's voor Azure Cloud Services van Orleans. |
| Microsoft.Orleans. Hosting.Kubernetes | Orleans hostingondersteuning voor Kubernetes. |
| Microsoft.Orleans. Runtime | Kernruntimebibliotheek van Orleans die host en voert korrels uit binnen een silo. |
Clusteringproviders
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. Clustering.AzureStorage | Orleans clusteringprovider ondersteund door Azure Table Storage. |
| Microsoft.Orleans. Clustering.AdoNet | Orleans clusteringprovider ondersteund door ADO.NET. |
| Microsoft.Orleans. Clustering.DynamoDB | Orleans clusteringprovider ondersteund door AWS DynamoDB. |
Herinneringsproviders
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. Herinneringen | Herinneringsbibliotheek voor Microsoft Orleans die op de server wordt gebruikt. |
| Microsoft.Orleans. Herinneringen.AzureStorage | Orleans herinneringenprovider die wordt ondersteund door Azure Table Storage. |
| Microsoft.Orleans. Herinneringen.AdoNet | Orleans herinneringenprovider ondersteund door ADO.NET. |
| Microsoft.Orleans. Herinneringen.DynamoDB | Orleans herinneringenprovider ondersteund door AWS DynamoDB. |
Graanopslagproviders
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. Persistence.AdoNet | Orleans persistentieprovider ondersteund door ADO.NET. |
| Microsoft.Orleans. Persistence.AzureStorage | Orleans persistentieprovider ondersteund door Azure Table Storage. |
| Microsoft.Orleans. Persistence.DynamoDB | Orleans persistentieprovider ondersteund door AWS DynamoDB. |
| Microsoft.Orleans. Persistence.Memory | In-memory opslag voor Orleans. |
Stream-providers
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. Streaming | Streamingbibliotheek voor Orleans gebruik op zowel de client als de server. |
| Microsoft.Orleans. Streaming.AzureStorage | Orleans streamingprovider ondersteund door Azure Queue Storage. |
| Microsoft.Orleans. Streaming.EventHubs | Orleans streamingprovider ondersteund door Azure Event Hubs. |
| Microsoft.Orleans. Streaming.SQS | Orleans streamingprovider ondersteund door AWS SQS. |
Aanvullende pakketten
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. Analyzers | C# Analyzers voor Orleans. |
| Microsoft.Orleans. CodeGenerator | Bibliotheek voor het genereren van code voor Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. EventSourcing | Basistypen voor het maken van Orleans korrels met een gebeurtenisbronstatus. |
| Microsoft.Orleans. Connections.Security | Ondersteuning voor beveiligingscommunicatie met behulp van TLS in Orleans. |
Ontwikkelen en testen
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. TestingHost | Orleans bibliotheek voor het hosten van een silo in een testproject. |
| Microsoft.Orleans. Transactions.TestKit.Base | Test kit basisbibliotheek voor transacties. |
| Microsoft.Orleans. Transactions.TestKit.xUnit | xUnit-testkitbibliotheek voor transacties. |
| Microsoft.Orleans. Serialisatie.TestKit | Testkit voor projecten met behulp van Microsoft.Orleans.Serialization. |
Serializers
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. Serialisatie | Snelle, flexibele en versietolerante serializer voor .NET. |
| Microsoft.Orleans. Serialisatie.Abstracties | Serialisatieabstracties voor Orleans. |
| Microsoft.Orleans. Serialization.SystemTextJson | System.Text.Json integratie voor Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialisatie.FSharp | Ondersteuning voor F#-kerntype voor Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialisatie.NewtonsoftJson | Newtonsoft.Json integratie voor Microsoft.Orleans.Serialization. |
Transacties
| NuGet-pakket | Beschrijving |
|---|---|
| Microsoft.Orleans. Transacties | Kerntransactiebibliotheek die Orleans op de server wordt gebruikt. |
| Microsoft.Orleans. Transactions.AzureStorage | Orleans transactieopslagprovider ondersteund door Azure Storage. |
Hulpprogramma's
Een populair Orleans hulpprogramma is het NuGet-pakket OrleansDashboard . Dit dashboard biedt enkele eenvoudige metrische gegevens en inzicht in wat er in uw Orleans app gebeurt. Zie GitHub: Orleans Dashboard voor meer informatie.
Sleutelpakketten
Er zijn vijf belangrijke NuGet-pakketten die u in de meeste scenario's moet gebruiken:
Orleans Kernabstracties
Install-Package Microsoft.Orleans.Core.Abstractions
Bevat Orleans. Core.Abstractions.dll, waarmee openbare typen worden gedefinieerd Orleans die nodig zijn voor het ontwikkelen van toepassingscode (graaninterfaces en klassen). Dit pakket moet direct of indirect worden verwezen door een Orleans project. Voeg deze toe aan uw projecten waarmee graaninterfaces en klassen worden gedefinieerd.
Orleans build-time code genereren
Microsoft.Orleans. OrleansCodeGenerator.Build.
Install-Package Microsoft.Orleans.OrleansCodeGenerator.BuildVerschenen in Orleans 1.2.0. Bouw tijdondersteuning voor graaninterfaces en implementatieprojecten. Voeg deze toe aan uw graaninterfaces en implementatieprojecten om het genereren van korrelverwijzingen en serialisatiemiddelen mogelijk te maken.
Microsoft.Orleans. CodeGenerator.MSBuild.
Install-Package Microsoft.Orleans.CodeGenerator.MSBuildVerschenen als onderdeel van Orleans 2.1.0. Een alternatief voor het
Microsoft.Orleans.OrleansCodeGenerator.Buildpakket. Maakt gebruik van Roslyn voor codeanalyse om binaire toepassingsbestanden te voorkomen en verbetert de ondersteuning voor incrementele builds, wat leidt tot kortere buildtijden.
Orleans Serverbibliotheken
Install-Package Microsoft.Orleans.Server
Een metapakket voor het eenvoudig bouwen en starten van een silo. Bevat de volgende pakketten:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansRuntimeMicrosoft.Orleans.OrleansProviders
Orleans Clientbibliotheken
Install-Package Microsoft.Orleans.Client
Een metapakket voor het eenvoudig bouwen en starten van een Orleans client (front-end). Bevat de volgende pakketten:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansProviders
Orleans Kernbibliotheek
Install-Package Microsoft.Orleans.Core
Bevat implementatie voor de meeste Orleans openbare typen die worden gebruikt door toepassingscode en Orleans -clients (front-ends). Raadpleeg deze voor het bouwen van bibliotheken en clienttoepassingen die gebruikmaken van Orleans typen, maar die niet te maken hebben met hosting of silo's. Opgenomen in Microsoft.Orleans. Client en Microsoft.Orleans. Servermetapakketten en wordt direct of indirect verwezen naar de meeste andere pakketten.
Hosting
Orleans Runtime
Install-Package Microsoft.Orleans.OrleansRuntime
Bibliotheek voor het configureren en starten van een silo. Verwijs ernaar in uw silohostproject. Opgenomen in Microsoft.Orleans. Servermetapakket.
Orleans Runtimeabstracties
Install-Package Microsoft.Orleans.Runtime.Abstractions
Bevat interfaces en abstracties voor typen die zijn geïmplementeerd in Microsoft.Orleans.OrleansRuntime.
Orleans Hosting op Azure Cloud Services
Install-Package Microsoft.Orleans.Hosting.AzureCloudServices
Bevat helperklassen voor het hosten van silo's en Orleans clients als Azure Cloud Services (Werkrollen en webrollen).
Orleans Ondersteuning voor Service Fabric-hosting
Install-Package Microsoft.Orleans.Hosting.ServiceFabric
Bevat helperklassen voor het hosten van silo's als stateless Service Fabric-service.
Clusteringproviders
De onderstaande pakketten bevatten invoegtoepassingen voor het persistent maken van clusterlidmaatschapsgegevens in verschillende opslagtechnologieën.
Orleans clusteringprovider voor Azure Table Storages
Install-Package Microsoft.Orleans.Clustering.AzureStorage
Bevat de invoegtoepassing voor het gebruik van Azure Tables voor het opslaan van clusterlidmaatschapsgegevens.
Orleans clusteringprovider voor ADO.NET-providers
Install-Package Microsoft.Orleans.Clustering.AdoNet
Bevat de invoegtoepassing voor het gebruik van ADO.NET voor het opslaan van clusterlidmaatschapsgegevens in een van de ondersteunde databases.
Orleans Consul Utilities
Install-Package Microsoft.Orleans.OrleansConsulUtils
Bevat de invoegtoepassing voor het gebruik van Consul voor het opslaan van clusterlidmaatschapsgegevens.
Orleans ZooKeeper Utilities
Install-Package Microsoft.Orleans.OrleansZooKeeperUtils
Bevat de invoegtoepassing voor het gebruik van ZooKeeper voor het opslaan van clusterlidmaatschapsgegevens.
Orleans clusteringprovider voor AWS DynamoDB
Install-Package Microsoft.Orleans.Clustering.DynamoDB
Bevat de invoegtoepassing voor het gebruik van AWS DynamoDB voor het opslaan van clusterlidmaatschapsgegevens.
Herinneringsproviders
De onderstaande pakketten bevatten invoegtoepassingen voor het persistent maken van herinneringen in verschillende opslagtechnologieën.
Orleans Herinneringen voor Azure Table Storage
Install-Package Microsoft.Orleans.Reminders.AzureStorage
Bevat de invoegtoepassing voor het gebruik van Azure Tables voor het opslaan van herinneringen.
Orleans Herinneringen ADO.NET Providers
Install-Package Microsoft.Orleans.Reminders.AdoNet
Bevat de invoegtoepassing voor het gebruik van ADO.NET voor het opslaan van herinneringen in een van de ondersteunde databases.
Orleans herinneringenprovider voor AWS DynamoDB
Install-Package Microsoft.Orleans.Reminders.DynamoDB
Bevat de invoegtoepassing voor het gebruik van AWS DynamoDB voor het opslaan van herinneringen.
Graanopslagproviders
De onderstaande pakketten bevatten invoegtoepassingen voor persistente graanstatus in verschillende opslagtechnologieën.
Orleans Persistentie van Azure Storage
Install-Package Microsoft.Orleans.Persistence.AzureStorage
Bevat de invoegtoepassingen voor het gebruik van Azure Tables of Azure Blobs voor het opslaan van de graanstatus.
Orleans Persistentie ADO.NET Providers
Install-Package Microsoft.Orleans.Persistence.AdoNet
Bevat de invoegtoepassing voor het gebruik van ADO.NET voor het opslaan van de graanstatus in een van de ondersteunde databases.
Orleans Persistentie DynamoDB
Install-Package Microsoft.Orleans.Persistence.DynamoDB
Bevat de invoegtoepassing voor het gebruik van AWS DynamoDB voor het opslaan van de graanstatus.
Stream-providers
De onderstaande pakketten bevatten invoegtoepassingen voor het leveren van streaming-gebeurtenissen.
Orleans ServiceBus-hulpprogramma's
Install-Package Microsoft.Orleans.OrleansServiceBus
Bevat de streamprovider voor Azure Event Hubs.
Orleans Azure Storage streamen
Install-Package Microsoft.Orleans.Streaming.AzureStorage
Bevat de streamprovider voor Azure Queues.
Orleans AWS SQS streamen
Install-Package Microsoft.Orleans.Streaming.SQS
Bevat de streamprovider voor de AWS SQS-service.
Orleans Google Cloud Platform-hulpprogramma's
Install-Package Microsoft.Orleans.OrleansGCPUtils
Bevat de streamprovider voor de GCP PubSub-service.
Aanvullende pakketten
Orleans Codegeneratie
Install-Package Microsoft.Orleans.OrleansCodeGenerator
Bevat de runtime-codegenerator.
Orleans Gebeurtenisbronnen
Install-Package Microsoft.Orleans.EventSourcing
Bevat een set basistypen voor het maken van graanklassen met een gebeurtenisbronstatus.
Ontwikkelen en testen
Orleans Providers
Install-Package Microsoft.Orleans.OrleansProviders
Bevat een set persistentie- en streamproviders die gegevens in het geheugen bewaren. Bedoeld voor testen. Over het algemeen wordt niet aanbevolen voor productiegebruik, tenzij gegevensverlies in geval van een silofout acceptabel is.
Orleans Hostbibliotheek testen
Install-Package Microsoft.Orleans.TestingHost
Bevat de bibliotheek voor het hosten van silo's en clients in een testproject.
Serializers
Orleans Bond Serializer
Install-Package Microsoft.Orleans.Serialization.Bond
Bevat ondersteuning voor Bond-serializer.
Orleans Google Utilities
Install-Package Microsoft.Orleans.OrleansGoogleUtils
Bevat serialisatiefunctie voor Google Protocol Buffers.
Orleans protobuf-net Serializer
Install-Package Microsoft.Orleans.ProtobufNet
Bevat protobuf-net-versie van protocolbuffers serializer.
Telemetrie
Orleans Telemetrieconsumer - Prestatiemeteritems
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters
Implementatie van Telemetrie-API voor Orleans Windows-prestatiemeteritems.
OrleansTelemetrieconsumer - Azure-toepassing Insights
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI
Bevat de telemetrieconsumer voor Azure-toepassing Insights.
Orleans Telemetrieconsumer - NewRelic
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic
Bevat de telemetrieconsumer voor NewRelic.
Transacties
Orleans Ondersteuning voor transacties
Install-Package Microsoft.Orleans.Transactions
Bevat ondersteuning voor kruislingse transacties (bèta).
Orleans Transacties in Azure
Install-Package Microsoft.Orleans.Transactions.AzureStorage
Bevat een invoegtoepassing voor het persistent maken van transactielogboeken in Azure Table (bèta).
Hulpprogramma's
Orleans Hulpprogramma prestatiemeteritems
Install-Package Microsoft.Orleans.CounterControl
Bevat OrleansCounterControl.exe, waarmee Windows-prestatiemeteritemscategorieën worden geregistreerd voor Orleans statistieken en voor geïmplementeerde graanklassen. Hiervoor is uitbreiding vereist. Kan in Azure worden uitgevoerd als onderdeel van een opstarttaak voor rollen.
