Aracılığıyla paylaş


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

Orleans farklı senaryolar için çeşitli NuGet paketleri sağlar. Silo (sunucu) oluştururken OrleansMicrosoft.Server NuGet paketine başvurun. Sunucu paketi İstemci paketindeki her şeyi içerdiğinden, silo projeleri de ek başvurular olmadan istemci olarak görev yapabilir. Tek başına bir Orleans istemci uygulaması oluşturup bir kümeye bağlanırken ancak bir silo barındırmazken, Microsoft.Orleans.Client NuGet paketine başvurun. Orleans projeler, soyutlamalar veya öğre sınıf kitaplıkları gibi, Microsoft.Orleans.Sdk NuGet paketine referans verir. Paket Microsoft.Orleans.Sdk, hem Client hem de Server paketleriyle birlikte gelir.

NuGet paketi Açıklama
Microsoft..Orleans. Müşteri Orleans kümelerine bağlanmak için istemci kütüphanesi.
Microsoft..Orleans. Sdk Hem İstemci hem de Sunucu paketlerine dahil edilen, tahıl geliştirme için meta paket.
Microsoft.Orleans Sunucu Siloları barındırmak Orleans için sunucu kitaplığı.

NuGet paketlerini yükleme hakkında bilgi için aşağıdaki seçeneklere bakın:

Orleans Pano

Resmi Orleans Pano gerçek zamanlı küme izleme ve görselleştirme sağlar.

NuGet paketi Açıklama
Microsoft..Orleans. Pano Orleans Gerçek zamanlı küme izleme ve görselleştirme için pano.
Microsoft.Orleans.Dashboard.Abstractions Pano için Orleans soyutlamalar.

Uyarı

Daha fazla bilgi için bkz Orleans . Pano.

Araçlar

Popüler Orleans araçlardan biri OrleansDashboard NuGet paketidir. Bu pano, Orleans uygulamanızın içinde neler olduğuna dair bazı basit ölçümler ve içgörüler sağlar. Daha fazla bilgi için bkz . GitHub: Orleans Pano.

Barındırma

NuGet paketi Açıklama
Microsoft..Orleans. Hosting.Kubernetes Orleans Kubernetes için barındırma desteği.
Microsoft.OrleansRuntime Çekirdek çalışma zamanı kitaplığı Orleans, bir silo içinde tanecikleri barındırır ve yürütür.

Kümeleme sağlayıcıları

NuGet paketi Açıklama
Microsoft..Orleans. Clustering.AzureStorage Orleans Azure Tablo Depolama tarafından desteklenen kümeleme sağlayıcısı.
Microsoft..Orleans. Clustering.AdoNet Orleans ADO.NET tarafından desteklenen kümeleme sağlayıcısı.
Microsoft..Orleans. Clustering.DynamoDB Orleans kümeleme sağlayıcısı AWS DynamoDB tarafından desteklenir.
Microsoft.Orleans.Clustering.Cosmos Orleans Azure Cosmos DB tarafından yedeklenen kümeleme sağlayıcısı.
Microsoft.Orleans.Clustering.Redis Orleans Redis tarafından desteklenen kümeleme sağlayıcısı.
Microsoft.Orleans.Clustering.Cassandra Orleans Apache Cassandra tarafından yönetilen kümeleme sağlayıcısı.
Microsoft..Orleans. Clustering.Consul Orleans HashiCorp Consul tarafından yönetilen kümeleme sağlayıcısı.
Microsoft..Orleans. Clustering.ZooKeeper Apache ZooKeeper destekli Orleans kümeleme sağlayıcısı.

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 desteklenen 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ı.
Microsoft..Orleans. Anımsatıcılar.Cosmos Orleans Azure Cosmos DB tarafından yedeklenen anımsatıcılar sağlayıcısı.
Microsoft..Orleans. Anımsatıcılar.Redis Orleans Redis destekli anımsatıcı 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.Cosmos Orleans Azure Cosmos DB tarafından desteklenen kalıcılık sağlayıcısı.
Microsoft.Orleans.Persistence.Redis Orleans Redis tabanlı kalıcılık sağlayıcısı.
Microsoft..Orleans. Persistence.Memory Orleans için bellek içi depolama.

Tahıl rehber sağlayıcıları

NuGet paketi Açıklama
Microsoft..Orleans. GrainDirectory.AzureStorage Orleans Azure Tablo Depolama tarafından desteklenen grain dizin sağlayıcısı.
Microsoft..Orleans. GrainDirectory.AdoNet Orleans ADO.NET destekli grain dizin sağlayıcısı.
Microsoft..Orleans. GrainDirectory.Redis Orleans Redis destekli grain dizin sağlayıcısı.

Akış sağlayıcıları

