Udostępnij za pośrednictwem

Orleans Pakiety NuGet

  • Artykuł

Konsumenci polegają Orleans na różnych pakietach NuGet, aby osiągnąć określone żądane zachowania. Istnieje kilka typowych pakietów i abstrakcji oraz wiele pojedynczych pakietów przeznaczenia. Ten artykuł zawiera szczegółowe informacje ułatwiające deweloperom poznanie, które Orleans pakiety powinny być używane.

Pakiety kluczy

Podczas pisania Orleans aplikacji odwołujesz się do jednego z dwóch wzajemnie wykluczających się pakietów NuGet, w zależności od wybranego obciążenia. Na przykład podczas pisania Orleans silosu będziesz odwoływać się do elementu Microsoft.Orleans. Pakiet NuGet serwera . Podczas pisania aplikacji klienckiej Orleans będziesz odwoływać się do aplikacji Microsoft.Orleans. Pakiet NuGet klienta . Wszystkie Orleans projekty, takie jak abstrakcje lub biblioteki klas ziarna, odwołują się do microsoft .Orleans. Pakiet NuGet zestawu SDK . Pakiet Microsoft.Orleans.Sdk jest dołączany zarówno do pakietów , jak Client i Server .

Pakiet NuGet opis
Microsoft.Orleans. Klient Pakiet na wyłączność klienta, wymagany dla Orleans klienta.
Microsoft.Orleans. Zestaw SDK Metapakiet wymagany przez wszystkie Orleans aplikacje, serwery i pakiety klienckie zależą od tego pakietu.
Microsoft.Orleans. Serwer Pakiet z wyłącznym serwerem wymagany dla silosów Orleans .

Aby uzyskać informacje na temat instalowania pakietów NuGet, zobacz następujące opcje:

Hosting

Pakiet NuGet opis
Microsoft.Orleans. Hosting.AzureCloudServices Hostowanie narzędzi dla usług Azure Cloud Services of Orleans.
Microsoft.Orleans. Hosting.Kubernetes Orleans obsługa hostingu dla platformy Kubernetes.
Microsoft.Orleans. Środowiska wykonawczego Podstawowa biblioteka środowiska uruchomieniowego Orleans tego hosta i wykonuje ziarna w silosie.

Dostawcy klastrowania

Pakiet NuGet opis
Microsoft.Orleans. Clustering.AzureStorage Orleans dostawca klastrowania wspierany przez usługę Azure Table Storage.
Microsoft.Orleans. Clustering.AdoNet Orleans dostawca klastrowania wspierany przez ADO.NET.
Microsoft.Orleans. Clustering.DynamoDB Orleans dostawca klastrowania wspierany przez usługę AWS DynamoDB.

Dostawcy przypomnień

Pakiet NuGet opis
Microsoft.Orleans. Przypomnienia Biblioteka przypomnień dla firmy Microsoft Orleans używana na serwerze.
Microsoft.Orleans. Reminders.AzureStorage Orleans dostawca przypomnień wspierany przez usługę Azure Table Storage.
Microsoft.Orleans. Reminders.AdoNet Orleans dostawca przypomnień wspierany przez ADO.NET.
Microsoft.Orleans. Reminders.DynamoDB Orleans dostawca przypomnień wspierany przez usługę AWS DynamoDB.

Dostawcy magazynu ziarna

Pakiet NuGet opis
Microsoft.Orleans. Persistence.AdoNet Orleans dostawca trwałości wspierany przez ADO.NET.
Microsoft.Orleans. Trwałość.AzureStorage Orleans dostawca trwałości wspierany przez usługę Azure Table Storage.
Microsoft.Orleans. Trwałość.DynamoDB Orleans dostawca trwałości wspierany przez usługę AWS DynamoDB.
Microsoft.Orleans. Trwałość.Pamięć Magazyn w pamięci dla programu Orleans.

Dostawcy usługi Stream

Pakiet NuGet opis
Microsoft.Orleans. Przesyłanie strumieniowe Biblioteka przesyłania strumieniowego używana Orleans zarówno na kliencie, jak i serwerze.
Microsoft.Orleans. Streaming.AzureStorage Orleans dostawca przesyłania strumieniowego wspierany przez usługę Azure Queue Storage.
Microsoft.Orleans. Streaming.EventHubs Orleans dostawca przesyłania strumieniowego wspierany przez usługę Azure Event Hubs.
Microsoft.Orleans. Streaming.SQS Orleans dostawca przesyłania strumieniowego wspierany przez platformę AWS SQS.

