IConfiguration support for Azure Cosmos DB Clustering Provider

[OmnipotentOwl]

PR Classification

New feature: Introduce support for Cosmos DB clustering provider for Orleans via Microsoft.Extensions.Configuration.

PR Summary

This pull request supports the Cosmos DB clustering provider for Orleans to be configured via Microsoft.Extensions.Configuration, enabling clustering configurations for both Silo and Client roles.

• CosmosClusteringProviderBuilder.cs: Implemented the CosmosClusteringProviderBuilder class and registered it as a provider.
• CosmosClusteringOptions.cs: Introduced CosmosClusteringOptions and a validator class.
• AssemblyInfo.cs: Added [assembly: InternalsVisibleTo("Tester.AzureUtils")] attribute.

Microsoft Reviewers: Open in CodeFlow

[OmnipotentOwl]

@dotnet-policy-service agree

[ReubenBond]

Is this ready for review?

[Copilot]

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

[OmnipotentOwl]

@ReubenBond I believe it is, however I would want to run the pipelines again to ensure there aren't any hidden issues.

[ReubenBond]

@OmnipotentOwl I rebased and am re-running workflows. Ideally, we should update the tests to use this new configuration mechanism

[OmnipotentOwl]

@ReubenBond, I did some local testing with Aspire with the clustering configuration, and it looks to work mostly for the Cosmos DB emulator (next). I did have to adjust the assembly: RegisterProvider name property based on what I saw in Aspire, but if you feel like we shouldn't rename that or name it just 'Cosmos,' then we might need to do a shim in Aspire to handle that difference.

I am going to see if I can run it tomorrow against a real Cosmos DB instance and if that looks good I may have another PR here shortly for the storage provider.

[ReubenBond]

LGTM - I tested with Aspire, using this config:

var builder = DistributedApplication.CreateBuilder(args);

var cosmosDb = builder.AddAzureCosmosDB("cosmos-clustering").RunAsEmulator();
var db = cosmosDb.AddCosmosDatabase("Orleans").AddContainer("OrleansCluster", "/ClusterId");

var orleans = builder.AddOrleans("cluster")
    .WithClustering(cosmosDb);

builder.AddProject<DashboardToy_Frontend>("frontend")
    .WithReference(orleans)
    .WithReference(db)
    .WaitFor(db)
    .WaitFor(cosmosDb)
    .WithReplicas(5);

builder.Build().Run();

[ReubenBond]

It did not work with the vNext emulator for me - seemingly due to this issue, based on the error message: Azure/azure-cosmos-db-emulator-docker#170