NuGet paketi Açıklama
Microsoft.Orleans.Yayın İstemci ve sunucuda kullanılan Orleans için akış kitaplığı.
Microsoft..Orleans. Streaming.AzureStorage Orleans Azure Kuyruk Depolama ile desteklenen akış sağlayıcısı.
Microsoft..Orleans. Streaming.EventHubs Orleans Azure Event Hubs tarafından desteklenen akış sağlayıcısı.
Microsoft..Orleans. Streaming.SQS Orleans AWS SQS tarafından desteklenen akış sağlayıcısı.

Ek paketler

NuGet paketi Açıklama
Microsoft.Orleans. Analizörleri Orleans için C# Çözümleyicileri.
Microsoft..Orleans. CodeGenerator Microsoft.Orleans.Serialization için kod oluşturma kitaplığı.
Microsoft..Orleans. EventSourcing Etkinlik kaynaklı duruma sahip tanecikler oluşturmak için temel türler.
Microsoft..Orleans. Connections.Security içinde OrleansTLS kullanarak güvenlik iletişimi desteği.
Microsoft.Orleans.BroadcastChannel Orleans içindeki yayın kanalları için destek.

Geliştirme ve test

NuGet paketi Açıklama
Microsoft..Orleans. TestingHost Orleans bir test projesinde silo barındırmak için kütüphane.
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.

Serileştiriciler

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 Orleans için serileştirme soyutlamaları.
Microsoft..Orleans. Serialization.SystemTextJson System.Text.Json Microsoft.Orleans.Serialization için tümleştirme.
Microsoft.OrleansSerialization.FSharp Microsoft.Orleans.Serialization için F# çekirdek türü desteği.
Microsoft..Orleans. Serialization.NewtonsoftJson Newtonsoft.Json Microsoft.Orleans.Serialization için tümleştirme.
Microsoft.Orleans.Serialization.MessagePack Microsoft.Orleans.Serialization için MessagePack tümleştirmesi.
Microsoft.Orleans.Serialization.Protobuf için Microsoft.Orleans.Serialization Protokol Arabellekleri (Protocol Buffers) tümleştirmesi.

İşlemler

NuGet paketi Açıklama
Microsoft.Orleans.İşlemler Sunucuda Orleans üzerinde kullanılan çekirdek işlem kitaplığı.
Microsoft..Orleans. Transactions.AzureStorage Orleans Azure Depolama ile desteklenen işlemler için depolama sağlayıcısı.

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, tahıl arabirimlerini ve sınıflarını tanımlayan projelerinize ekleyin.

Orleans inşa zamanı kod üretimi

  • Microsoft..Orleans. OrleansCodeGenerator.Build.

    Install-Package Microsoft.Orleans.OrleansCodeGenerator.Build
    

    1.2.0'da Orleans göründü. Tahıl arabirimler ve uygulama projeleri için derleme süresi desteği. Tane referanslarının ve serileştiricilerin kod üretilmesini sağlamak için bunu tane arabirimlerinize ve uygulama projelerinize ekleyin.

  • Microsoft..Orleans. CodeGenerator.MSBuild.

    Install-Package Microsoft.Orleans.CodeGenerator.MSBuild
    

    2.1.0'ın Orleansbir parçası olarak göründü. Microsoft.Orleans.OrleansCodeGenerator.Build paketine bir 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.Abstractions
  • Microsoft.Orleans.Core
  • Microsoft.Orleans.OrleansRuntime
  • Microsoft.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.Abstractions
  • Microsoft.Orleans.Core
  • Microsoft.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.Orleans.İstemci ve Microsoft.Orleans.Sunucu meta-paketlerine dahil edilir 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 edilen 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 Consul 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 Hatırlatı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 Veri Kalıcılığı 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 tahıl 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.

Serileştiriciler

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 serileştiriciyi içerir.

Orleans protobuf-net Serileştirici

Install-Package Microsoft.Orleans.ProtobufNet

Protocol Buffers serileştiricisinin protobuf-net sürümünü içerir.

Telemetri

Orleans Telemetri Tüketicisi - Performans Sayaçları

Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters

Orleans Telemetri API'sinin Windows Performans Sayaçları ile uygulaması.

OrleansTelemetri Tüketicisi - Azure Application 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.

İşlemler

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 işlem günlüğünü kalıcı hale getiren bir eklenti içerir (beta).

Araçlar

Orleans Performans Sayacı Aracı

Install-Package Microsoft.Orleans.CounterControl

İstatistikler ve dağıtılan tanecik sınıfları için Windows performans sayacı kategorilerini kaydeden OrleansCounterControl.exe öğesini içerir Orleans. Yükseltme gerektirir. Azure'da rol başlatma görevinin bir parçası olarak yürütülebilir.