Orleans NuGet paketleri
tüketicileri Orleans , belirli istenen davranışları elde etmek için çeşitli NuGet paketlerine güvenir. Çeşitli ortak paketler ve soyutlamalar ve birçok tek amaçlı paket vardır. Bu makale, geliştiricilerin hangi Orleans paketlerin kullanılması gerektiğini öğrenmesine yardımcı olacak içgörüler sağlar.
Anahtar paketleri
Seçilen iş yüküne bağlı olarak uygulama yazarken Orleans birbirini dışlayan iki NuGet paketinden birine başvurursunuz. Örneğin, silo Orleans yazarken Microsoft'a başvuracaksınız..Orleans. Sunucu NuGet paketi. bir Orleans İstemci uygulaması yazdığınızda Microsoft'a başvuracaksınız..Orleans. İstemci NuGet paketi. Soyutlamalar veya taneli sınıf kitaplıkları gibi tüm Orleans projeler Microsoft..Orleans. Sdk NuGet paketi. Paket Microsoft.Orleans.Sdk hem ve Server paketlerine Client dahil edilir.
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. Müşteri | İstemciye özel paket, istemci için Orleans gereklidir. |
| Microsoft..Orleans. Sdk | Tüm Orleans uygulamalar, sunucu ve istemci paketleri için gereken meta paket bu pakete bağlıdır. |
| Microsoft..Orleans. Sunucu | Sunucuya özel paket, silolar için Orleans gereklidir. |
NuGet paketlerini yükleme hakkında bilgi için aşağıdaki seçeneklere bakın:
Barındırma
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. Hosting.AzureCloudServices | Azure Cloud Services için barındırma yardımcı programları.Orleans |
| Microsoft..Orleans. Hosting.Kubernetes | Orleans Kubernetes için barındırma desteği. |
| Microsoft..Orleans. Çalışma zamanı | Bir silo içinde tanecikleri barındıran ve yürüten çekirdek çalışma zamanı kitaplığı Orleans . |
Kümeleme sağlayıcıları
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. Clustering.AzureStorage | Orleans Azure Tablo Depolama tarafından yedeklenen kümeleme sağlayıcısı. |
| Microsoft..Orleans. Clustering.AdoNet | Orleans ADO.NET tarafından yedeklenen kümeleme sağlayıcısı. |
| Microsoft..Orleans. Clustering.DynamoDB | Orleans kümeleme sağlayıcısı AWS DynamoDB tarafından desteklenir. |
Anımsatıcı sağlayıcıları
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. Hatırlatmalar | Sunucuda kullanılan Microsoft Orleans anımsatıcı kitaplığı. |
| Microsoft..Orleans. Reminders.AzureStorage | Orleans Azure Tablo Depolama tarafından yedeklenen anımsatıcı sağlayıcısı. |
| Microsoft..Orleans. Anımsatıcılar.AdoNet | Orleans ADO.NET tarafından yedeklenen anımsatıcı sağlayıcısı. |
| Microsoft..Orleans. Anımsatıcılar.DynamoDB | Orleans aws DynamoDB tarafından yedeklenen anımsatıcılar sağlayıcısı. |
Tahıl depolama sağlayıcıları
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. Persistence.AdoNet | Orleans kalıcılık sağlayıcısı ADO.NET tarafından yedeklendi. |
| Microsoft..Orleans. Persistence.AzureStorage | Orleans Kalıcılık sağlayıcısı Azure Tablo Depolama tarafından desteklenir. |
| Microsoft..Orleans. Persistence.DynamoDB | Orleans kalıcılık sağlayıcısı AWS DynamoDB tarafından desteklenir. |
| Microsoft..Orleans. Persistence.Memory | için Orleansbellek içi depolama alanı. |
Akış sağlayıcıları
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. Akış | hem istemcide hem de sunucuda kullanılan akış kitaplığı Orleans . |
| Microsoft..Orleans. Streaming.AzureStorage | Orleans Azure Kuyruk Depolama tarafından yedeklenen akış sağlayıcısı. |
| Microsoft..Orleans. Streaming.EventHubs | Orleans Azure Event Hubs tarafından yedeklenen akış sağlayıcısı. |
| Microsoft..Orleans. Streaming.SQS | Orleans AWS SQS tarafından yedeklenen akış sağlayıcısı. |
Ek paketler
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. Analizörleri | için OrleansC# Çözümleyicileri. |
| Microsoft..Orleans. CodeGenerator | için Microsoft.Orleans.Serializationkod oluşturma kitaplığı. |
| Microsoft..Orleans. EventSourcing | Olay kaynaklı duruma sahip tanecikler oluşturmak Orleans için temel türler. |
| Microsoft..Orleans. Connections.Security | içinde OrleansTLS kullanarak güvenlik iletişimi desteği. |
Geliştirme ve test
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. TestingHost | Orleans bir test projesinde silo barındırmak için kitaplık. |
| Microsoft..Orleans. Transactions.TestKit.Base | İşlemler için test seti temel kitaplığı. |
| Microsoft..Orleans. Transactions.TestKit.xUnit | işlemler için xUnit test seti kitaplığı. |
| Microsoft..Orleans. Serialization.TestKit | kullanan Microsoft.Orleans.Serializationprojeler için test seti. |
Seri Hale Getiriciler
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. Seri -leştirme | .NET için hızlı, esnek ve sürüme dayanıklı serileştirici. |
| Microsoft..Orleans. Serialization.Abstractions | için Orleansserileştirme soyutlamaları. |
| Microsoft..Orleans. Serialization.SystemTextJson | System.Text.Jsontümleştirmesi.Microsoft.Orleans.Serialization |
| Microsoft..Orleans. Serialization.FSharp | için Microsoft.Orleans.SerializationF# çekirdek türü desteği. |
| Microsoft..Orleans. Serialization.NewtonsoftJson | Newtonsoft.Jsontümleştirmesi.Microsoft.Orleans.Serialization |
Hareketler
| NuGet paketi | Açıklama |
|---|---|
| Microsoft..Orleans. Hareket | Sunucuda kullanılan çekirdek işlem kitaplığı Orleans . |
| Microsoft..Orleans. Transactions.AzureStorage | Orleans Azure Depolama tarafından yedeklenen işlem depolama sağlayıcısı. |
Araçlar
Popüler Orleans araçlardan biri OrleansDashboard NuGet paketidir. Bu pano, uygulamanızın içinde Orleans neler olduğuna ilişkin bazı basit ölçümler ve içgörüler sağlar. Daha fazla bilgi için bkz . GitHub: Orleans Pano.
Anahtar paketleri
Çoğu senaryoda kullanmanız gereken 5 önemli NuGet paketi vardır:
Orleans Temel Soyutlamalar
Install-Package Microsoft.Orleans.Core.Abstractions
öğesini içerir Orleans. Core.Abstractions.dll, uygulama kodu geliştirmek için gereken genel türleri (taneli arabirimler ve sınıflar) tanımlar Orleans . Bu paket, herhangi bir Orleans proje tarafından doğrudan veya dolaylı olarak başvurulmalıdır. Bunu, ayrıntılı arabirimleri ve sınıfları tanımlayan projelerinize ekleyin.
Orleans derleme zamanı kodu oluşturma
Microsoft..Orleans. OrleansCodeGenerator.Build.
Install-Package Microsoft.Orleans.OrleansCodeGenerator.Build1.2.0'da Orleans göründü. Ayrıntılı arabirimler ve uygulama projeleri için derleme süresi desteği. Taneli başvuruların ve seri hale getiricilerin kod oluşturulmasını sağlamak için bunu tanecik arabirimlerinize ve uygulama projelerinize ekleyin.
Microsoft..Orleans. CodeGenerator.MSBuild.
Install-Package Microsoft.Orleans.CodeGenerator.MSBuild2.1.0'ın Orleansbir parçası olarak göründü. Pakete
Microsoft.Orleans.OrleansCodeGenerator.Buildbir alternatif. Uygulama ikili dosyalarının yüklenmesini önlemek için kod analizi için Roslyn'i kullanır ve artımlı derlemeler desteğini geliştirir ve bu da daha kısa derleme süreleriyle sonuçlanır.
Orleans Sunucu Kitaplıkları
Install-Package Microsoft.Orleans.Server
Kolayca silo oluşturmaya ve başlatmaya yönelik bir meta paket. Aşağıdaki paketleri içerir:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansRuntimeMicrosoft.Orleans.OrleansProviders
Orleans İstemci Kitaplıkları
Install-Package Microsoft.Orleans.Client
Bir istemciyi (ön uç) kolayca oluşturmaya ve başlatmaya yönelik bir Orleans meta paket. Aşağıdaki paketleri içerir:
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansProviders
Orleans Çekirdek Kitaplık
Install-Package Microsoft.Orleans.Core
Uygulama kodu ve Orleans istemcileri (ön uçlar) tarafından kullanılan çoğu Orleans genel tür için uygulama içerir. Türleri kullanan Orleans ancak barındırma veya silolarla ilgilenmeyen kitaplıklar ve istemci uygulamaları oluşturmak için başvuruda bulunur. Microsoft'a dahil..Orleans. İstemci ve Microsoft..Orleans. Sunucu meta paketleri ve diğer paketlerin çoğu tarafından doğrudan veya dolaylı olarak başvurulur.
Barındırma
Orleans Çalışma zamanı
Install-Package Microsoft.Orleans.OrleansRuntime
Silo yapılandırma ve başlatma kitaplığı. Silo konak projenizde buna başvurun. Microsoft'a dahil..Orleans. Sunucu meta paketi.
Orleans Çalışma Zamanı Soyutlamaları
Install-Package Microsoft.Orleans.Runtime.Abstractions
içinde Microsoft.Orleans.OrleansRuntimeuygulanan türler için arabirimler ve soyutlamalar içerir.
Orleans Azure Cloud Services'da barındırma
Install-Package Microsoft.Orleans.Hosting.AzureCloudServices
Siloları ve istemcileri Azure Cloud Services (Çalışan Rolleri ve Orleans Web Rolleri) olarak barındırmak için yardımcı sınıflar içerir.
Orleans Service Fabric Barındırma Desteği
Install-Package Microsoft.Orleans.Hosting.ServiceFabric
Siloları durum bilgisi olmayan bir Service Fabric hizmeti olarak barındırmak için yardımcı sınıflar içerir.
Kümeleme sağlayıcıları
Aşağıdaki paketler çeşitli depolama teknolojilerinde küme üyeliği verilerini kalıcı hale eklemeye yönelik eklentileri içerir.
Orleans Azure Tablo Depolamaları için kümeleme sağlayıcısı
Install-Package Microsoft.Orleans.Clustering.AzureStorage
Küme üyeliği verilerini depolamak için Azure Tablolarını kullanmaya yönelik eklentiyi içerir.
Orleans ADO.NET Sağlayıcıları için kümeleme sağlayıcısı
Install-Package Microsoft.Orleans.Clustering.AdoNet
Desteklenen veritabanlarından birinde küme üyeliği verilerini depolamak için ADO.NET kullanma eklentisini içerir.
Orleans Konsolos Yardımcı Programları
Install-Package Microsoft.Orleans.OrleansConsulUtils
Küme üyeliği verilerini depolamak için Consul'un kullanıldığı eklentiyi içerir.
Orleans ZooKeeper Yardımcı Programları
Install-Package Microsoft.Orleans.OrleansZooKeeperUtils
Küme üyeliği verilerini depolamak için ZooKeeper'ın kullanıldığı eklentiyi içerir.
Orleans AWS DynamoDB için kümeleme sağlayıcısı
Install-Package Microsoft.Orleans.Clustering.DynamoDB
Küme üyeliği verilerini depolamak için AWS DynamoDB'yi kullanmaya yönelik eklentiyi içerir.
Anımsatıcı sağlayıcıları
Aşağıdaki paketler, çeşitli depolama teknolojilerinde anımsatıcıların kalıcı hale eklenmesine yönelik eklentileri içerir.
Orleans Anımsatıcılar Azure Tablo Depolama
Install-Package Microsoft.Orleans.Reminders.AzureStorage
Anımsatıcıları depolamak için Azure Tablolarını kullanmaya yönelik eklentiyi içerir.
Orleans Anımsatıcılar ADO.NET Sağlayıcıları
Install-Package Microsoft.Orleans.Reminders.AdoNet
Anımsatıcıları desteklenen veritabanlarından birinde depolamak için ADO.NET kullanmaya yönelik eklentiyi içerir.
Orleans AWS DynamoDB için anımsatıcı sağlayıcısı
Install-Package Microsoft.Orleans.Reminders.DynamoDB
Anımsatıcıları depolamak için AWS DynamoDB'yi kullanmaya yönelik eklentiyi içerir.
Tahıl depolama sağlayıcıları
Aşağıdaki paketler, çeşitli depolama teknolojilerinde tahıl durumunu kalıcı hale getiren eklentiler içerir.
Orleans Kalıcılık Azure Depolama
Install-Package Microsoft.Orleans.Persistence.AzureStorage
Hububat durumunu depolamak için Azure Tablolarını veya Azure Bloblarını kullanmaya yönelik eklentileri içerir.
Orleans Kalıcılık ADO.NET Sağlayıcıları
Install-Package Microsoft.Orleans.Persistence.AdoNet
Desteklenen veritabanlarından birinde tahıl durumunu depolamak için ADO.NET kullanma eklentisini içerir.
Orleans Kalıcılık DynamoDB
Install-Package Microsoft.Orleans.Persistence.DynamoDB
Tahıl durumunu depolamak için AWS DynamoDB'yi kullanmaya yönelik eklentiyi içerir.
Akış sağlayıcıları
Aşağıdaki paketler akış olaylarını teslim etmek için eklentiler içerir.
Orleans ServiceBus Yardımcı Programları
Install-Package Microsoft.Orleans.OrleansServiceBus
Azure Event Hubs için akış sağlayıcısını içerir.
Orleans Azure Depolama Akışı
Install-Package Microsoft.Orleans.Streaming.AzureStorage
Azure Kuyrukları için akış sağlayıcısını içerir.
Orleans AWS SQS akışı
Install-Package Microsoft.Orleans.Streaming.SQS
AWS SQS hizmeti için akış sağlayıcısını içerir.
Orleans Google Bulut Platformu Yardımcı Programları
Install-Package Microsoft.Orleans.OrleansGCPUtils
GCP PubSub hizmeti için akış sağlayıcısını içerir.
Ek paketler
Orleans Kod Oluşturma
Install-Package Microsoft.Orleans.OrleansCodeGenerator
Çalışma zamanı kod oluşturucusunu içerir.
Orleans Olay Kaynağını Belirleme
Install-Package Microsoft.Orleans.EventSourcing
Olay kaynaklı durumla tanecik sınıfları oluşturmak için bir dizi temel tür içerir.
Geliştirme ve test
Orleans Sağlayıcı
Install-Package Microsoft.Orleans.OrleansProviders
Verileri bellekte tutan bir dizi kalıcılık ve akış sağlayıcısı içerir. Test için tasarlanmıştır. Genel olarak, silo hatası durumunda veri kaybı kabul edilebilir olmadığı sürece üretim kullanımı için önerilmez.
Orleans Konak Kitaplığını Test Etme
Install-Package Microsoft.Orleans.TestingHost
Siloları ve istemcileri bir test projesinde barındırmak için kitaplığı içerir.
Seri Hale Getiriciler
Orleans Bond Seri Hale Getirici
Install-Package Microsoft.Orleans.Serialization.Bond
Bond seri hale getirici desteği içerir.
Orleans Google Yardımcı Programları
Install-Package Microsoft.Orleans.OrleansGoogleUtils
Google Protokol Arabellekleri seri hale getiriciyi içerir.
Orleans protobuf-net Seri Hale Getirici
Install-Package Microsoft.Orleans.ProtobufNet
Protokol Arabellekleri seri hale getiricisinin protobuf-net sürümünü içerir.
Telemetri
Orleans Telemetri Tüketicisi - Performans Sayaçları
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters
Telemetri API'sinin Orleans Windows Performans Sayaçları uygulaması.
OrleansTelemetri Tüketicisi - Azure Uygulaması Lication Insights
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI
Azure Uygulaması lication Insights için telemetri tüketicisini içerir.
Orleans Telemetri Tüketicisi - NewRelic
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic
NewRelic için telemetri tüketicisini içerir.
Hareketler
Orleans İşlem desteği
Install-Package Microsoft.Orleans.Transactions
Çapraz taneli işlemler (beta) desteği içerir.
Orleans Azure'da işlemler
Install-Package Microsoft.Orleans.Transactions.AzureStorage
Azure Tablosu'nda (beta) işlem günlüğünü kalıcı hale gelen bir eklenti içerir.
Araçlar
Orleans Performans Sayacı Aracı
Install-Package Microsoft.Orleans.CounterControl
İstatistikler ve dağıtılan tanecik sınıfları için Orleans Windows performans sayacı kategorilerini kaydeden öğesini içerirOrleansCounterControl.exe. Yükseltme gerektirir. Azure'da rol başlatma görevinin bir parçası olarak yürütülebilir.
