.Net Core Configuration Provider that allows developers to use Google Cloud Firestore as a Configuration Source in their applications including support for secrets stored in Google Cloud SecretManager.

  public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureAppConfiguration((hostContext, config) =>
            {
              config.AddFirestoreConfiguration();
            })            
            .ConfigureWebHostDefaults(webBuilder =>
            {
              webBuilder.UseStartup<Startup>();
            });
  }

For the first time, this package automatically load the appsettings.json file into a Firestore Document named as the application.

Also a Stages collection will be created with an empty Document named as the current environment.

The provider will be listening for changes in these documents:

1. ApplicationSettings/{applicationName}
2. ApplicationSettings/{applicationName}/Stages/{stageName}
3. ApplicationSettings/{applicationName}/Stages/{stageName}/Tags/{tag}

When a change is made in any document, the provider reload the configuration from general to particular (Application -> Stage -> Tag).

Since the settings are loaded from Firestore into the Application Configuration they will be available through the IConfiguration interface at Startup, just like the settings declared in environment variables or appsettings.json file.

If any setting has a value begining with 'secret:' then this package will try to resolve the secret value from Google Cloud Secret Manager.

The value should have this structure: secret:projectId:secretName:secretVersion

Alternatively support this structure: secret::secretName where the projectId is the same as the Firestore service and the secretVersion is "latest".

Permission Roles

• Firestore: Cloud Datastore User
• SecretManager: Secret Manager Secret Accessor

In some scenarios you need to access a configuration value inmediately but the remote nature of this provider takes a bit more time than the local settings providers.

You could use the IConfiguration extension method WaitForFirestoreLoad to wait for complete configuration loading:

    public IConfiguration Configuration { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        Configuration.WaitForFirestoreLoad();
        ...
    }