Pacotes NuGet do Orleans

Pacotes de chaves

Você faz referência a um dos dois pacotes NuGet mutuamente exclusivos ao escrever aplicativos do Orleans, dependendo da carga de trabalho escolhida. Por exemplo, ao escrever um Orleans Silo, você fará referência ao pacote NuGet Microsoft.Orleans.Server. Ao escrever um aplicativo cliente do Orleans, você fará referência ao pacote NuGet Microsoft.Orleans.Client. Todos os projetos do Orleans, como abstrações ou bibliotecas de classes de granularidade, fazem referência ao pacote NuGet Microsoft.Orleans.Sdk. O pacote Microsoft.Orleans.Sdk está incluído nos pacotes Client e Server.

Pacote NuGet	Descrição
Microsoft.Orleans. Cliente	Pacote exclusivo do cliente, necessário para o cliente do Orleans.
Microsoft.Orleans. Sdk	O metapacote exigido por todos os aplicativos, servidores e pacotes de cliente do Orleans dependem desse pacote.
Microsoft.Orleans. Servidor	Pacote exclusivo do servidor, necessário para silos do Orleans.

Para obter mais informações sobre como instalar pacotes NuGet, confira as seguintes opções:

• CLI do .NET: adicionar pacote dotnet
• Maneiras de instalar um pacote NuGet

Hospedagem

Pacote NuGet	Descrição
Microsoft.Orleans. Hosting.AzureCloudServices	Utilitários de hospedagem para Serviços de Nuvem do Azure do Orleans.
Microsoft.Orleans. Hosting.Kubernetes	Suporte de hospedagem do Orleans para Kubernetes.
Microsoft.Orleans. Runtime	Biblioteca de runtime principal do Orleans que hospeda e executa granularidades em um silo.

Provedores de clustering

Pacote NuGet	Descrição
Microsoft.Orleans. Clustering.AzureStorage	Provedor de clustering do Orleans com suporte do Armazenamento de Tabelas do Azure.
Microsoft.Orleans. Clustering.AdoNet	Provedor de clustering do Orleans com suporte do ADO.NET.
Microsoft.Orleans. Clustering.DynamoDB	Provedor de serviços de clustering Orleans baseado no Amazon Web Services DynamoDB.

Provedores de lembrete

Pacote NuGet	Descrição
Microsoft.Orleans.Lembretes	Biblioteca de lembretes para Microsoft Orleans usada no servidor.
Microsoft.Orleans. Reminders.AzureStorage	Provedor de lembretes do Orleans com suporte do Armazenamento de Tabelas do Azure.
Microsoft.Orleans. Reminders.AdoNet	Provedor de lembretes do Orleans com suporte do ADO.NET.
Microsoft.Orleans. Reminders.DynamoDB	Provedor de lembretes do Orleans com suporte do AWS DynamoDB.

Provedores de armazenamento de granularidade

Pacote NuGet	Descrição
Microsoft.Orleans. Persistence.AdoNet	Provedor de persistência do Orleans com suporte do ADO.NET.
Microsoft.Orleans. Persistence.AzureStorage	Provedor de persistência do Orleans com suporte do Armazenamento de Tabelas do Azure.
Microsoft.Orleans. Persistence.DynamoDB	Provedor de persistência Orleans alimentado por AWS DynamoDB.
Microsoft.Orleans. Persistence.Memory	Armazenamento na memória para o Orleans.

Provedores de streaming

Pacote NuGet	Descrição
Microsoft.Orleans. Streaming	Biblioteca de streaming para o Orleans usada no cliente e no servidor.
Microsoft.Orleans. Streaming.AzureStorage	Provedor de streaming do Orleans com suporte do Armazenamento de Filas do Azure.
Microsoft.Orleans. Streaming.EventHubs	Orleans provedor de streaming suportado pelos Hubs de Eventos do Azure.
Microsoft.Orleans. Streaming.SQS	Provedor de streaming do Orleans com suporte do AWS SQS.