Dodatkowe pakiety

Pakiet NuGet opis
Microsoft.Orleans. Analizatory Analizatory języka C# dla programu Orleans.
Microsoft.Orleans. CodeGenerator Biblioteka generowania kodu dla elementu Microsoft.Orleans.Serialization.
Microsoft.Orleans. EventSourcing Typy podstawowe do tworzenia Orleans ziarna ze stanem źródła zdarzeń.
Microsoft.Orleans. Connections.Security Obsługa komunikacji zabezpieczeń przy użyciu protokołu TLS w systemie Orleans.

Tworzenie i testowanie

Pakiet NuGet opis
Microsoft.Orleans. TestingHost Orleans biblioteka do hostowania silosu w projekcie testowym.
Microsoft.Orleans. Transactions.TestKit.Base Biblioteka podstawowa zestawu testowego dla transakcji.
Microsoft.Orleans. Transactions.TestKit.xUnit Biblioteka zestawów testowych xUnit dla transakcji.
Microsoft.Orleans. Serialization.TestKit Zestaw testowy dla projektów korzystających z programu Microsoft.Orleans.Serialization.

Serializatory

Pakiet NuGet opis
Microsoft.Orleans. Szeregowanie Szybki, elastyczny i odporny na wersje serializator dla platformy .NET.
Microsoft.Orleans. Serializacja.Abstrakcje Abstrakcje serializacji dla elementu Orleans.
Microsoft.Orleans. Serialization.SystemTextJson System.Text.Json integracja dla programu Microsoft.Orleans.Serialization.
Microsoft.Orleans. Serializacja.FSharp Obsługa typów rdzeni języka F# dla elementu Microsoft.Orleans.Serialization.
Microsoft.Orleans. Serialization.NewtonsoftJson Newtonsoft.Json integracja dla programu Microsoft.Orleans.Serialization.

Transakcje

Pakiet NuGet opis
Microsoft.Orleans. Transakcji Podstawowa biblioteka transakcji Orleans używana na serwerze.
Microsoft.Orleans. Transactions.AzureStorage Orleans dostawca magazynu transakcji wspierany przez usługę Azure Storage.

Narzędzia

Jednym z popularnych Orleans narzędzi jest pakiet NuGet OrleansDashboard . Ten pulpit nawigacyjny udostępnia proste metryki i szczegółowe informacje o tym, co dzieje się w aplikacji Orleans . Aby uzyskać więcej informacji, zobacz GitHub: Orleans Pulpit nawigacyjny.

Pakiety kluczy

Istnieją 5 kluczowych pakietów NuGet, których należy użyć w większości scenariuszy:

Orleans Abstrakcje rdzeni

Install-Package Microsoft.Orleans.Core.Abstractions

Zawiera Orleans. Core.Abstractions.dll, który definiuje Orleans typy publiczne potrzebne do tworzenia kodu aplikacji (interfejsy ziarna i klasy). Ten pakiet musi być bezpośrednio lub pośrednio przywołyny przez dowolny Orleans projekt. Dodaj go do projektów, które definiują interfejsy i klasy ziarna.

Orleans generowanie kodu w czasie kompilacji

  • Microsoft.Orleans. OrleansCodeGenerator.Build.

    Install-Package Microsoft.Orleans.OrleansCodeGenerator.Build

    Pojawił się w Orleans wersji 1.2.0. Obsługa czasu kompilacji dla interfejsów ziarna i projektów implementacji. Dodaj go do interfejsów ziarna i projektów implementacji, aby umożliwić generowanie kodu odwołań ziarna i serializatorów.

  • Microsoft.Orleans. CodeGenerator.MSBuild.

    Install-Package Microsoft.Orleans.CodeGenerator.MSBuild

    Pojawił się w ramach Orleans wersji 2.1.0. Alternatywą dla Microsoft.Orleans.OrleansCodeGenerator.Build pakietu. Korzysta z narzędzia Roslyn do analizy kodu, aby uniknąć ładowania plików binarnych aplikacji i zwiększa obsługę kompilacji przyrostowych, co powinno spowodować skrócenie czasu kompilacji.

Orleans Biblioteki serwerów

Install-Package Microsoft.Orleans.Server

Metapakiet do łatwego tworzenia i uruchamiania silosu. Obejmuje następujące pakiety:

  • Microsoft.Orleans.Core.Abstractions
  • Microsoft.Orleans.Core
  • Microsoft.Orleans.OrleansRuntime
  • Microsoft.Orleans.OrleansProviders

