/Microsoft.Extensions.Configuration.AzureBlob

Centralized app settings based on Azure Blob

Primary LanguageC#

Microsoft.Extensions.Configuration.AzureBlob

Nuget

Azure blob configuration provider implementation for Microsoft.Extensions.Configuration.

With this extension, multiple instances can share the application settings saved in Azure Blob, and below functionalities are supported:

  • integrated with ASP .NET Core framework.
  • auto reload for configuration updates. (NOTE: require to work with IOptionsSnapshot)
  • version control with the git repo.
  • high avalibility as the configuration is stored at Azure Blob.

Workflow

Usage

Install package:

dotnet add package AzureBlobConfigurationExtension

Code sample:

using Microsoft.Extensions.Configuration.AzureBlob;

Configuration = new ConfigurationBuilder()
                .AddBlobJson(new BlobJsonConfigurationOption
                {
                    BlobUri = "{the_blob_uri}",
                    ReloadOnChange = true,
                    LogReloadException = e => logger.LogError(e, e.Message),
                    ActionOnReload = () => logger.LogInformation("Reloaded.")
                })
                .Build();

If the provided blob is:

  • public => the blob will be accessed directly.
  • private with SAS token => the blob will be accessed by the SAS token.
  • private without SAS token => the blob will be accessed by MSI/AAD automatically.