Pacotes adicionais

Pacote NuGet	Descrição
Microsoft.Orleans. Analisadores	Analisadores de C# para Orleans.
Microsoft.Orleans. CodeGenerator	Biblioteca de geração de código para Microsoft.Orleans.Serialization.
Microsoft.Orleans. EventSourcing	Tipos base para criar granularidades do Orleans com estado de origem de evento.
Microsoft.Orleans. Connections.Security	Suporte para comunicação de segurança usando TLS no Orleans.

Desenvolvimento e teste

Pacote NuGet	Descrição
Microsoft.Orleans. TestingHost	Biblioteca do Orleans para hospedar um silo em um projeto de teste.
Microsoft.Orleans. Transactions.TestKit.Base	Biblioteca base do kit de teste para transações.
Microsoft.Orleans. Transactions.TestKit.xUnit	Biblioteca de kits de teste do xUnit para transações.
Microsoft.Orleans. Serialization.TestKit	Kit de teste para projetos usando Microsoft.Orleans.Serialization.

Serializadores

Pacote NuGet	Descrição
Microsoft.Orleans. Serialização	Serializador rápido, flexível e tolerante a versões para .NET.
Microsoft.Orleans. Serialization.Abstractions	Abstrações de serialização para o Orleans.
Microsoft.Orleans. Serialization.SystemTextJson	Integração do System.Text.Json para Microsoft.Orleans.Serialization.
Microsoft.Orleans. Serialization.FSharp	Suporte de tipo de núcleo F# para Microsoft.Orleans.Serialization.
Microsoft.Orleans. Serialization.NewtonsoftJson	Integração do Newtonsoft.Json para Microsoft.Orleans.Serialization.

Transações

Pacote NuGet	Descrição
Microsoft.Orleans. Transações	Biblioteca de transações principais do Orleans usada no servidor.
Microsoft.Orleans. Transactions.AzureStorage	Provedor de armazenamento para transações Orleans suportado pelo Azure Storage.

Ferramentas

Uma ferramenta Orleans popular é o pacote NuGet OrleansDashboard. Esse painel fornece algumas métricas e insights simples sobre o que está acontecendo no seu aplicativo do Orleans. Para obter mais informações, consulte GitHub: Orleans Dashboard.

Pacotes de chaves

Existem cinco pacotes NuGet principais que você precisará usar na maioria dos cenários:

Orleans Abstrações Principais

Install-Package Microsoft.Orleans.Core.Abstractions

Contém o Orleans.Core.Abstractions.dll, que define os tipos públicos do Orleans necessários para desenvolver o código do aplicativo (interfaces e classes de granularidade). Esse pacote é necessário para ser referenciado direta ou indiretamente por qualquer projeto do Orleans. Adicione-o aos projetos que definemas interfaces e classes de granularidade.

Geração de código para tempo de build do Orleans

• Microsoft.Orleans. OrleansCodeGenerator.Build.

  Install-Package Microsoft.Orleans.OrleansCodeGenerator.Build
  

  Apareceu no Orleans 1.2.0. Suporte ao tempo de compilação para interfaces de granularidade e projetos de implementação. Adicione-o às interfaces de granularidade e aos projetos de implementação para habilitar a geração de código das referências de granularidade e serializadores.

• Microsoft.Orleans. CodeGenerator.MSBuild.

  Install-Package Microsoft.Orleans.CodeGenerator.MSBuild
  

  Apareceu como parte do Orleans 2.1.0. Uma alternativa para o pacote Microsoft.Orleans.OrleansCodeGenerator.Build. Utiliza o Roslyn para análise de código para evitar o carregamento de binários do aplicativo e melhora o suporte para compilações incrementais, o que deve resultar em tempos de compilação mais curtos.

Orleans Bibliotecas de Servidor

Install-Package Microsoft.Orleans.Server

Um metapacote para compilar e iniciar facilmente um silo. Inclui os seguintes pacotes:

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

