Číst v angličtině

Sdílet prostřednictvím

Orleans Balíčky NuGet

  • Článek
Volba verze Orleans

Spotřebitelé spoléhají na různé balíčky NuGet, aby dosáhli konkrétního požadovaného Orleans chování. Existuje několik běžných balíčků a abstrakcí a mnoho jednotlivých balíčků pro jednotlivé účely. Tento článek obsahuje přehledy, které vývojářům pomůžou zjistit, které Orleans balíčky se mají použít.

Balíčky klíčů

Při psaní Orleans aplikací odkazujete na jeden ze dvou vzájemně se vylučujících balíčků NuGet v závislosti na zvolené úloze. Když třeba napíšete Orleans Silo, budete odkazovat na Microsoft.Orleans. Balíček NuGet serveru Při psaní Orleans klientské aplikace budete odkazovat na Microsoft.Orleans. Balíček NuGet klienta Všechny Orleans projekty, jako jsou abstrakce nebo knihovny tříd zrn, odkazují na Microsoft.Orleans. Balíček NuGet sady SDK Balíček Microsoft.Orleans.Sdk je součástí balíčků Client i Server balíčků.

Balíček NuGet Popis
Microsoft.Orleans. Klient Balíček s výhradním klientem, který se vyžaduje pro Orleans klienta.
Microsoft.Orleans. Sdk Metabalíč vyžadovaný všemi Orleans aplikacemi, serverovými a klientskými balíčky závisí na tomto balíčku.
Microsoft.Orleans. Server Balíček s výhradním serverem, který se vyžaduje pro Orleans sila.

Informace o instalaci balíčků NuGet najdete v následujících možnostech:

Hostování

Balíček NuGet Popis
Microsoft.Orleans. Hosting.AzureCloudServices Hostování nástrojů pro Azure Cloud Services of Orleans.
Microsoft.Orleans. Hosting.Kubernetes Orleans podpora hostování pro Kubernetes.
Microsoft.Orleans. Runtime Core runtime library of Orleans that hosts and executes grain within a silo.

Poskytovatelé clusteringu

Balíček NuGet Popis
Microsoft.Orleans. Clustering.AzureStorage Orleans Poskytovatel clusteringu podporovaný službou Azure Table Storage.
Microsoft.Orleans. Clustering.AdoNet Orleans poskytovatel clusteringu podporovaný ADO.NET.
Microsoft.Orleans. Clustering.DynamoDB Orleans poskytovatel clusteringu podporovaný službou AWS DynamoDB.

Zprostředkovatelé připomenutí

Balíček NuGet Popis
Microsoft.Orleans. Upomínky Knihovna připomenutí pro Microsoft Orleans , která se používá na serveru
Microsoft.Orleans. Reminders.AzureStorage Orleans poskytovatel připomenutí zálohovaný službou Azure Table Storage.
Microsoft.Orleans. Reminders.AdoNet Orleans poskytovatel připomenutí podporovaný ADO.NET.
Microsoft.Orleans. Reminders.DynamoDB Orleans poskytovatel připomenutí podporovaný službou AWS DynamoDB.

Poskytovatelé úložiště odstupňovaného úložiště

Balíček NuGet Popis
Microsoft.Orleans. Persistence.AdoNet Orleans Zprostředkovatel trvalosti založený na ADO.NET.
Microsoft.Orleans. Trvalost.AzureStorage Orleans Zprostředkovatel trvalosti zálohovaný službou Azure Table Storage.
Microsoft.Orleans. Persistence.DynamoDB Orleans Zprostředkovatel trvalosti podporovaný službou AWS DynamoDB.
Microsoft.Orleans. Trvalost.Memory Úložiště v paměti pro Orleans.

Poskytovatelé streamu

Balíček NuGet Popis
Microsoft.Orleans. Proudem Knihovna streamování pro Orleans použití na klientovi i na serveru.
Microsoft.Orleans. Streaming.AzureStorage Orleans poskytovatel streamování zálohovaný službou Azure Queue Storage.
Microsoft.Orleans. Streaming.EventHubs Orleans poskytovatel streamování podporovaný službou Azure Event Hubs.
Microsoft.Orleans. Streaming.SQS Orleans poskytovatel streamování podporovaný AWS SQS.

