Orleans Pakiety NuGet

Kluczowe pakiety

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 Silo będziesz odwoływać się do pakietu NuGet Microsoft.Orleans.Server. Podczas pisania aplikacji klienckiej Orleans będziesz odwoływać się do pakietu NuGet Microsoft.Orleans.Client. Wszystkie Orleans projekty, takie jak abstrakcje lub biblioteki klas ziarna, odwołują się do pakietu NuGet Microsoft.Orleans.Sdk. Pakiet Microsoft.Orleans.Sdk jest dołączany zarówno z pakietem Client, jak i z pakietem Server.

Pakiet NuGet	opis
Microsoft.Orleans. Klient	Pakiet wymagany wyłącznie dla klienta Orleans.
Microsoft.Orleans.SDK	Metapakiet wymagany przez wszystkie Orleans aplikacje, serwery i pakiety klienckie zależą od tego pakietu.
Microsoft.Orleans. Serwer	Pakiet wyłącznie dla serwera, wymagany dla silosów Orleans.

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

• Interfejs wiersza polecenia platformy .NET: dodawanie pakietu dotnet
• Sposoby instalowania pakietu NuGet

Usługi hostingowe

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 wykonawcza Orleans odpowiedzialna za hostowanie i wykonywanie ziaren 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.Persistencja.AzureStorage	Orleans dostawca trwałości wspierany przez usługę Azure Table Storage.
Microsoft.Orleans.Persistencja.DynamoDB	Orleans dostawca trwałości wspierany przez usługę AWS DynamoDB.
Microsoft.Orleans. Trwałość.Pamięć	Magazyn w pamięci dla Orleans.

Dostawcy usługi Stream

Pakiet NuGet	opis
Microsoft.Orleans.Przesyłanie strumieniowe	Biblioteka do przesyłania strumieniowego wykorzystywana 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 obiektów ze stanem opartym na zdarzeniach.
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.OrleansTransactions.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 z Microsoft.Orleans.Serialization.
Microsoft.Orleans.Serializacja.FSharp	Obsługa typów podstawowych F# dla Microsoft.Orleans.Serialization.
Microsoft.Orleans. Serialization.NewtonsoftJson	Newtonsoft.Json integracja z Microsoft.Orleans.Serialization.

Transakcje

Pakiet NuGet	opis
Microsoft.Orleans.Transakcje	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.

Kluczowe pakiety

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

Orleans Podstawowe abstrakcje

Install-Package Microsoft.Orleans.Core.Abstractions

Zawiera OrleansCore.Abstractions.dll, który definiuje Orleans typy publiczne potrzebne do tworzenia kodu aplikacji (interfejsy grain 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 1.2.0. Wsparcie w czasie kompilacji dla interfejsów modułów i projektów implementacyjnych. Dodaj go do interfejsów i projektów implementacji ziarna, aby umożliwić generowanie kodu dla odwołań do ziarna i serializatorów.

• Microsoft.Orleans. CodeGenerator.MSBuild.

  Install-Package Microsoft.Orleans.CodeGenerator.MSBuild
  

  Pojawił się w ramach Orleans wersji 2.1.0. Alternatywa dla pakietu Microsoft.Orleans.OrleansCodeGenerator.Build. 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 tworzenia i uruchamiania Orleans interfejsu użytkownika (frontendu). 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 (frontendów). Użyj jej do tworzenia bibliotek i aplikacji klienckich korzystających z Orleans typów, ale nie zajmujących się hostingiem ani silosami. Zawarte w pakietach meta typu Microsoft.Orleans.Client i Microsoft.Orleans.Server i jest przywoływane bezpośrednio lub pośrednio przez większość innych pakietów.

Usługi hostingowe

Orleans Czas wykonywania

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. Metapakiecie 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 pomocnicze klasy do hostowania silosów i Orleans klientów jako usługi Azure Cloud Services (Worker Roles i Web Roles).

Orleans Obsługa hostingu usługi Service Fabric

Install-Package Microsoft.Orleans.Hosting.ServiceFabric

Zawiera klasy pomocnicze dla hostowania silosów jako usługi bezstanowej w technologii 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 ZooKeeper

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 Dostawcy przypomnień ADO.NET

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 transmisji zdarzeń strumieniowych.

Orleans ServiceBus Utilities

Install-Package Microsoft.Orleans.OrleansServiceBus

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

Orleans Przesyłanie strumieniowe Azure Storage

Install-Package Microsoft.Orleans.Streaming.AzureStorage

Obejmuje dostawcę usług strumieniowych 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 opartym na zdarzeniach.

Tworzenie i testowanie

Orleans Dostawcy

Install-Package Microsoft.Orleans.OrleansProviders

Zawiera zbiór dostawców zachowywania danych i strumieni, które 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ę Bond serializer.

Orleans Narzędzia Google

Install-Package Microsoft.Orleans.OrleansGoogleUtils

Zawiera serializator Google Protocol Buffers.

Orleans protobuf-net Serializer

Install-Package Microsoft.Orleans.ProtobufNet

Zawiera wersję protobuf-net serializatora Protocol Buffers.

Telemetria

Orleans Odbiorca telemetrii — liczniki wydajności

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters

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

OrleansOdbiorca telemetrii — aplikacja systemu Azure Insights

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI

Obejmuje odbiorcę danych telemetrycznych dla usługi Azure Application 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.