Bibliotecas Cliente Orleans

Install-Package Microsoft.Orleans.Client

Um metapacote para construir e iniciar facilmente um cliente Orleans (front-end). Inclui os seguintes pacotes:

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

Orleans Biblioteca principal

Install-Package Microsoft.Orleans.Core

Contém a implementação da maioria dos tipos públicos do Orleans usados pelo código do aplicativo e pelos clientes do Orleans (front-ends). Referencie-o para compilar bibliotecas e aplicativos cliente que usam os tipos do Orleans, mas não lidam com hospedagem ou silos. Incluído nos metapacotes Microsoft.Orleans.Client e Microsoft.Orleans.Server e referenciado direta ou indiretamente pela maioria dos outros pacotes.

Hospedagem

Tempo de ExecuçãoOrleans

Install-Package Microsoft.Orleans.OrleansRuntime

Biblioteca para configurar e iniciar um silo. Referencie-o no projeto de host do silo. Incluído no metapacote Microsoft.Orleans.Server.

Orleans Abstrações de runtime

Install-Package Microsoft.Orleans.Runtime.Abstractions

Contém interfaces e abstrações para tipos implementados no Microsoft.Orleans.OrleansRuntime.

Hospedagem nos Orleans Serviços de Nuvem do Azure

Install-Package Microsoft.Orleans.Hosting.AzureCloudServices

Contém classes auxiliares para hospedar silos e clientes do Orleans como Serviços de Nuvem do Azure (Funções de Trabalho e Funções Web).

Orleans Suporte à hospedagem do Service Fabric

Install-Package Microsoft.Orleans.Hosting.ServiceFabric

Contém as classes auxiliares para hospedar silos como serviço sem estado do Service Fabric.

Provedores de clustering

Os pacotes abaixo incluem plug-ins para manter dados de associação de cluster em várias tecnologias de armazenamento.

Orleans Provedor de clustering para Armazenamentos de Tabelas do Azure

Install-Package Microsoft.Orleans.Clustering.AzureStorage

Inclui o plug-in para usar as Tabelas do Azure para armazenar dados de associação de cluster.

Provedor de clustering para provedores ADO.NET Orleans

Install-Package Microsoft.Orleans.Clustering.AdoNet

Inclui o plug-in para usar o ADO.NET para armazenar dados de associação de cluster em um dos bancos de dados com suporte.

Orleans Utilitários do Consul

Install-Package Microsoft.Orleans.OrleansConsulUtils

Inclui o plug-in para usar o Consul para armazenar dados de associação de cluster.

Orleans Utilitários do ZooKeeper

Install-Package Microsoft.Orleans.OrleansZooKeeperUtils

Inclui o plug-in para usar o ZooKeeper para armazenar dados de associação de cluster.

Provedor de solução de clustering para o DynamoDB da AWSOrleans

Install-Package Microsoft.Orleans.Clustering.DynamoDB

Inclui o plug-in para usar o AWS DynamoDB para armazenar dados de associação de cluster.

Provedores de lembrete

Os pacotes abaixo incluem plug-ins para lembretes persistentes em várias tecnologias de armazenamento.

Orleans Lembretes do Armazenamento de Tabelas do Azure

Install-Package Microsoft.Orleans.Reminders.AzureStorage

Inclui o plug-in para usar as Tabelas do Azure para armazenar lembretes.

Orleans

Install-Package Microsoft.Orleans.Reminders.AdoNet

Inclui o plug-in para usar o ADO.NET para armazenar lembretes em um dos bancos de dados com suporte.

Provedor de lembretes para AWS DynamoDBOrleans

Install-Package Microsoft.Orleans.Reminders.DynamoDB

Inclui o plug-in para usar o AWS DynamoDB para armazenar lembretes.

Provedores de armazenamento de granularidade

Os pacotes abaixo incluem plug-ins para estado de granularidade persistente em várias tecnologias de armazenamento.

