Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
I consumatori di Orleans si basano su vari pacchetti NuGet per ottenere specifici comportamenti desiderati. Esistono diversi pacchetti e astrazioni comuni e molti singoli pacchetti finalizzati a un solo scopo. Questo articolo fornisce informazioni dettagliate che consentono agli sviluppatori di apprendere quali pacchetti Orleans usare.
Pacchetti chiave
Orleans offre diversi pacchetti NuGet per diversi scenari. Quando si compila un Orleans silo (server), riferirsi al pacchetto NuGet Microsoft.Orleans.Server. Il pacchetto server include tutti gli elementi del pacchetto client, quindi i progetti silo possono fungere anche da client senza riferimenti aggiuntivi. Quando si costruisce un'applicazione client autonoma che si connette a un Orleans cluster ma non ospita un silo, fare riferimento al pacchetto NuGet Microsoft.Orleans.Client. Tutti i progetti Orleans, ad esempio astrazioni o librerie di classi di grani, fanno riferimento al pacchetto NuGet Microsoft.Orleans.Sdk. Il pacchetto Microsoft.Orleans.Sdk è incluso sia con il pacchetto Client che con il pacchetto Server.
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. Cliente | Libreria client per la connessione ai Orleans cluster. |
| Microsoft.Orleans. Sdk | Metapacchetto per lo sviluppo granulare, incluso nei pacchetti client e server. |
| Microsoft.Orleans. Server | Libreria server per l'hosting Orleans di silos. |
Per informazioni sull'installazione di pacchetti NuGet, vedere le opzioni seguenti:
Orleans Pannello di controllo
Il dashboard ufficiale Orleans fornisce il monitoraggio e la visualizzazione dei cluster in tempo reale.
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans.Cruscotto | Orleans Dashboard per il monitoraggio e la visualizzazione dei cluster in tempo reale. |
| Microsoft.Orleans.Dashboard.Abstractions | Astrazioni per Orleans dashboard. |
Annotazioni
Per altre informazioni, vedere Orleans Dashboard.
Strumenti
Uno strumento Orleans diffuso è il pacchetto NuGet OrleansDashboard. Questo dashboard fornisce alcune semplici metriche e informazioni dettagliate su ciò che accade all'interno dell'appOrleans. Per altre informazioni, vedere GitHub: Orleans Dashboard.
Ospitalità
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. Hosting.Kubernetes | Supporto di hosting di Orleans per Kubernetes. |
| Microsoft.Orleans. Runtime | Libreria di runtime di base di Orleans che ospita ed esegue grani all'interno di un silo. |
Provider di clustering
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. Clustering.AzureStorage | Provider di clustering Orleans basato su Azure Table Storage. |
| Microsoft.Orleans. Clustering.AdoNet | Provider di clustering Orleans supportato da ADO.NET. |
| Microsoft.Orleans. Clustering.DynamoDB | Provider di Orleans per clustering supportato da AWS DynamoDB. |
| Microsoft.Orleans.Clustering.Cosmos | Orleans fornitore di servizi di clustering supportato da Azure Cosmos DB. |
| Microsoft.Orleans.Clustering.Redis | Orleans provider di clustering supportato da Redis. |
| Microsoft.Orleans.Clustering.Cassandra | Orleans provider di clustering supportato da Apache Cassandra. |
| Microsoft.Orleans. Clustering.Consul | Orleans soluzione di clustering supportata da HashiCorp Consul. |
| Microsoft.Orleans. Clustering.ZooKeeper | Orleans provider di servizi di clustering supportato da Apache ZooKeeper. |
Fornitori di promemoria
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans.Promemoria | Libreria dei promemoria per Microsoft Orleans usata nel server. |
| Microsoft.Orleans. Reminders.AzureStorage | Fornitore di promemoria di Orleans supportato da Archiviazione di tabelle Azure. |
| Microsoft.Orleans. Reminders.AdoNet | Fornitore di promemoria Orleans supportato da ADO.NET. |
| Microsoft.Orleans. Reminders.DynamoDB | Il provider di promemoria Orleans supportato da AWS DynamoDB. |
| Microsoft.Orleans.Reminders.Cosmos | Orleans provider di promemoria supportato da Azure Cosmos DB. |
| Microsoft.Orleans.Reminders.Redis | Orleans provider di promemoria supportato da Redis. |
Provider di archiviazione di grani
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. Persistence.AdoNet | Provider di persistenza di Orleans supportato da ADO.NET. |
| Microsoft.Orleans. Persistence.AzureStorage | Provider di persistenza supportato da Azure Table Storage. |
| Microsoft.Orleans. Persistence.DynamoDB | Provider di persistenza basato su Orleans AWS DynamoDB. |
| Microsoft.Orleans.Persistence.Cosmos | Orleans Provider di persistenza supportato da Azure Cosmos DB. |
| Microsoft.OrleansPersistence.Redis | Orleans provider di persistenza supportato da Redis. |
| Microsoft.Orleans. Persistence.Memory | Archiviazione in memoria per Orleans. |
Provider di directory granulari
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. GrainDirectory.AzureStorage | Orleans provider di directory granulare supportato da Archiviazione tabelle di Azure. |
| Microsoft.Orleans. GrainDirectory.AdoNet | Orleans provider di directory granulare supportato da ADO.NET. |
| Microsoft.Orleans. GrainDirectory.Redis | Orleans fornitore di directory dei grain basato su Redis. |
Fornitori di servizi di streaming
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. Streaming | Libreria di streaming per Orleans usata sia nel client che nel server. |
| Microsoft.Orleans. Streaming.AzureStorage | Provider di streaming Orleans supportato da Azure Queue Storage. |
| Microsoft.Orleans. Streaming.EventHubs | Provider di streaming supportato da Azure Event Hubs Orleans. |
| Microsoft.Orleans. Streaming.SQS | Provider di streaming di Orleans supportato da AWS SQS. |
Pacchetti aggiuntivi
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. Analizzatori | Analizzatori C# per Orleans. |
| Microsoft.Orleans. CodeGenerator | Libreria di generazione di codice per Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. EventSourcing | Tipi di base per la creazione di grani Orleans con stato di origine evento. |
| Microsoft.Orleans. Connections.Security | Supporto per la comunicazione di sicurezza tramite TLS in Orleans. |
| Microsoft.Orleans. BroadcastChannel | Supporto per i canali di trasmissione in Orleans. |
Sviluppo e test
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. TestingHost | Libreria Orleans per l'hosting di un silo in un progetto di testing. |
| Microsoft.Orleans. Transactions.TestKit.Base | Libreria di kit di test di base per le transazioni. |
| Microsoft.Orleans. Transactions.TestKit.xUnit | Libreria di kit di test xUnit per le transazioni. |
| Microsoft.Orleans. Serialization.TestKit | Kit di test per i progetti che usano Microsoft.Orleans.Serialization. |
Serializzatori
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. Serializzazione | Serializzatore veloce, flessibile e a tolleranza di versione per .NET. |
| Microsoft.Orleans. Serialization.Abstractions | Astrazioni di serializzazione per Orleans. |
| Microsoft.Orleans. Serialization.SystemTextJson | Integrazione di System.Text.Json per Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialization.FSharp | Supporto del tipo di core F# per Microsoft.Orleans.Serialization. |
| Microsoft.Orleans. Serialization.NewtonsoftJson | Integrazione di Newtonsoft.Json per Microsoft.Orleans.Serialization. |
| Microsoft.Orleans.Serialization.MessagePack | Integrazione di MessagePack per Microsoft.Orleans.Serialization. |
| Microsoft.Orleans.Serialization.Protobuf | Integrazione di Protocol Buffers (Protobuf) per Microsoft.Orleans.Serialization. |
Transazioni
| Pacchetto NuGet | Descrizione |
|---|---|
| Microsoft.Orleans. Transazioni | Libreria di transazioni di base di Orleans usata nel server. |
| Microsoft.Orleans. Transactions.AzureStorage | Fornitore di archiviazione delle transazioni di Orleans supportato da Archiviazione di Azure. |
Pacchetti chiave
Nella maggior parte degli scenari è necessario usare 5 pacchetti NuGet chiave:
Astrazioni di base di Orleans
Install-Package Microsoft.Orleans.Core.Abstractions
Contiene Orleans.Core.Abstractions.dll, che definisce i tipi pubblici di Orleans necessari per lo sviluppo di codice per le applicazioni (interfacce e classi di grani). A questo pacchetto è necessario fare riferimento direttamente o indirettamente da qualsiasi progetto Orleans. Aggiungerlo ai progetti che definiscono interfacce e classi di grani.
Generazione di codice in fase di compilazione di Orleans
Microsoft.Orleans. OrleansCodeGenerator.Build.
Install-Package Microsoft.Orleans.OrleansCodeGenerator.BuildÈ apparso in Orleans 1.2.0. Supporto in fase di compilazione per interfacce di grani e progetti di implementazione. Aggiungerlo alle interfacce di grani e ai progetti di implementazione per abilitare la generazione di codice di riferimenti di grani e serializzatori.
Microsoft.Orleans. CodeGenerator.MSBuild.
Install-Package Microsoft.Orleans.CodeGenerator.MSBuildÈ apparso come parte di Orleans 2.1.0. Alternativa al pacchetto
Microsoft.Orleans.OrleansCodeGenerator.Build. Sfrutta Roslyn per l'analisi del codice per evitare il caricamento dei file binari dell'applicazione e migliora il supporto per build incrementali, consentendo tempi di compilazione più brevi.
Librerie server di Orleans
Install-Package Microsoft.Orleans.Server
Meta-pacchetto per costruire e avviare facilmente un silo. Include i pacchetti seguenti:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansRuntimeMicrosoft.Orleans.OrleansProviders
Orleans Librerie client
Install-Package Microsoft.Orleans.Client
Meta-pacchetto per semplici operazioni di compilazione e avvio di un client Orleans (front-end). Include i pacchetti seguenti:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansProviders
Libreria Principale Orleans
Install-Package Microsoft.Orleans.Core
Contiene l'implementazione per la maggior parte dei tipi pubblici di Orleans usati dal codice delle applicazioni e dai client Orleans (front-end). Utilizzarlo come riferimento per la creazione di librerie e applicazioni client che utilizzano i tipi di Orleans ma non sono coinvolte nell'hosting o nei silos. Inclusa nei meta-pacchetti Microsoft.Orleans.Client e Microsoft.Orleans.Server. Vi viene fatto riferimento, direttamente o indirettamente, dalla maggior parte degli altri pacchetti.
Ospitalità
Orleans Runtime
Install-Package Microsoft.Orleans.OrleansRuntime
Libreria per la configurazione e l'avvio di un silo. Farvi riferimento nel progetto di hosting silo. Incluso nel meta-pacchetto Microsoft.Orleans.Server.
Orleans Astrazioni di runtime
Install-Package Microsoft.Orleans.Runtime.Abstractions
Contiene interfacce e astrazioni per i tipi implementati in Microsoft.Orleans.OrleansRuntime.
Orleans Hosting nei Servizi Cloud di Azure
Install-Package Microsoft.Orleans.Hosting.AzureCloudServices
Contiene classi di assistenza per l'hosting di silos e client Orleans come Servizi Cloud di Azure (Ruoli di Lavoro e Ruoli Web).
Supporto per l'hosting di Orleans Service Fabric
Install-Package Microsoft.Orleans.Hosting.ServiceFabric
Contiene classi helper per l'hosting di silos come servizio senza stato di Service Fabric.
Provider di clustering
I pacchetti seguenti includono plug-in per rendere persistenti i dati di appartenenza al cluster in varie tecnologie di archiviazione.
Provider di clustering per Archiviazione di Tabelle di AzureOrleans
Install-Package Microsoft.Orleans.Clustering.AzureStorage
Include il plug-in per l'uso di Tabelle di Azure per l'archiviazione dei dati di appartenenza al cluster.
Orleans
Install-Package Microsoft.Orleans.Clustering.AdoNet
Include il plug-in per l'uso di ADO.NET per l'archiviazione dei dati di appartenenza al cluster in uno dei database supportati.
Utilità console di Orleans
Install-Package Microsoft.Orleans.OrleansConsulUtils
Include il plug-in per l'uso di Consul per l'archiviazione dei dati di appartenenza al cluster.
Utilità ZooKeeper di Orleans
Install-Package Microsoft.Orleans.OrleansZooKeeperUtils
Include il plug-in per l'uso di ZooKeeper per l'archiviazione dei dati di appartenenza al cluster.
Provider di clustering per Orleans AWS DynamoDB
Install-Package Microsoft.Orleans.Clustering.DynamoDB
Include il plug-in per l'uso di AWS DynamoDB per l'archiviazione dei dati di appartenenza al cluster.
Fornitori di promemoria
I pacchetti seguenti includono plug-in per rendere persistenti i promemoria in varie tecnologie di archiviazione.
Promemoria di Orleans per Archiviazione tabelle di Azure
Install-Package Microsoft.Orleans.Reminders.AzureStorage
Include il plug-in per l'uso di Tabelle di Azure per l'archiviazione di promemoria.
Promemoria di Orleans per provider ADO.NET
Install-Package Microsoft.Orleans.Reminders.AdoNet
Include il plug-in per l'uso di ADO.NET per l'archiviazione di promemoria in uno dei database supportati.
Provider di promemoria per Orleans AWS DynamoDB
Install-Package Microsoft.Orleans.Reminders.DynamoDB
Include il plug-in per l'uso di AWS DynamoDB per l'archiviazione di promemoria.
Provider di archiviazione di grani
I pacchetti seguenti includono plug-in per rendere persistente lo stato dei grani in varie tecnologie di archiviazione.
Persistenza di Orleans Archiviazione Azure
Install-Package Microsoft.Orleans.Persistence.AzureStorage
Include i plug-in per l'uso di tabelle di Azure o blob di Azure per l'archiviazione dello stato dei grani.
Provider ADO.NET di persistenzaOrleans
Install-Package Microsoft.Orleans.Persistence.AdoNet
Include il plug-in per l'uso di ADO.NET per l'archiviazione dello stato dei grani in uno dei database supportati.
Persistenza per Orleans DynamoDB
Install-Package Microsoft.Orleans.Persistence.DynamoDB
Include il plug-in per l'uso di AWS DynamoDB per l'archiviazione dello stato dei grani.
Fornitori di servizi di streaming
I pacchetti seguenti includono plug-in per la distribuzione di eventi di streaming.
Utilità di ServiceBus Orleans
Install-Package Microsoft.Orleans.OrleansServiceBus
Include il provider di flussi per Hub eventi di Azure.
Streaming Orleans per Archiviazione di Azure
Install-Package Microsoft.Orleans.Streaming.AzureStorage
Comprende il provider di flussi per le Code di Azure.
Streaming di Orleans per AWS SQS
Install-Package Microsoft.Orleans.Streaming.SQS
Include il provider di streaming per il servizio AWS SQS.
Utilità di Google Cloud PlatformOrleans
Install-Package Microsoft.Orleans.OrleansGCPUtils
Includa il provider di stream per il servizio PubSub di GCP.
Pacchetti aggiuntivi
Orleans Generazione del Codice
Install-Package Microsoft.Orleans.OrleansCodeGenerator
Include il generatore di codice di runtime.
Orleans Origine eventi
Install-Package Microsoft.Orleans.EventSourcing
Contiene un insieme di tipi di base per la creazione di classi grain con stato basato su eventi.
Sviluppo e test
Orleans
Install-Package Microsoft.Orleans.OrleansProviders
Contiene un insieme di fornitori di persistenza e streaming che mantengono i dati in memoria. Destinato ai test. In generale è sconsigliabile l'uso in produzione, a meno che non sia accettabile la perdita di dati in caso di errore dei silos.
Libreria di test host di Orleans
Install-Package Microsoft.Orleans.TestingHost
Include la libreria per l'hosting di silos e client in un progetto di test.
Serializzatori
Serializzatore BondOrleans
Install-Package Microsoft.Orleans.Serialization.Bond
Include il supporto per serializzatore Bond.
Orleans Utilità di Google
Install-Package Microsoft.Orleans.OrleansGoogleUtils
Comprende il serializzatore Google Protocol Buffer.
Orleans Serializzatore protobuf-net
Install-Package Microsoft.Orleans.ProtobufNet
Includere la versione protobuf-net del serializzatore di Protocol Buffer.
Telemetria
Consumer di telemetriaOrleans - Contatori delle prestazioni
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters
Implementazione dei contatori delle prestazioni di Windows dell'API di telemetria di Orleans.
Consumer di telemetria di Orleans - Azure Application Insights
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI
Includere il consumer di telemetria per Azure Application Insights.
Consumer di telemetria - Orleans NewRelic
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic
Include il consumer di telemetria per NewRelic.
Transazioni
Orleans Supporto transazioni
Install-Package Microsoft.Orleans.Transactions
Include il supporto per le transazioni tra grani (beta).
Orleans Transazioni su Azure
Install-Package Microsoft.Orleans.Transactions.AzureStorage
Include un plug-in per rendere persistente il log delle transazioni in Tabelle di Azure (beta).
Strumenti
Strumento del Contatore delle Prestazioni Orleans
Install-Package Microsoft.Orleans.CounterControl
Include l'elemento OrleansCounterControl.exe, che registra le categorie di contatori delle prestazioni di Windows per le statistiche Orleans e per le classi di grain distribuite. Richiede l'elevazione. Può essere eseguito in Azure come parte di un'attività di avvio del ruolo.
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
