Orleans NuGet-paket
Konsumenter av Orleans förlitar sig på olika NuGet-paket för att uppnå specifika önskade beteenden. Det finns flera vanliga paket och abstraktioner, och många enskilda paket för enskilda ändamål. Den här artikeln innehåller insikter som hjälper utvecklare att lära sig vilka paket som Orleans ska användas.
Nyckelpaket
Du refererar till ett av två ömsesidigt uteslutande NuGet-paket när du skriver Orleans appar, beroende på den valda arbetsbelastningen. När du till exempel skriver en Orleans Silo refererar du till Microsoft.Orleans. Server NuGet-paket. När du skriver en Orleans klientapp refererar du till Microsoft.Orleans. NuGet-klientpaket . Alla Orleans projekt, till exempel abstraktioner eller kornklassbibliotek, refererar till Microsoft.Orleans. Sdk NuGet-paket. Paketet Microsoft.Orleans.Sdk ingår i både paketen Client och Server .
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. Klient | Klientexkluderande paket som krävs för Orleans klienten. |
| Microsoft.Orleans. Sdk | Metapaket som krävs av alla Orleans appar, server- och klientpaket är beroende av det här paketet. |
| Microsoft.Orleans. Server | Serverexklusivt paket som krävs för Orleans silor. |
Information om hur du installerar NuGet-paket finns i följande alternativ:
Värd
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. Hosting.AzureCloudServices | Värdtjänster för Azure Cloud Services i Orleans. |
| Microsoft.Orleans. Hosting.Kubernetes | Orleans värdstöd för Kubernetes. |
| Microsoft.Orleans. Runtime | Core Runtime-biblioteket Orleans för som är värd för och kör korn i en silo. |
Klustringsprovidrar
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. Clustering.AzureStorage | Orleans klusterprovider som backas upp av Azure Table Storage. |
| Microsoft.Orleans. Clustering.AdoNet | Orleans klusterprovider som backas upp av ADO.NET. |
| Microsoft.Orleans. Clustering.DynamoDB | Orleans klusterprovider som backas upp av AWS DynamoDB. |
Påminnelseleverantörer
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. Påminnelser | Påminnelsebibliotek för Microsoft Orleans som används på servern. |
| Microsoft.Orleans. Reminders.AzureStorage | Orleans påminnelser som backas upp av Azure Table Storage. |
| Microsoft.Orleans. Reminders.AdoNet | Orleans påminnelser som backas upp av ADO.NET. |
| Microsoft.Orleans. Reminders.DynamoDB | Orleans påminnelser som backas upp av AWS DynamoDB. |
Lagringsproviders för korn
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. Persistence.AdoNet | Orleans beständighetsprovider som backas upp av ADO.NET. |
| Microsoft.Orleans. Persistence.AzureStorage | Orleans persistence-provider som backas upp av Azure Table Storage. |
| Microsoft.Orleans. Persistence.DynamoDB | Orleans persistence provider som backas upp av AWS DynamoDB. |
| Microsoft.Orleans. Persistence.Memory | Minnesintern lagring för Orleans. |
Stream-leverantörer
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. Direktuppspelning | Direktuppspelningsbibliotek för Orleans både klient och server. |
| Microsoft.Orleans. Streaming.AzureStorage | Orleans strömningsprovider som backas upp av Azure Queue Storage. |
| Microsoft.Orleans. Streaming.EventHubs | Orleans strömningsprovider som backas upp av Azure Event Hubs. |
| Microsoft.Orleans. Streaming.SQS | Orleans strömningsprovider som backas upp av AWS SQS. |
Ytterligare paket
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. Analysatorer | C# Analyzeers för Orleans. |
| Microsoft.Orleans. CodeGenerator | Kodgenereringsbibliotek för Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. EventSourcing | Bastyper för att skapa Orleans korn med händelsekällans tillstånd. |
| Microsoft.Orleans. Connections.Security | Stöd för säkerhetskommunikation med TLS i Orleans. |
Utveckling och testning
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. TestingHost | Orleans bibliotek för att vara värd för en silo i ett testprojekt. |
| Microsoft.Orleans. Transactions.TestKit.Base | Test kit-basbibliotek för transaktioner. |
| Microsoft.Orleans. Transactions.TestKit.xUnit | xUnit test kit-bibliotek för transaktioner. |
| Microsoft.Orleans. Serialization.TestKit | Testpaket för projekt med .Microsoft.Orleans.Serialization |
Serialiserare
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. Serialisering | Snabb, flexibel och versionstolerant serialiserare för .NET. |
| Microsoft.Orleans. Serialization.Abstractions | Serialiseringsabstraktioner för Orleans. |
| Microsoft.Orleans. Serialization.SystemTextJson | System.Text.Json integrering för Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialization.FSharp | Stöd för F#-kärntyp för Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialization.NewtonsoftJson | Newtonsoft.Json integrering för Microsoft.Orleans.Serialization. |
Transaktioner
| NuGet-paket | beskrivning |
|---|---|
| Microsoft.Orleans. Transaktioner | Kärntransaktionsbibliotek Orleans för som används på servern. |
| Microsoft.Orleans. Transactions.AzureStorage | Orleans transaktionslagringsprovider som backas upp av Azure Storage. |
Verktyg
Ett populärt Orleans verktyg är OrleansDashboard NuGet-paketet. Den här instrumentpanelen innehåller några enkla mått och insikter om vad som händer i din Orleans app. Mer information finns i GitHub: Orleans Instrumentpanel.
Nyckelpaket
Det finns 5 viktiga NuGet-paket som du behöver använda i de flesta scenarier:
Orleans Kärnabstraktioner
Install-Package Microsoft.Orleans.Core.Abstractions
Innehåller Orleans. Core.Abstractions.dll, som definierar Orleans offentliga typer som behövs för att utveckla programkod (korngränssnitt och klasser). Det här paketet måste refereras direkt eller indirekt av alla Orleans projekt. Lägg till den i dina projekt som definierar korngränssnitt och klasser.
Orleans build-time-kodgenerering
Microsoft.Orleans. OrleansCodeGenerator.Build.
Install-Package Microsoft.Orleans.OrleansCodeGenerator.BuildVisades i Orleans 1.2.0. Byggtidsstöd för korngränssnitt och implementeringsprojekt. Lägg till den i dina korngränssnitt och implementeringsprojekt för att aktivera kodgenerering av kornreferenser och serialiserare.
Microsoft.Orleans. CodeGenerator.MSBuild.
Install-Package Microsoft.Orleans.CodeGenerator.MSBuildVisades som en del av Orleans 2.1.0. Ett alternativ till paketet
Microsoft.Orleans.OrleansCodeGenerator.Build. Använder Roslyn för kodanalys för att undvika inläsning av programbinärfiler och förbättrar stödet för inkrementella versioner, vilket bör resultera i kortare byggtider.
Orleans Serverbibliotek
Install-Package Microsoft.Orleans.Server
Ett metapaket för att enkelt skapa och starta en silo. Innehåller följande paket:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansRuntimeMicrosoft.Orleans.OrleansProviders
Orleans Klientbibliotek
Install-Package Microsoft.Orleans.Client
Ett metapaket för att enkelt skapa och starta en Orleans klient (klientdel). Innehåller följande paket:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansProviders
Orleans Kärnbibliotek
Install-Package Microsoft.Orleans.Core
Innehåller implementering för de flesta Orleans offentliga typer som används av programkod och Orleans klienter (klientdelar). Referera till den för att skapa bibliotek och klientprogram som använder Orleans typer men inte hanterar värd- eller silor. Ingår i Microsoft.Orleans. Klient och Microsoft.Orleans. Servermeta-paket och refereras direkt eller indirekt av de flesta andra paket.
Värd
Orleans Runtime
Install-Package Microsoft.Orleans.OrleansRuntime
Bibliotek för att konfigurera och starta en silo. Referera till det i silovärdprojektet. Ingår i Microsoft.Orleans. Serverns metapaket.
Orleans Körningsabstraktioner
Install-Package Microsoft.Orleans.Runtime.Abstractions
Innehåller gränssnitt och abstraktioner för typer som implementeras i Microsoft.Orleans.OrleansRuntime.
Orleans Värdtjänster i Azure Cloud Services
Install-Package Microsoft.Orleans.Hosting.AzureCloudServices
Innehåller hjälpklasser för att vara värd för silor och Orleans klienter som Azure Cloud Services (arbetsroller och webbroller).
Orleans Service Fabric-värdsupport
Install-Package Microsoft.Orleans.Hosting.ServiceFabric
Innehåller hjälpklasser för att vara värd för silor som en tillståndslös Service Fabric-tjänst.
Klustringsprovidrar
Paketen nedan innehåller plugin-program för att bevara klustermedlemskapsdata i olika lagringstekniker.
Orleans klusterprovider för Azure Table Storages
Install-Package Microsoft.Orleans.Clustering.AzureStorage
Innehåller plugin-programmet för att använda Azure-tabeller för att lagra klustermedlemskapsdata.
Orleans klusterprovider för ADO.NET providers
Install-Package Microsoft.Orleans.Clustering.AdoNet
Innehåller plugin-programmet för att använda ADO.NET för att lagra klustermedlemskapsdata i en av de databaser som stöds.
Orleans Consul Utilities
Install-Package Microsoft.Orleans.OrleansConsulUtils
Innehåller plugin-programmet för att använda Consul för att lagra klustermedlemskapsdata.
Orleans ZooKeeper-verktyg
Install-Package Microsoft.Orleans.OrleansZooKeeperUtils
Innehåller plugin-programmet för att använda ZooKeeper för att lagra klustermedlemskapsdata.
Orleans klusterprovider för AWS DynamoDB
Install-Package Microsoft.Orleans.Clustering.DynamoDB
Innehåller plugin-programmet för att använda AWS DynamoDB för lagring av klustermedlemskapsdata.
Påminnelseleverantörer
Paketen nedan innehåller plugin-program för att bevara påminnelser i olika lagringstekniker.
Orleans Påminnelser om Azure Table Storage
Install-Package Microsoft.Orleans.Reminders.AzureStorage
Innehåller plugin-programmet för att använda Azure-tabeller för lagring av påminnelser.
Orleans Påminnelser ADO.NET providers
Install-Package Microsoft.Orleans.Reminders.AdoNet
Innehåller plugin-programmet för att använda ADO.NET för att lagra påminnelser i en av de databaser som stöds.
Orleans påminnelseprovider för AWS DynamoDB
Install-Package Microsoft.Orleans.Reminders.DynamoDB
Innehåller plugin-programmet för att använda AWS DynamoDB för lagring av påminnelser.
Lagringsproviders för korn
Paketen nedan innehåller plugin-program för att bevara korntillstånd i olika lagringstekniker.
Orleans Beständig Azure Storage
Install-Package Microsoft.Orleans.Persistence.AzureStorage
Innehåller plugin-program för att använda Azure-tabeller eller Azure-blobbar för lagring av korntillstånd.
Orleans Leverantörer av beständighet ADO.NET
Install-Package Microsoft.Orleans.Persistence.AdoNet
Innehåller plugin-programmet för att använda ADO.NET för lagring av korntillstånd i en av de databaser som stöds.
Orleans Persistence DynamoDB
Install-Package Microsoft.Orleans.Persistence.DynamoDB
Innehåller plugin-programmet för att använda AWS DynamoDB för lagring av korntillstånd.
Stream-leverantörer
Paketen nedan innehåller plugin-program för att leverera strömmande händelser.
Orleans ServiceBus-verktyg
Install-Package Microsoft.Orleans.OrleansServiceBus
Innehåller stream-providern för Azure Event Hubs.
Orleans Strömma Azure Storage
Install-Package Microsoft.Orleans.Streaming.AzureStorage
Innehåller stream-providern för Azure Queues.
Orleans Strömmande AWS-kvm
Install-Package Microsoft.Orleans.Streaming.SQS
Innehåller stream-providern för AWS SQS-tjänsten.
Orleans Verktyg för Google Cloud Platform
Install-Package Microsoft.Orleans.OrleansGCPUtils
Innehåller stream-providern för GCP PubSub-tjänsten.
Ytterligare paket
Orleans Kodgenerering
Install-Package Microsoft.Orleans.OrleansCodeGenerator
Innehåller körningskodgeneratorn.
Orleans Händelsekällor
Install-Package Microsoft.Orleans.EventSourcing
Innehåller en uppsättning bastyper för att skapa kornklasser med händelsekällans tillstånd.
Utveckling och testning
Orleans Leverantörer
Install-Package Microsoft.Orleans.OrleansProviders
Innehåller en uppsättning beständighets- och strömprovidrar som håller data i minnet. Avsedd för testning. I allmänhet rekommenderas inte för produktionsanvändning, såvida inte dataförlust i händelse av ett silofel är acceptabelt.
Orleans Testa värdbibliotek
Install-Package Microsoft.Orleans.TestingHost
Innehåller biblioteket för att vara värd för silor och klienter i ett testprojekt.
Serialiserare
Orleans Bond Serializer
Install-Package Microsoft.Orleans.Serialization.Bond
Innehåller stöd för Bond-serialiserare.
Orleans Google Utilities
Install-Package Microsoft.Orleans.OrleansGoogleUtils
Innehåller Serialiserare för Google Protocol Buffers.
Orleans protobuf-net Serializer
Install-Package Microsoft.Orleans.ProtobufNet
Innehåller protobuf-net-versionen av Protocol Buffers serializer.
Telemetri
Orleans Telemetrikonsument – prestandaräknare
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters
Implementering av Orleans Telemetri-API för Prestandaräknare i Windows.
Orleans Telemetrikonsument – Azure Application Insights
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI
Innehåller telemetrikonsumenten för Azure Application Insights.
Orleans Telemetrikonsument – NewRelic
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic
Innehåller telemetrikonsumenten för NewRelic.
Transaktioner
Orleans Stöd för transaktioner
Install-Package Microsoft.Orleans.Transactions
Innehåller stöd för korsande transaktioner (beta).
Orleans Transaktioner i Azure
Install-Package Microsoft.Orleans.Transactions.AzureStorage
Innehåller ett plugin-program för att bevara transaktionsloggen i Azure Table (beta).
Verktyg
Orleans Verktyg för prestandaräknare
Install-Package Microsoft.Orleans.CounterControl
Innehåller OrleansCounterControl.exe, som registrerar Windows prestandaräknare kategorier för Orleans statistik och för distribuerade kornklasser. Kräver utökade privilegier. Kan köras i Azure som en del av en rollstartuppgift.