Orleans Persistência do Armazenamento do Azure

Install-Package Microsoft.Orleans.Persistence.AzureStorage

Inclui os plug-ins para usar as Tabelas do Azure ou os Blobs do Azure para armazenar o estado de granularidade.

Orleans Persistência para provedores do ADO.NET

Install-Package Microsoft.Orleans.Persistence.AdoNet

Inclui o plug-in para usar o ADO.NET para armazenar o estado de granularidade em um dos bancos de dados com suporte.

Orleans Persistência para o DynamoDB

Install-Package Microsoft.Orleans.Persistence.DynamoDB

Inclui o plug-in para usar o AWS DynamoDB para armazenar o estado de granularidade.

Provedores de streaming

Os pacotes abaixo incluem plug-ins para fornecer eventos de streaming.

Orleans Utilitários do ServiceBus

Install-Package Microsoft.Orleans.OrleansServiceBus

Inclui o provedor de streaming para Hubs de Eventos do Azure.

Orleans Streaming do Armazenamento Azure

Install-Package Microsoft.Orleans.Streaming.AzureStorage

Inclui o provedor de streaming para Filas do Azure.

Orleans Streaming AWS SQS

Install-Package Microsoft.Orleans.Streaming.SQS

Inclui o provedor de streaming para serviço SQS do AWS.

Orleans Utilitários da Google Cloud Platform

Install-Package Microsoft.Orleans.OrleansGCPUtils

Inclui o provedor de streaming para serviço GCP PubSub.

Pacotes adicionais

Orleans Geração de código

Install-Package Microsoft.Orleans.OrleansCodeGenerator

Inclui o gerador de código em tempo de execução.

Event SourcingOrleans

Install-Package Microsoft.Orleans.EventSourcing

Contém um conjunto de tipos base para criar classes de grãos com estado baseado em eventos.

Desenvolvimento e teste

Orleans Provedores

Install-Package Microsoft.Orleans.OrleansProviders

Contém um conjunto de provedores de persistência e streaming que mantêm os dados na memória. Indicado para teste. Em geral, não é recomendado para uso em produção, a menos que a perda de dados em caso de falha de silo seja aceitável.

Orleans Biblioteca de hosts de teste

Install-Package Microsoft.Orleans.TestingHost

Inclui a biblioteca para hospedar silos e clientes em um projeto de teste.

Serializadores

Orleans Serializador do Bond

Install-Package Microsoft.Orleans.Serialization.Bond

Inclui suporte para serializador de Bond.

Utilitários do GoogleOrleans

Install-Package Microsoft.Orleans.OrleansGoogleUtils

Inclui o serializador Google Protocol Buffers.

Orleans Serializador de protobuf-net

Install-Package Microsoft.Orleans.ProtobufNet

Inclui a versão protobuf-net do serializador de Buffers de Protocolo.

Telemetria

Consumidor de Telemetria – Contadores de DesempenhoOrleans

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters

Implementação de Contadores de Desempenho do Windows da API de Telemetria do Orleans.

Orleans Consumidor de telemetria – Azure Application Insights

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI

Inclui o consumidor de telemetria do Azure Application Insights.

Orleans Consumidor de telemetria – NewRelic

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic

Inclui o consumidor de telemetria do NewRelic.

Transações

Orleans Suporte para transações

Install-Package Microsoft.Orleans.Transactions

Inclui suporte para transações intersetoriais (beta).

Orleans Transações no Azure

Install-Package Microsoft.Orleans.Transactions.AzureStorage

Inclui um plug-in para log de transações persistente na Tabela do Azure (beta).

Ferramentas

Orleans Ferramenta Contador de desempenho

Install-Package Microsoft.Orleans.CounterControl

Inclui o OrleansCounterControl.exe, que registra as categorias do contador de desempenho do Windows para estatísticas do Orleans e para classes de granularidade implantadas. Requer elevação. Pode ser executado no Azure como parte de uma tarefa de inicialização de função.