Klientkonfiguration

Konfigurera en klient för att ansluta till ett kluster av silor och skicka begäranden till korn programmatiskt via en IHostBuilder och flera kompletterande alternativklasser. Precis som siloalternativ följer klientalternativklasserna mönstret Alternativ i .NET.

Konfigurera en klient för att ansluta till ett kluster av silor och skicka begäranden till korn programmatiskt via en ClientBuilder och flera kompletterande alternativklasser. Precis som siloalternativ följer klientalternativklasserna mönstret Alternativ i .NET.

Tips/Råd

Om du bara vill starta en lokal silo och en lokal klient i utvecklingssyfte kan du läsa Konfiguration av lokal utveckling.

Lägg till Microsoft.Orleans. Clustering.AzureStorage NuGet-paket till ditt klientprojekt.

Det finns flera viktiga aspekter av klientkonfigurationen:

• Orleans klustringsinformation
• Klusterprovider
• Applikationsdelar

Exempel på en klientkonfiguration:

var client = new HostBuilder()
    .UseOrleansClient((context, clientBuilder) =>
    {
        clientBuilder.Configure<ClusterOptions>(options =>
        {
            options.ClusterId = "my-first-cluster";
            options.ServiceId = "MyOrleansService";
        })
        .UseAzureStorageClustering(
            options => options.ConfigureTableServiceClient(
                context.Configuration["ORLEANS_AZURE_STORAGE_CONNECTION_STRING"]));
    })
    .Build();

using Orleans.Hosting;

var client = new ClientBuilder()
    .Configure<ClusterOptions>(options =>
    {
        options.ClusterId = "my-first-cluster";
        options.ServiceId = "MyOrleansService";
    })
    .UseAzureStorageClustering(
        options => options.ConnectionString = connectionString)
    .ConfigureApplicationParts(
        parts => parts.AddApplicationPart(
            typeof(IValueGrain).Assembly))
    .Build();

Nu ska vi dela upp de steg som används i det här exemplet:

Orleans klustringsinformation

    .Configure<ClusterOptions>(options =>
    {
        options.ClusterId = "orleans-docker";
        options.ServiceId = "AspNetSampleApp";
    })

Här anger vi två saker:

• ClusterOptions.ClusterId till "my-first-cluster": Detta är ett unikt ID för klustret Orleans. Alla klienter och silor som använder det här ID:t kan kommunicera direkt med varandra. Vissa kan till exempel välja att använda olika ClusterId för varje distribution.
• Från ClusterOptions.ServiceId till "AspNetSampleApp": Detta är ett unikt ID för ditt program som används av vissa leverantörer (t.ex. persistensleverantörer). Det här ID:t bör vara stabilt mellan distributioner.

Klusterprovider

.UseAzureStorageClustering(
    options => options.ConfigureTableServiceClient(connectionString);

.UseAzureStorageClustering(
    options => options.ConnectionString = connectionString)

Klienten identifierar alla tillgängliga gatewayer i klustret med hjälp av den här providern. Flera leverantörer är tillgängliga; här använder vi Azure Table-providern.

Mer information finns i Serverkonfiguration.

Applikationsdelar

.ConfigureApplicationParts(
    parts => parts.AddApplicationPart(
        typeof(IValueGrain).Assembly))
        .WithReferences())

Mer information finns i Serverkonfiguration.