Orleans Pacotes NuGet
Os consumidores confiam Orleans em vários pacotes NuGet para alcançar comportamentos desejados específicos. Existem vários pacotes e abstrações comuns, e muitos pacotes individuais de finalidade única. Este artigo fornece informações para ajudar os desenvolvedores a saber quais Orleans pacotes devem ser usados.
Pacotes de chaves
Você faz referência a um dos dois pacotes NuGet mutuamente exclusivos ao escrever Orleans aplicativos, dependendo da carga de trabalho escolhida. Por exemplo, ao escrever um Orleans Silo, você fará referência à Microsoft.Orleans. Pacote NuGet do servidor . Ao escrever um Orleans aplicativo cliente, você fará referência à Microsoft.Orleans. Pacote NuGet do cliente . Todos os Orleans projetos, como abstrações ou bibliotecas de classes de grão, fazem referência à Microsoft.Orleans Pacote Sdk NuGet. O Microsoft.Orleans.Sdk pacote está incluído com ambos os Client Server e pacotes.
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. Cliente | Pacote exclusivo para o cliente, necessário para Orleans o cliente. |
| Microsoft.Orleans. Sdk | O metapacote exigido por todos os Orleans aplicativos, pacotes de servidor e cliente depende desse pacote. |
| Microsoft.Orleans. Servidor | Pacote exclusivo para servidor, necessário para Orleans silos. |
Para obter informações sobre como instalar pacotes NuGet, consulte as seguintes opções:
Alojamento
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. Hosting.AzureCloudServices | Utilitários de hospedagem para os Serviços de Nuvem do Azure do Orleans. |
| Microsoft.Orleans. Hospedagem.Kubernetes | Orleans suporte de hospedagem para Kubernetes. |
| Microsoft.Orleans. Tempo de execução | Biblioteca de tempo de execução principal que hospeda e executa grãos dentro de Orleans um silo. |
Provedores de clustering
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. Clustering.AzureStorage | Orleans provedor de clustering apoiado pelo Armazenamento de Tabela do Azure. |
| Microsoft.Orleans. Clustering.AdoNet | Orleans provedor de clustering apoiado por ADO.NET. |
| Microsoft.Orleans. Clustering.DynamoDB | Orleans provedor de clustering apoiado pelo AWS DynamoDB. |
Provedores de lembretes
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. Lembretes | Biblioteca de lembretes para a Microsoft Orleans usada no servidor. |
| Microsoft.Orleans. Lembretes.AzureStorage | Orleans provedor de lembretes apoiado pelo Armazenamento de Tabela do Azure. |
| Microsoft.Orleans. Lembretes.AdoNet | Orleans provedor de lembretes apoiado por ADO.NET. |
| Microsoft.Orleans. Lembretes.DynamoDB | Orleans provedor de lembretes apoiado pelo AWS DynamoDB. |
Fornecedores de armazenamento de grãos
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. Persistence.AdoNet | Orleans provedor de persistência apoiado por ADO.NET. |
| Microsoft.Orleans. Persistence.AzureStorage | Orleans provedor de persistência apoiado pelo Armazenamento de Tabela do Azure. |
| Microsoft.Orleans. Persistência.DynamoDB | Orleans provedor de persistência apoiado pelo AWS DynamoDB. |
| Microsoft.Orleans. Persistência.Memória | Armazenamento na memória para Orleans. |
Provedores de fluxo
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. Transmissão | Biblioteca de streaming para Orleans uso no cliente e no servidor. |
| Microsoft.Orleans. Streaming.AzureStorage | Orleans provedor de streaming apoiado pelo Armazenamento de Filas do Azure. |
| Microsoft.Orleans. Streaming.EventHubs | Orleans provedor de streaming apoiado pelos Hubs de Eventos do Azure. |
| Microsoft.Orleans. Streaming.SQS | Orleans provedor de streaming apoiado pelo AWS SQS. |
Pacotes adicionais
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. Analisadores | Analisadores C# para Orleans. |
| Microsoft.Orleans. CodeGenerator | Biblioteca de geração de código para Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. EventSourcing | Tipos básicos para criar Orleans grãos com estado de origem em eventos. |
| Microsoft.Orleans. Conexões.Segurança | Suporte para comunicação de segurança usando TLS no Orleans. |
Desenvolvimento e teste
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. TestingHost | Orleans biblioteca para hospedar um silo em um projeto de teste. |
| Microsoft.Orleans. Transações.TestKit.Base | Biblioteca base do kit de teste para transações. |
| Microsoft.Orleans. Transações.TestKit.xUnit | Biblioteca do kit de teste xUnit para transações. |
| Microsoft.Orleans. Serialização.TestKit | Kit de teste para projetos que usam Microsoft.Orleans.Serializationo . |
Serializadores
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. Serialização | Serializador rápido, flexível e tolerante à versão para .NET. |
| Microsoft.Orleans. Serialização.Abstrações | Abstrações de serialização para Orleans. |
| Microsoft.Orleans. Serialization.SystemTextJson | System.Text.Json integração para Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialização.FSharp | Suporte ao tipo de núcleo F# para Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialização.NewtonsoftJson | Newtonsoft.Json integração para Microsoft.Orleans.Serialization. |
Transações
| Pacote NuGet | Description |
|---|---|
| Microsoft.Orleans. Transações | Biblioteca de transações principal do Orleans usado no servidor. |
| Microsoft.Orleans. Transações.AzureStorage | Orleans provedor de armazenamento de transações apoiado pelo Armazenamento do Azure. |
Ferramentas
Uma ferramenta popular Orleans é o pacote NuGet OrleansDashboard . Este painel fornece algumas métricas simples e informações sobre o que está acontecendo dentro do seu Orleans aplicativo. Para obter mais informações, consulte GitHub: Orleans Dashboard.
Pacotes de chaves
Há 5 pacotes principais do NuGet que você precisará usar na maioria dos cenários:
Orleans Abstrações do núcleo
Install-Package Microsoft.Orleans.Core.Abstractions
Contém Orleans. Core.Abstractions.dll, que define Orleans os tipos públicos necessários para o desenvolvimento de código de aplicativo (interfaces e classes de grão). Este pacote é necessário para ser referenciado direta ou indiretamente por qualquer Orleans projeto. Adicione-o aos seus projetos que definem interfaces e classes de grão.
Orleans Geração de código em tempo de construção
Microsoft.Orleans. OrleansCodeGenerator.Build.
Install-Package Microsoft.Orleans.OrleansCodeGenerator.BuildApareceu em Orleans 1.2.0. Suporte de tempo de construção para interfaces de grãos e projetos de implementação. Adicione-o às suas interfaces grain e projetos de implementação para permitir a geração de código de referências grain e serializadores.
Microsoft.Orleans. CodeGenerator.MSBuild.
Install-Package Microsoft.Orleans.CodeGenerator.MSBuildApareceu como parte da Orleans versão 2.1.0. Uma alternativa ao
Microsoft.Orleans.OrleansCodeGenerator.Buildpacote. Aproveita o Roslyn para análise de código para evitar o carregamento de binários de aplicativos e melhora o suporte para compilações incrementais, o que deve resultar em tempos de compilação mais curtos.
Orleans Bibliotecas de servidores
Install-Package Microsoft.Orleans.Server
Um meta-pacote para construir e iniciar facilmente um silo. Inclui os seguintes pacotes:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansRuntimeMicrosoft.Orleans.OrleansProviders
Orleans Bibliotecas de clientes
Install-Package Microsoft.Orleans.Client
Um meta-pacote para construir e iniciar facilmente um Orleans cliente (frontend). Inclui os seguintes pacotes:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansProviders
Orleans Biblioteca Principal
Install-Package Microsoft.Orleans.Core
Contém implementação para a maioria dos Orleans tipos públicos usados pelo código do aplicativo e Orleans clientes (frontends). Faça referência a ele para criar bibliotecas e aplicativos cliente que usam Orleans tipos, mas não lidam com hospedagem ou silos. Incluído no Microsoft.Orleans. Cliente e Microsoft.Orleans. Meta-pacotes de servidor e é referenciado, direta ou indiretamente, pela maioria dos outros pacotes.
Alojamento
Orleans Tempo de execução
Install-Package Microsoft.Orleans.OrleansRuntime
Biblioteca para configurar e iniciar um silo. Faça referência a ele em seu projeto de host de silo. Incluído no Microsoft.Orleans. Meta-pacote do servidor.
Orleans Abstrações de tempo de execução
Install-Package Microsoft.Orleans.Runtime.Abstractions
Contém interfaces e abstrações para tipos implementados no Microsoft.Orleans.OrleansRuntime.
Orleans Hospedagem nos Serviços de Nuvem do Azure
Install-Package Microsoft.Orleans.Hosting.AzureCloudServices
Contém classes auxiliares para hospedar silos e Orleans clientes como Serviços de Nuvem do Azure (Funções de Trabalho e Funções Web).
Orleans Suporte de hospedagem do Service Fabric
Install-Package Microsoft.Orleans.Hosting.ServiceFabric
Contém classes auxiliares para hospedar silos como um serviço do Service Fabric sem monitoração de estado.
Provedores de clustering
Os pacotes abaixo incluem plug-ins para persistência de dados de associação de cluster em várias tecnologias de armazenamento.
Orleans provedor de clustering para Armazenamentos de Tabela 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.
Orleans provedor de clustering para provedores de ADO.NET
Install-Package Microsoft.Orleans.Clustering.AdoNet
Inclui o plug-in para usar ADO.NET para armazenar dados de associação de cluster em um dos bancos de dados suportados.
Orleans Consul Utilitários
Install-Package Microsoft.Orleans.OrleansConsulUtils
Inclui o plug-in para usar o Consul para armazenar dados de associação ao cluster.
Orleans ZooKeeper Utilitários
Install-Package Microsoft.Orleans.OrleansZooKeeperUtils
Inclui o plug-in para usar o ZooKeeper para armazenar dados de associação de cluster.
Orleans provedor de clustering para AWS DynamoDB
Install-Package Microsoft.Orleans.Clustering.DynamoDB
Inclui o plug-in para usar o AWS DynamoDB para armazenar dados de associação ao cluster.
Provedores de lembretes
Os pacotes abaixo incluem plugins para lembretes persistentes em várias tecnologias de armazenamento.
Orleans Lembretes do Armazenamento de Tabela do Azure
Install-Package Microsoft.Orleans.Reminders.AzureStorage
Inclui o plug-in para usar as Tabelas do Azure para armazenar lembretes.
Orleans Lembretes ADO.NET Fornecedores
Install-Package Microsoft.Orleans.Reminders.AdoNet
Inclui o plugin para usar ADO.NET para armazenar lembretes em um dos bancos de dados suportados.
Orleans provedor de lembretes para o AWS DynamoDB
Install-Package Microsoft.Orleans.Reminders.DynamoDB
Inclui o plug-in para usar o AWS DynamoDB para armazenar lembretes.
Fornecedores de armazenamento de grãos
Os pacotes abaixo incluem plugins para persistência do estado de grãos 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 Tabelas do Azure ou Blobs do Azure para armazenar o estado de grão.
Orleans Provedores de ADO.NET de persistência
Install-Package Microsoft.Orleans.Persistence.AdoNet
Inclui o plug-in para usar ADO.NET para armazenar o estado de grão em um dos bancos de dados suportados.
Orleans Persistência DynamoDB
Install-Package Microsoft.Orleans.Persistence.DynamoDB
Inclui o plug-in para usar o AWS DynamoDB para armazenar o estado do grão.
Provedores de fluxo
Os pacotes abaixo incluem plugins para a entrega de eventos de streaming.
Orleans Utilitários ServiceBus
Install-Package Microsoft.Orleans.OrleansServiceBus
Inclui o provedor de fluxo para Hubs de Eventos do Azure.
Orleans Streaming do Armazenamento do Azure
Install-Package Microsoft.Orleans.Streaming.AzureStorage
Inclui o provedor de fluxo para Filas do Azure.
Orleans Streaming AWS SQS
Install-Package Microsoft.Orleans.Streaming.SQS
Inclui o provedor de fluxo para o serviço AWS SQS.
Orleans Utilitários do Google Cloud Platform
Install-Package Microsoft.Orleans.OrleansGCPUtils
Inclui o provedor de fluxo para o 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.
Orleans Fornecimento de eventos
Install-Package Microsoft.Orleans.EventSourcing
Contém um conjunto de tipos básicos para criar classes de grãos com estado de origem em eventos.
Desenvolvimento e teste
Orleans Fornecedores
Install-Package Microsoft.Orleans.OrleansProviders
Contém um conjunto de provedores de persistência e fluxo que mantêm os dados na memória. Destinado a testes. Em geral, não é recomendado para uso em produção, a menos que a perda de dados em caso de falha do silo seja aceitável.
Orleans Testando a biblioteca do host
Install-Package Microsoft.Orleans.TestingHost
Inclui a biblioteca para hospedagem de silos e clientes em um projeto de teste.
Serializadores
Orleans Serializador de obrigações
Install-Package Microsoft.Orleans.Serialization.Bond
Inclui suporte para o serializador Bond.
Orleans Utilitários do Google
Install-Package Microsoft.Orleans.OrleansGoogleUtils
Inclui o serializador Google Protocol Buffers.
Orleans Serializador protobuf-net
Install-Package Microsoft.Orleans.ProtobufNet
Inclui a versão protobuf-net do serializador Protocol Buffers.
Telemetria
Orleans Telemetria do Consumidor - Contadores de Desempenho
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters
Implementação de Contadores de Desempenho do Windows da API de Orleans Telemetria.
Orleans Consumidor de Telemetria - Azure Application Insights
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI
Inclui o consumidor de telemetria para o Azure Application Insights.
Orleans Telemetria do Consumidor - NewRelic
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic
Inclui o consumidor de telemetria para NewRelic.
Transações
Orleans Suporte a transações
Install-Package Microsoft.Orleans.Transactions
Inclui suporte para transações de grãos cruzados (beta).
Orleans Transações no Azure
Install-Package Microsoft.Orleans.Transactions.AzureStorage
Inclui um plug-in para manter o log de transações na Tabela do Azure (beta).
Ferramentas
Orleans Ferramenta Contador de Desempenho
Install-Package Microsoft.Orleans.CounterControl
Inclui OrleansCounterControl.exe, que registra categorias de contadores de desempenho do Windows para Orleans estatísticas e classes de grãos implantadas. Requer elevação. Pode ser executado no Azure como parte de uma tarefa de inicialização de função.