Orleans Biblioteki klienta

Install-Package Microsoft.Orleans.Client

Meta-package do łatwego kompilowania i uruchamiania Orleans klienta (frontonu). Obejmuje następujące pakiety:

  • Microsoft.Orleans.Core.Abstractions
  • Microsoft.Orleans.Core
  • Microsoft.Orleans.OrleansProviders

Orleans Biblioteka podstawowa

Install-Package Microsoft.Orleans.Core

Zawiera implementację dla większości Orleans typów publicznych używanych przez kod aplikacji i Orleans klientów (frontonów). Odwołuje się do niej do tworzenia bibliotek i aplikacji klienckich korzystających z Orleans typów, ale nie zajmują się hostingiem ani silosami. Uwzględnione w microsoft.Orleans. Klient i Microsoft.Orleans. Metapakiet serwera i jest przywołyny bezpośrednio lub pośrednio przez większość innych pakietów.

Hosting

Orleans Środowiska wykonawczego

Install-Package Microsoft.Orleans.OrleansRuntime

Biblioteka do konfigurowania i uruchamiania silosu. Odwołaj się do niego w projekcie hosta silosu. Uwzględnione w microsoft.Orleans. Metapakiet serwera.

Orleans Abstrakcje środowiska uruchomieniowego

Install-Package Microsoft.Orleans.Runtime.Abstractions

Zawiera interfejsy i abstrakcje dla typów zaimplementowanych w programie Microsoft.Orleans.OrleansRuntime.

Orleans Hosting w usługach Azure Cloud Services

Install-Package Microsoft.Orleans.Hosting.AzureCloudServices

Zawiera klasy pomocnika do hostowania silosów i Orleans klientów jako usług Azure Cloud Services (role procesów roboczych i role sieci Web).

Orleans Obsługa hostingu usługi Service Fabric

Install-Package Microsoft.Orleans.Hosting.ServiceFabric

Zawiera klasy pomocnika do hostowania silosów jako bezstanowej usługi Service Fabric.

Dostawcy klastrowania

Poniższe pakiety obejmują wtyczki do utrwalania danych członkostwa w klastrze w różnych technologiach magazynowania.

Orleans dostawca klastrowania dla usługi Azure Table Storage

Install-Package Microsoft.Orleans.Clustering.AzureStorage

Zawiera wtyczkę do używania tabel platformy Azure do przechowywania danych członkostwa w klastrze.

Orleans dostawca klastrowania dla dostawców ADO.NET

Install-Package Microsoft.Orleans.Clustering.AdoNet

Zawiera wtyczkę do używania ADO.NET do przechowywania danych członkostwa klastra w jednej z obsługiwanych baz danych.

Orleans Narzędzia konsula

Install-Package Microsoft.Orleans.OrleansConsulUtils

Zawiera wtyczkę do używania consul do przechowywania danych członkostwa w klastrze.

Orleans Narzędzia dozorców

Install-Package Microsoft.Orleans.OrleansZooKeeperUtils

Zawiera wtyczkę do używania usługi ZooKeeper do przechowywania danych członkostwa w klastrze.

Orleans dostawca klastrowania dla bazy danych AWS DynamoDB

Install-Package Microsoft.Orleans.Clustering.DynamoDB

Zawiera wtyczkę do używania bazy danych AWS DynamoDB do przechowywania danych członkostwa w klastrze.

Dostawcy przypomnień

Poniższe pakiety obejmują wtyczki do utrwalania przypomnień w różnych technologiach magazynowania.

Orleans Przypomnienia dotyczące usługi Azure Table Storage

Install-Package Microsoft.Orleans.Reminders.AzureStorage

Zawiera wtyczkę do używania tabel platformy Azure do przechowywania przypomnień.

Orleans Przypomnienia ADO.NET dostawcy

Install-Package Microsoft.Orleans.Reminders.AdoNet

Zawiera wtyczkę do używania ADO.NET do przechowywania przypomnień w jednej z obsługiwanych baz danych.

Orleans dostawca przypomnień dla bazy danych AWS DynamoDB

Install-Package Microsoft.Orleans.Reminders.DynamoDB

Zawiera wtyczkę do używania bazy danych AWS DynamoDB do przechowywania przypomnień.

Dostawcy magazynu ziarna

Poniższe pakiety obejmują wtyczki do utrwalania stanu ziarna w różnych technologiach magazynowania.

