Orleans의 소비자는 원하는 특정 동작을 달성하기 위해 다양한 NuGet 패키지를 사용합니다. 몇 가지 일반적인 패키지와 추상화 및 여러 개별 단일 용도 패키지가 있습니다. 이 문서에서는 개발자가 사용해야 하는 Orleans 패키지를 학습하는 데 도움이 되는 인사이트를 제공합니다.
주요 패키지
선택한 워크로드에 따라 Orleans 앱을 작성할 때 두 개의 상호 배타적인 NuGet 패키지 중 하나를 참조합니다. 예를 들어 Orleans 사일로를 작성할 때 Microsoft.Orleans.Server NuGet 패키지를 참조하면 됩니다.
Orleans 클라이언트 앱을 작성할 경우 Microsoft.Orleans.Client NuGet 패키지를 참조합니다. 추상화 또는 조직 클래스 라이브러리와 같은 모든 Orleans 프로젝트는 Microsoft.Orleans.Sdk NuGet 패키지를 참조합니다.
Microsoft.Orleans.Sdk 패키지는 Client 및 Server 패키지 모두에 포함됩니다.
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans. 클라이언트 | Orleans 클라이언트에 필요한 클라이언트 전용 패키지입니다. |
| Microsoft.Orleans. Sdk | 모든 Orleans 앱, 서버, 클라이언트 패키지에 필요한 메타패키지는 이 패키지에 따라 달라집니다. |
| Microsoft.Orleans.서버 | Orleans 사일로에 반드시 필요한 서버 전용 패키지입니다. |
NuGet 패키지 설치에 대한 자세한 내용은 다음 옵션을 참조하세요.
호스팅
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans. Hosting.AzureCloudServices | Orleans의 Azure Cloud Services용 호스팅 유틸리티 |
| Microsoft.Orleans. Hosting.Kubernetes | Kubernetes에 Orleans 호스팅 지원 |
| Microsoft.Orleans. 런타임 | 사일로 내에서 그레인을 호스트하고 실행하는 Orleans의 코어 런타임 라이브러리 |
클러스터링 공급자
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans. Clustering.AzureStorage | Azure Table Storage에서 지원되는 Orleans 클러스터링 공급자 |
| Microsoft.Orleans. Clustering.AdoNet | ADO.NET에서 지원되는 Orleans 클러스터링 공급자 |
| Microsoft.Orleans. Clustering.DynamoDB | AWS DynamoDB에서 지원되는 Orleans 클러스터링 공급자 |
미리 알림 제공자
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans. 미리 알림 | 서버에 사용되는 Microsoft Orleans용 미리 알림 라이브러리 |
| Microsoft.Orleans. Reminders.AzureStorage | Azure Table Storage를 기반으로 지원되는 Orleans 미리 알림 공급자 |
| Microsoft.Orleans. Reminders.AdoNet | ADO.NET을 기반으로 하는 Orleans 리마인더 제공자 |
| Microsoft.Orleans. Reminders.DynamoDB | Orleans 알림 서비스 제공자, AWS DynamoDB에서 지원됨. |
곡물 저장 공급자
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans. Persistence.AdoNet | ADO.NET으로 지원되는 지속성 공급자 Orleans |
| Microsoft.Orleans. Persistence.AzureStorage | Azure Table Storage를 백엔드로 사용하는 Orleans 지속성 공급자 |
| Microsoft.Orleans. Persistence.DynamoDB | AWS DynamoDB에서 지원되는 Orleans 지속성 공급자 |
| Microsoft.Orleans.퍼시스턴스.메모리 | Orleans용 메모리 내 스토리지 |
스트림 공급자
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans. 스트리밍 | 클라이언트와 서버 모두에서 사용되는 Orleans의 스트리밍 라이브러리 |
| Microsoft.Orleans. Streaming.AzureStorage | Azure Queue Storage에서 지원되는 Orleans 스트리밍 공급자 |
| Microsoft.Orleans. Streaming.EventHubs | Azure Event Hubs에서 지원되는 Orleans 스트리밍 공급자 |
| Microsoft.Orleans. Streaming.SQS | AWS SQS에서 지원되는 Orleans 스트리밍 공급자 |
추가 패키지
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans. 분석기 | Orleans용 C# 분석기 |
| Microsoft.Orleans. CodeGenerator |
Microsoft.Orleans.Serialization용 코드 생성 라이브러리 |
| Microsoft.Orleans. EventSourcing | 이벤트 소스 상태를 사용하여 Orleans 그레인을 만들기 위한 기본 유형 |
| Microsoft.Orleans. Connections.Security | Orleans에서 TLS를 사용하는 보안 통신 지원 |
개발 및 테스트
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans. TestingHost | Orleans 라이브러리는 테스트 프로젝트에서 사일로를 호스트하기 위한 것입니다. |
| Microsoft.Orleans. Transactions.TestKit.Base | 트랜잭션의 테스트 키트 기본 라이브러리 |
| Microsoft.Orleans. Transactions.TestKit.xUnit | 트랜잭션을 위한 xUnit 테스트 키트 라이브러리 |
| Microsoft.Orleans. Serialization.TestKit |
Microsoft.Orleans.Serialization을 사용하는 프로젝트용 테스트 키트 |
직렬 변환기
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans. 직렬화 | 빠르고 유연하며 버전 독립적인 .NET용 직렬 변환기 |
| Microsoft.Orleans. serialization.Abstractions | Orleans에 대한 직렬화 추상화 |
| Microsoft.Orleans. Serialization.SystemTextJson |
System.Text.Json을 위한 Microsoft.Orleans.Serialization 통합 |
| Microsoft.Orleans. Serialization.FSharp |
Microsoft.Orleans.Serialization에 대한 F# 코어 형식 지원 |
| Microsoft.Orleans. Serialization.NewtonsoftJson |
Newtonsoft.Json을 위한 Microsoft.Orleans.Serialization 통합 |
트랜잭션
| NuGet 패키지 | 설명 |
|---|---|
| Microsoft.Orleans.트랜잭션 | 서버에서 사용되는 Orleans의 핵심 트랜잭션 라이브러리 |
| Microsoft.Orleans. Transactions.AzureStorage | Azure Storage에서 지원되는 Orleans 트랜잭션 스토리지 공급자 |
도구
인기 있는 Orleans 도구는 OrleansDashboard NuGet 패키지입니다. 이 대시보드는 Orleans 앱 내에서 발생하는 상황에 대한 몇 가지 간단한 메트릭과 인사이트를 제공합니다. 자세한 내용은 GitHub: Orleans 대시보드를 참조하세요.
주요 패키지
대부분의 시나리오에서 사용해야 하는 5가지 주요 NuGet 패키지가 있습니다.
Orleans 핵심 추상화
Install-Package Microsoft.Orleans.Core.Abstractions
애플리케이션 코드(그레인 인터페이스 및 클래스)를 개발하는 데 필요한 공개 형식들이 정의된 Orleans.Core.Abstractions.dll이 포함됩니다. 이 패키지는 모든 Orleans 프로젝트에서 직접 또는 간접적으로 참조되어야 합니다. 그레인 인터페이스 및 클래스를 정의하는 프로젝트에 추가합니다.
Orleans 빌드 시간 코드 생성
Microsoft.Orleans. OrleansCodeGenerator.Build.
Install-Package Microsoft.Orleans.OrleansCodeGenerator.BuildOrleans 1.2.0에 표시 곡물 인터페이스 및 구현 프로젝트에 대한 빌드 시간 지원을 제공합니다. 그레인 인터페이스 및 구현 프로젝트에 추가하여 그레인 참조 및 직렬화기의 코드 생성을 사용하도록 설정합니다.
Microsoft.Orleans. CodeGenerator.MSBuild.
Install-Package Microsoft.Orleans.CodeGenerator.MSBuildOrleans 2.1.0의 일부로 표시
Microsoft.Orleans.OrleansCodeGenerator.Build패키지에 대한 대안입니다. 코드 분석에 Roslyn을 활용하여 애플리케이션 이진 파일 로드를 방지하고 증분 빌드에 대한 지원을 개선하므로 빌드 시간이 단축됩니다.
Orleans 서버 라이브러리
Install-Package Microsoft.Orleans.Server
사일로를 쉽게 빌드하고 시작하기 위한 메타 패키지입니다. 다음 패키지를 포함합니다.
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansRuntimeMicrosoft.Orleans.OrleansProviders
Orleans 클라이언트 라이브러리
Install-Package Microsoft.Orleans.Client
Orleans 클라이언트(프런트 엔드)를 쉽게 빌드하고 시작하기 위한 메타 패키지입니다. 다음 패키지를 포함합니다.
Microsoft.Orleans.Core.AbstractionsMicrosoft.Orleans.CoreMicrosoft.Orleans.OrleansProviders
Orleans 핵심 라이브러리
Install-Package Microsoft.Orleans.Core
애플리케이션 코드 및 Orleans 클라이언트(프런트 엔드)에서 사용하는 대부분의 Orleans public 형식에 대한 구현을 포함합니다. Orleans 형식을 사용하지만 호스팅 또는 사일로를 처리하지 않는 라이브러리 및 클라이언트 애플리케이션을 빌드하기 위해 참조합니다. Microsoft.Orleans.Client 및 Orleans.Server 메타 패키지에 포함되며 대부분의 다른 패키지에서 직접 또는 간접적으로 참조됩니다.
호스팅
Orleans 런타임
Install-Package Microsoft.Orleans.OrleansRuntime
사일로를 구성하고 시작하기 위한 라이브러리입니다. 사일로 호스트 프로젝트에서 참조하십시오. Microsoft.Orleans.Server 메타 패키지에 포함되어 있습니다.
Orleans 런타임 추상화
Install-Package Microsoft.Orleans.Runtime.Abstractions
Microsoft.Orleans.OrleansRuntime에서 구현된 형식에 대한 인터페이스 및 추상화가 포함되어 있습니다.
Orleans Azure Cloud Services에서 호스팅
Install-Package Microsoft.Orleans.Hosting.AzureCloudServices
사일로 및 Orleans 클라이언트를 Azure Cloud Services로 호스팅하기 위한 도우미 클래스(작업자 역할 및 웹 역할)를 포함합니다.
Orleans Service Fabric 호스팅 지원
Install-Package Microsoft.Orleans.Hosting.ServiceFabric
사일로를 상태 비저장 Service Fabric 서비스로 호스팅하기 위한 도우미 클래스를 포함합니다.
클러스터링 공급자
아래 패키지에는 다양한 스토리지 기술에서 클러스터 멤버 자격 데이터를 유지하기 위한 플러그 인이 포함됩니다.
Azure Table Storage용 Orleans 클러스터링 공급자
Install-Package Microsoft.Orleans.Clustering.AzureStorage
클러스터 멤버 자격 데이터를 저장하는 데 Azure Tables를 사용하기 위한 플러그 인을 포함합니다.
ADO.NET 공급자용 Orleans 클러스터링 공급자
Install-Package Microsoft.Orleans.Clustering.AdoNet
지원되는 데이터베이스 중 하나에 클러스터 멤버 자격 데이터를 저장하는 데 ADO.NET을 사용하기 위한 플러그 인을 포함합니다.
Orleans 콘술 유틸리티
Install-Package Microsoft.Orleans.OrleansConsulUtils
클러스터 멤버 자격 데이터를 저장하는 데 Consul을 사용하기 위한 플러그 인을 포함합니다.
Orleans ZooKeeper 유틸리티
Install-Package Microsoft.Orleans.OrleansZooKeeperUtils
클러스터 멤버 자격 데이터를 저장하는 데 ZooKeeper를 사용하기 위한 플러그 인을 포함합니다.
AWS DynamoDB용 Orleans 클러스터링 공급자
Install-Package Microsoft.Orleans.Clustering.DynamoDB
클러스터 멤버 자격 데이터를 저장하는 데 AWS DynamoDB를 사용하기 위한 플러그 인을 포함합니다.
미리 알림 제공자
아래 패키지에는 다양한 스토리지 기술에서 미리 알림을 유지하기 위한 플러그 인이 포함됩니다.
Orleans 알림 Azure Table Storage
Install-Package Microsoft.Orleans.Reminders.AzureStorage
미리 알림을 저장하는 데 Azure Tables를 사용하기 위한 플러그 인을 포함합니다.
ADO.NET 공급자 미리 알림
Install-Package Microsoft.Orleans.Reminders.AdoNet
지원되는 데이터베이스 중 하나에 미리 알림을 저장하는 데 ADO.NET을 사용하기 위한 플러그 인을 포함합니다.
AWS DynamoDB용 Orleans 미리 알림 공급자
Install-Package Microsoft.Orleans.Reminders.DynamoDB
미리 알림을 저장하는 데 AWS DynamoDB를 사용하기 위한 플러그 인을 포함합니다.
곡물 저장 공급자
아래 패키지에는 다양한 스토리지 기술에서 그레인 상태를 유지하기 위한 플러그인이 포함됩니다.
Orleans 지속성 Azure Storage
Install-Package Microsoft.Orleans.Persistence.AzureStorage
그레인 상태를 저장하기 위해 Azure Tables 또는 Azure Blobs를 사용하기 위한 플러그인을 포함합니다.
Orleans ADO.NET 지속성 공급자
Install-Package Microsoft.Orleans.Persistence.AdoNet
ADO.NET을 사용하여 지원되는 데이터베이스 중 하나에 그레인 상태를 저장하기 위한 플러그인을 포함합니다.
Orleans 지속성 DynamoDB 데이터베이스 서비스
Install-Package Microsoft.Orleans.Persistence.DynamoDB
조직 상태를 저장하는 데 AWS DynamoDB를 사용하기 위한 플러그 인을 포함합니다.
스트림 공급자
아래 패키지에는 스트리밍 이벤트를 전달하기 위한 플러그 인이 포함됩니다.
Orleans ServiceBus 유틸리티
Install-Package Microsoft.Orleans.OrleansServiceBus
Azure Event Hubs용 스트림 공급자를 포함합니다.
Orleans 스트리밍 애저 스토리지
Install-Package Microsoft.Orleans.Streaming.AzureStorage
Azure Queues용 스트림 공급자를 포함합니다.
Orleans 스트리밍 AWS SQS
Install-Package Microsoft.Orleans.Streaming.SQS
AWS SQS 서비스용 스트림 공급자를 포함합니다.
Orleans Google Cloud Platform 유틸리티
Install-Package Microsoft.Orleans.OrleansGCPUtils
GCP PubSub 서비스용 스트림 공급자를 포함합니다.
추가 패키지
Orleans 코드 생성
Install-Package Microsoft.Orleans.OrleansCodeGenerator
런타임 코드 생성기를 포함합니다.
Orleans 이벤트 소싱
Install-Package Microsoft.Orleans.EventSourcing
이벤트 소싱된 상태를 가진 그레인 클래스를 만들기 위한 기본 타입 세트를 포함합니다.
개발 및 테스트
Orleans 공급자
Install-Package Microsoft.Orleans.OrleansProviders
메모리에 데이터를 유지하는 지속성 및 스트림 공급자 세트를 포함합니다. 테스트용입니다. 일반적으로, 사일로 오류로 인한 데이터 손실이 허용될 수 있는 경우가 아니라면 프로덕션에 사용하지 않는 것이 좋습니다.
Orleans 테스트 호스트 라이브러리
Install-Package Microsoft.Orleans.TestingHost
테스트 프로젝트에서 사일로 및 클라이언트를 호스팅하기 위한 라이브러리를 포함합니다.
직렬 변환기
Orleans Bond 직렬 변환기
Install-Package Microsoft.Orleans.Serialization.Bond
Bond 직렬 변환기에 대한 지원이 포함됩니다.
Orleans Google 유틸리티
Install-Package Microsoft.Orleans.OrleansGoogleUtils
Google 프로토콜 버퍼 직렬화 도구를 포함합니다.
Orleans protobuf-net 직렬 변환기
Install-Package Microsoft.Orleans.ProtobufNet
이 항목은 프로토콜 버퍼 직렬화기의 protobuf-net 버전을 포함하고 있습니다.
원격 측정
Orleans 원격 진단 사용자 - 성능 카운터
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.Counters
Orleans 원격 분석 API의 Windows 성능 카운터 구현입니다.
Orleans 원격 분석 소비자 - Azure Application Insights
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.AI
Azure Application Insights용 원격 분석 소비자를 포함합니다.
Orleans 원격 분석 테넌트 - NewRelic
Install-Package Microsoft.Orleans.OrleansTelemetryConsumers.NewRelic
NewRelic용 원격 분석 수집기를 포함합니다.
트랜잭션
Orleans 트랜잭션 지원
Install-Package Microsoft.Orleans.Transactions
크로스-그레인 트랜잭션(베타)에 대한 지원을 포함합니다.
Azure의 Orleans 트랜잭션
Install-Package Microsoft.Orleans.Transactions.AzureStorage
Azure Table(베타)에서 트랜잭션 로그를 유지하기 위한 플러그 인을 포함합니다.
도구
Orleans 성능 카운터 도구
Install-Package Microsoft.Orleans.CounterControl
Windows 성능 카운터 범주를 OrleansCounterControl.exe 통계 및 배포된 곡물 클래스에 대해 등록하는 Orleans가 포함되어 있습니다. 권한 상승이 필요합니다. 역할 시작 작업의 일부로 Azure에서 실행할 수 있습니다.
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
.NET