Solidatus.Extensions.Configuration.MongoDb 1.0.1

Solidatus MongoDb Configuration Extensions

This package enables you to add MongoDB as a configuration source for your application, and provides an interface for setting and updating those configuration values in the database.

Installation

Install the package from NuGet.org using your preferred method.

Usage

Adding configuration source

Once installed you can add MongoDB as a configuration source as you add other configuration sources.

MongoClientSettings mongoSettings = new();
string database = "";
string collection = "Config";

Host
  .CreateDefaultBuilder(args)
  .ConfigureAppConfiguration((hostingContext, config) =>
  {
    config.AddMongoDb(mongoSettings, database, collection);
  });

You likely want to use the existing configuration to load up the appropriate values for the mongo settings though. You can accomplish that by extending the above code's app configuration section like so, using your own process for converting your application's configuration into the appropriate MongoClientSettings class.

.ConfigureAppConfiguration((hostingContext, config) =>
{
  config.AddJsonFile("config.jsonc");
  config.AddEnvironmentVariables();
  config.AddCommandLine(args);

  var mongoConfig = config.Build().GetSection("Mongo").Get<MongoConfig>();
  var mongoClientSettings = MongoUtils.GetMongoClientSettings(mongoConfig);

  config.AddMongoDb(mongoSettings, mongoConfig.Database, "Configuration");
}

Updating configuration values

The package provides functions for setting/updating and removing stored configuration values.

MongoConfigurationManager.ClearValue("Config:Key");

MongoConfigurationManager.SetValue("Config:Key", "Value");

Mongo version support

The package uses version 2.26.0 of the MongoDB C# driver. This supports MongoDB versions 3.6 or later, as shown in the MongoDB compatibility docs.