Další balíčky

Balíček NuGet Popis
Microsoft.Orleans. Analyzátory Analyzátory jazyka C# pro Orleans.
Microsoft.Orleans. CodeGenerator Knihovna generování kódu pro Microsoft.Orleans.Serialization.
Microsoft.Orleans. EventSourcing Základní typy pro vytváření Orleans zrn se stavem zdroje událostí
Microsoft.Orleans. Connections.Security Podpora komunikace zabezpečení pomocí protokolu TLS v Orleanssystému .

Vývoj a testování

Balíček NuGet Popis
Microsoft.Orleans. TestingHost Orleans knihovna pro hostování sila v testovacím projektu.
Microsoft.Orleans. Transactions.TestKit.Base Základní knihovna testovací sady pro transakce
Microsoft.Orleans. Transactions.TestKit.xUnit Knihovna testovacích sad xUnit pro transakce.
Microsoft.Orleans. Serialization.TestKit Testovací sada pro projekty používající Microsoft.Orleans.Serialization.

Serializátory

Balíček NuGet Popis
Microsoft.Orleans. Serializace Serializátor odolný proti rychlým, flexibilním a verzím pro .NET
Microsoft.Orleans. Serializace.Abstrakce Abstrakce serializace pro Orleans.
Microsoft.Orleans. Serialization.SystemTextJson System.Text.Json integrace pro Microsoft.Orleans.Serialization.
Microsoft.Orleans. Serialization.FSharp Podpora typu jádra F# pro Microsoft.Orleans.Serialization.
Microsoft.Orleans. Serialization.NewtonsoftJson Newtonsoft.Json integrace pro Microsoft.Orleans.Serialization.

Transakce

Balíček NuGet Popis
Microsoft.Orleans. Transakce Základní knihovna transakcí použitá Orleans na serveru.
Microsoft.Orleans. Transactions.AzureStorage Orleans transakce poskytovatele úložiště zálohovaného službou Azure Storage.

Nástroje

Jedním z oblíbených Orleans nástrojů je balíček NuGet OrleansDashboard . Tento řídicí panel poskytuje několik jednoduchých metrik a přehledů o tom, co se děje v aplikaci Orleans . Další informace najdete v tématu GitHub: Orleans Řídicí panel.

Balíčky klíčů

Ve většině scénářů budete muset použít 5 klíčových balíčků NuGet:

Orleans Základní abstrakce

Install-Package Microsoft.Orleans.Core.Abstractions

Obsahuje Orleans. Core.Abstractions.dll, která definuje Orleans veřejné typy, které jsou potřeba pro vývoj kódu aplikace (rozhraní a třídy zrnitosti). Tento balíček je potřeba přímo nebo nepřímo odkazovat na jakýkoli Orleans projekt. Přidejte ho do svých projektů, které definují rozhraní a třídy zrnitosti.

Orleans Generování kódu v čase sestavení

  • Microsoft.Orleans. OrleansCodeGenerator.Build.

    Install-Package Microsoft.Orleans.OrleansCodeGenerator.Build

    Objevil se ve Orleans verzi 1.2.0. Podpora doby sestavení pro obilná rozhraní a projekty implementace Přidejte ho do rozhraní a projektů implementace, abyste umožnili generování kódu odkazů na zrní a serializátory.

  • Microsoft.Orleans. CodeGenerator.MSBuild.

    Install-Package Microsoft.Orleans.CodeGenerator.MSBuild

    Zobrazí se jako součást verze Orleans 2.1.0. Alternativu k Microsoft.Orleans.OrleansCodeGenerator.Build balíčku. Využívá Roslyn k analýze kódu, aby se zabránilo načítání binárních souborů aplikací a zlepšuje podporu přírůstkových sestavení, což by mělo vést k kratší době sestavení.

Orleans Serverové knihovny

Install-Package Microsoft.Orleans.Server

Metabal pro snadné sestavení a spuštění sila. Zahrnuje následující balíčky:

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

