Dela via

Orleans NuGet-paket

  • Artikel

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. Streaming 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. Anslut. Säkerhet 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. Serialization 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 NuGet-paketet för Orleansinstrumentpanelen . 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.Build

    Visades 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.MSBuild

    Visades 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.Abstractions
  • Microsoft.Orleans.Core
  • Microsoft.Orleans.OrleansRuntime
  • Microsoft.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.Abstractions
  • Microsoft.Orleans.Core
  • Microsoft.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.