Orleans Trwałość usługi Azure Storage

Install-Package Microsoft.Orleans.Persistence.AzureStorage

Obejmuje wtyczki do używania tabel platformy Azure lub obiektów blob platformy Azure do przechowywania stanu ziarna.

Orleans Dostawcy ADO.NET trwałości

Install-Package Microsoft.Orleans.Persistence.AdoNet

Zawiera wtyczkę do używania ADO.NET do przechowywania stanu ziarna w jednej z obsługiwanych baz danych.

Orleans Trwałość bazy danych DynamoDB

Install-Package Microsoft.Orleans.Persistence.DynamoDB

Zawiera wtyczkę do używania bazy danych AWS DynamoDB do przechowywania stanu ziarna.

Dostawcy usługi Stream

Poniższe pakiety obejmują wtyczki do dostarczania zdarzeń przesyłania strumieniowego.

Orleans ServiceBus Utilities

Install-Package Microsoft.Orleans.OrleansServiceBus

Obejmuje dostawcę strumienia dla usługi Azure Event Hubs.

Orleans Przesyłanie strumieniowe usługi Azure Storage

Install-Package Microsoft.Orleans.Streaming.AzureStorage

Obejmuje dostawcę strumienia dla kolejek platformy Azure.

Orleans Przesyłanie strumieniowe danych AWS SQS

Install-Package Microsoft.Orleans.Streaming.SQS

Obejmuje dostawcę strumienia dla usługi AWS SQS.

Orleans Narzędzia google Cloud Platform

Install-Package Microsoft.Orleans.OrleansGCPUtils

Obejmuje dostawcę strumienia dla usługi GCP PubSub.

Dodatkowe pakiety

Orleans Generowanie kodu

Install-Package Microsoft.Orleans.OrleansCodeGenerator

Zawiera generator kodu w czasie wykonywania.

Orleans Określanie źródła zdarzeń

Install-Package Microsoft.Orleans.EventSourcing

Zawiera zestaw typów podstawowych do tworzenia klas ziarna ze stanem źródła zdarzeń.

Tworzenie i testowanie

Orleans Dostawców

Install-Package Microsoft.Orleans.OrleansProviders

Zawiera zestaw dostawców trwałości i strumieni, którzy przechowują dane w pamięci. Przeznaczony do testowania. Ogólnie rzecz biorąc, nie zaleca się używania w środowisku produkcyjnym, chyba że utrata danych w przypadku awarii silosu jest akceptowalna.

Orleans Testowanie biblioteki hostów

Install-Package Microsoft.Orleans.TestingHost

Zawiera bibliotekę do hostowania silosów i klientów w projekcie testowym.

Serializatory

Orleans Serializator obligacji

Install-Package Microsoft.Orleans.Serialization.Bond

Obejmuje obsługę serializatora Bonda.

Orleans Narzędzia Google

Install-Package Microsoft.Orleans.OrleansGoogleUtils

Zawiera serializator protokołu Google.

Orleans protobuf-net Serializer

Install-Package Microsoft.Orleans.ProtobufNet

Zawiera wersję protobuf-net serializatora protokołu.

Telemetria

Orleans Odbiorca telemetrii — liczniki wydajności

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters

Liczniki wydajności systemu Windows implementacja interfejsu Orleans API telemetrii.

OrleansOdbiorca telemetrii — aplikacja systemu Azure Insights

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI

Obejmuje odbiorcę danych telemetrycznych dla usługi aplikacja systemu Azure Insights.

Orleans Odbiorca telemetrii — NewRelic

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic

Obejmuje odbiorcę danych telemetrycznych dla elementu NewRelic.

Transakcje

Orleans Obsługa transakcji

Install-Package Microsoft.Orleans.Transactions

Obejmuje obsługę transakcji krzyżowych (beta).

Orleans Transakcje na platformie Azure

Install-Package Microsoft.Orleans.Transactions.AzureStorage

Zawiera wtyczkę do utrwalania dziennika transakcji w tabeli platformy Azure (beta).

Narzędzia

Orleans Narzędzie licznika wydajności

Install-Package Microsoft.Orleans.CounterControl

Obejmuje OrleansCounterControl.exeelement , który rejestruje kategorie liczników wydajności systemu Windows dla Orleans statystyk i wdrożonych klas ziarna. Wymaga podniesienia uprawnień. Można wykonać na platformie Azure w ramach zadania uruchamiania roli.