일반적인 구성

다음은 개발 및 프로덕션 배포에 사용할 수 있는 일반적인 구성의 예제입니다.

로컬 개발

자세한 내용은 로컬 개발 구성을 참조하세요.

Azure를 사용한 신뢰할 수 있는 프로덕션 배포

Azure를 사용하는 안정적인 프로덕션 배포의 경우 클러스터 멤버 자격에 Azure Table 옵션을 사용해야 합니다. 이 구성은 온-프레미스 서버, 컨테이너 또는 Azure 가상 머신 인스턴스에 배포하는 일반적인 구성입니다.

DataConnection 문자열의 형식은 Key=Value 쌍의 ; 구분 목록입니다. 다음과 같은 옵션이 지원됩니다.

키	값
DefaultEndpointsProtocol	https
AccountName	<Azure storage account>
AccountKey	<Azure table storage account key>

다음은 Azure Table 스토리지에 대한 DataConnection 문자열의 예제입니다.

"DefaultEndpointsProtocol=https;AccountName=<Azure storage account>;AccountKey=<Azure table storage account key>"

사일로 구성:

const string connectionString = "YOUR_CONNECTION_STRING_HERE";
var silo = new HostBuilder()
    .UseOrleans(builder =>
    {
        builder.Configure<ClusterOptions>(options =>
        {
            options.ClusterId = "Cluster42";
            options.ServiceId = "MyAwesomeService";
        })
        .UseAzureStorageClustering(
            options => options.ConfigureTableServiceClient(connectionString))
        .ConfigureEndpoints(siloPort: 11_111, gatewayPort: 30_000)
        .ConfigureLogging(builder => builder.SetMinimumLevel(LogLevel.Warning).AddConsole())
    })
    .Build();

클라이언트 구성:

const string connectionString = "YOUR_CONNECTION_STRING_HERE";

using var host = Host.CreateDefaultBuilder(args)
    .UseOrleansClient(clientBuilder =>
        clientBuilder.Configure<ClusterOptions>(options =>
        {
            options.ClusterId = "Cluster42";
            options.ServiceId = "MyAwesomeService";
        })
        .UseAzureStorageClustering(
            options => options.ConfigureTableServiceClient(connectionString)))
    .Build();

SQL Server를 사용한 신뢰할 수 있는 프로덕션 배포

SQL Server를 사용하는 안정적인 프로덕션 배포의 경우 SQL Server 연결 문자열을 제공해야 합니다.

사일로 구성:

const string connectionString = "YOUR_CONNECTION_STRING_HERE";
var silo = new HostBuilder()
    .UseOrleans(builder =>
    {
        builder.Configure<ClusterOptions>(options =>
        {
            options.ClusterId = "Cluster42";
            options.ServiceId = "MyAwesomeService";
        })
        .UseAdoNetClustering(options =>
        {
          options.ConnectionString = connectionString;
          options.Invariant = "System.Data.SqlClient";
        })
        .ConfigureEndpoints(siloPort: 11111, gatewayPort: 30000)
        .ConfigureLogging(builder => builder.SetMinimumLevel(LogLevel.Warning).AddConsole())
    })
    .Build();

클라이언트 구성:

const string connectionString = "YOUR_CONNECTION_STRING_HERE";

using var host = Host.CreateDefaultBuilder(args)
    .UseOrleansClient(clientBuilder =>
        clientBuilder.Configure<ClusterOptions>(options =>
        {
            options.ClusterId = "Cluster42";
            options.ServiceId = "MyAwesomeService";
        })
        .UseAdoNetClustering(options =>
        {
          options.ConnectionString = connectionString;
          options.Invariant = "System.Data.SqlClient";
        }))
    .Build();

전용 서버의 클러스터에서 신뢰할 수 없는 배포

안정성이 중요하지 않은 경우 전용 서버 클러스터에서 테스트하려면 Azure Table에 대한 MembershipTableGrain을 활용하고 종속성을 방지할 수 있습니다. 노드 중 하나를 기본 노드로 지정하기만 하면 됩니다.

사일로에서:

var primarySiloEndpoint = new IPEndpoint(PRIMARY_SILO_IP_ADDRESS, 11_111);
var silo = new HostBuilder()
    .UseOrleans(builder =>
    {
        builder
            .UseDevelopmentClustering(primarySiloEndpoint)
            .Configure<ClusterOptions>(options =>
            {
                options.ClusterId = "Cluster42";
                options.ServiceId = "MyAwesomeService";
            })
            .ConfigureEndpoints(siloPort: 11_111, gatewayPort: 30_000)
            .ConfigureLogging(logging => logging.AddConsole())
    })
    .Build();

클라이언트에서:

var gateways = new IPEndPoint[]
{
    new IPEndPoint(PRIMARY_SILO_IP_ADDRESS, 30_000),
    new IPEndPoint(OTHER_SILO__IP_ADDRESS_1, 30_000),
    // ...
    new IPEndPoint(OTHER_SILO__IP_ADDRESS_N, 30_000),
};

using var host = Host.CreateDefaultBuilder(args)
    .UseOrleansClient(clientBuilder =>
        clientBuilder.UseStaticClustering(gateways)
            .Configure<ClusterOptions>(options =>
            {
                options.ClusterId = "Cluster42";
                options.ServiceId = "MyAwesomeService";
            }))
    .Build();