Orleans Klientské knihovny

Install-Package Microsoft.Orleans.Client

Metabalíč pro snadné sestavení a spuštění Orleans klienta (front-end). Zahrnuje následující balíčky:

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

Orleans Základní knihovna

Install-Package Microsoft.Orleans.Core

Obsahuje implementaci pro většinu Orleans veřejných typů používaných kódem aplikace a Orleans klienty (front-endy). Odkazujte na ni pro vytváření knihoven a klientských aplikací, které používají Orleans typy, ale neřeší hostování nebo sila. Součástí Microsoftu.Orleans Klient a Microsoft.Orleans Metabalíky serveru, na které odkazuje většina ostatních balíčků přímo nebo nepřímo.

Hostování

Orleans Runtime

Install-Package Microsoft.Orleans.OrleansRuntime

Knihovna pro konfiguraci a spuštění sila Odkazujte na něj v hostitelském projektu sila. Součástí Microsoftu.Orleans Serverový metabal.

Orleans Abstrakce modulu runtime

Install-Package Microsoft.Orleans.Runtime.Abstractions

Obsahuje rozhraní a abstrakce pro typy implementované v Microsoft.Orleans.OrleansRuntime.

Orleans Hostování v Azure Cloud Services

Install-Package Microsoft.Orleans.Hosting.AzureCloudServices

Obsahuje pomocné třídy pro hostování sila a Orleans klientů jako Azure Cloud Services (role pracovních procesů a webové role).

Orleans Podpora hostování Service Fabric

Install-Package Microsoft.Orleans.Hosting.ServiceFabric

Obsahuje pomocné třídy pro hostování sila jako bezstavovou službu Service Fabric.

Poskytovatelé clusteringu

Následující balíčky zahrnují moduly plug-in pro zachování dat členství v clusteru v různých technologiích úložiště.

Orleans Poskytovatel clusteringu pro Azure Table Storage

Install-Package Microsoft.Orleans.Clustering.AzureStorage

Zahrnuje modul plug-in pro použití tabulek Azure pro ukládání dat členství v clusteru.

Orleans Poskytovatel clusteringu pro poskytovatele ADO.NET

Install-Package Microsoft.Orleans.Clustering.AdoNet

Zahrnuje modul plug-in pro použití ADO.NET pro ukládání dat členství v clusteru v jedné z podporovaných databází.

Orleans Nástroje consul

Install-Package Microsoft.Orleans.OrleansConsulUtils

Zahrnuje modul plug-in pro použití Consul pro ukládání dat členství v clusteru.

Orleans ZooKeeper Utilities

Install-Package Microsoft.Orleans.OrleansZooKeeperUtils

Zahrnuje modul plug-in pro použití ZooKeeper pro ukládání dat členství v clusteru.

Orleans Poskytovatel clusteringu pro AWS DynamoDB

Install-Package Microsoft.Orleans.Clustering.DynamoDB

Zahrnuje modul plug-in pro použití AWS DynamoDB pro ukládání dat členství v clusteru.

Zprostředkovatelé připomenutí

Následující balíčky zahrnují moduly plug-in pro zachování připomenutí v různých technologiích úložiště.

Orleans Připomenutí služby Azure Table Storage

Install-Package Microsoft.Orleans.Reminders.AzureStorage

Zahrnuje modul plug-in pro použití tabulek Azure k ukládání připomenutí.

Orleans Připomenutí ADO.NET zprostředkovatelé

Install-Package Microsoft.Orleans.Reminders.AdoNet

Zahrnuje modul plug-in pro použití ADO.NET pro ukládání připomenutí v některé z podporovaných databází.

Orleans zprostředkovatel připomenutí pro AWS DynamoDB

Install-Package Microsoft.Orleans.Reminders.DynamoDB

Zahrnuje modul plug-in pro použití AWS DynamoDB pro ukládání připomenutí.

Poskytovatelé úložiště odstupňovaného úložiště

Následující balíčky zahrnují moduly plug-in pro zachování stavu agregace v různých technologiích úložiště.

Orleans Trvalost služby Azure Storage

Install-Package Microsoft.Orleans.Persistence.AzureStorage

Zahrnuje moduly plug-in pro použití tabulek Azure nebo objektů blob Azure pro ukládání stavu agregace.

Orleans Zprostředkovatelé trvalosti ADO.NET

Install-Package Microsoft.Orleans.Persistence.AdoNet

Zahrnuje modul plug-in pro použití ADO.NET pro ukládání stavu agregace v některé z podporovaných databází.

Orleans Trvalost DynamoDB

Install-Package Microsoft.Orleans.Persistence.DynamoDB

Zahrnuje modul plug-in pro použití AWS DynamoDB pro ukládání stavu agregace.

Poskytovatelé streamu

Následující balíčky zahrnují moduly plug-in pro doručování událostí streamování.

Orleans Nástroje servicebusu

Install-Package Microsoft.Orleans.OrleansServiceBus

Zahrnuje zprostředkovatele streamu pro Službu Azure Event Hubs.

Orleans Streamování služby Azure Storage

Install-Package Microsoft.Orleans.Streaming.AzureStorage

Zahrnuje poskytovatele streamu pro fronty Azure.

Orleans Streamování AWS SQS

Install-Package Microsoft.Orleans.Streaming.SQS

Zahrnuje poskytovatele streamu pro službu AWS SQS.

Orleans Nástroje Google Cloud Platform

Install-Package Microsoft.Orleans.OrleansGCPUtils

Zahrnuje poskytovatele streamu pro službu GCP PubSub.

Další balíčky

Orleans Generování kódu

Install-Package Microsoft.Orleans.OrleansCodeGenerator

Zahrnuje generátor kódu za běhu.

Orleans Event-Sourcing

Install-Package Microsoft.Orleans.EventSourcing

Obsahuje sadu základních typů pro vytváření tříd agregace se stavem zdroje událostí.

Vývoj a testování

Orleans Poskytovatelů

Install-Package Microsoft.Orleans.OrleansProviders

Obsahuje sadu zprostředkovatelů trvalosti a datových proudů, které udržují data v paměti. Určeno pro testování. Obecně se nedoporučuje pro použití v produkčním prostředí, pokud není přijatelná ztráta dat v případě selhání sila.

Orleans Testování knihovny hostitelů

Install-Package Microsoft.Orleans.TestingHost

Zahrnuje knihovnu pro hostování sila a klientů v testovacím projektu.

Serializátory

Orleans Bond Serializer

Install-Package Microsoft.Orleans.Serialization.Bond

Zahrnuje podporu serializátoru Bond.

Orleans Nástroje Google

Install-Package Microsoft.Orleans.OrleansGoogleUtils

Obsahuje serializátor vyrovnávací paměti protokolu Google.

Orleans protobuf-net Serializer

Install-Package Microsoft.Orleans.ProtobufNet

Obsahuje protobuf-net verzi serializátoru vyrovnávací paměti protokolu.

Telemetrie

Orleans Příjemce telemetrie – Čítače výkonu

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters

Implementace rozhraní API telemetrie v čítačích výkonu Orleans Windows

OrleansPříjemce telemetrie – Aplikace Azure lication Insights

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI

Zahrnuje příjemce telemetrie pro Aplikace Azure lication Insights.

Orleans Příjemce telemetrie – NewRelic

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic

Zahrnuje příjemce telemetrie pro NewRelic.

Transakce

Orleans Podpora transakcí

Install-Package Microsoft.Orleans.Transactions

Zahrnuje podporu pro transakce křížového agregačního intervalu (beta verze).

Orleans Transakce v Azure

Install-Package Microsoft.Orleans.Transactions.AzureStorage

Zahrnuje modul plug-in pro zachování transakčního protokolu v Tabulce Azure (beta verze).

Nástroje

Orleans Nástroj Čítač výkonu

Install-Package Microsoft.Orleans.CounterControl

Zahrnuje OrleansCounterControl.exe, který registruje kategorie čítače výkonu Systému Windows pro Orleans statistiky a nasazené třídy grain. Vyžaduje zvýšení oprávnění. V Azure se dá spustit jako součást spouštěcí úlohy role.