8.1.0-preview

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.1.0-preview - October 24, 2024

Enhancements

• Added support for injecting additional telemetry metadata to feature flags if telemetry is enabled
  • AllocationId represents the version of an allocation on a feature flag. The AllocationId changes when there are essential modifications to the allocation, such as adjustments to the percentile or variant configuration, but not for non-essential changes like feature flag descriptions.

Microsoft.Azure.AppConfiguration.AspNetCore 8.1.0-preview - October 24, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.0-preview. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.1.0-preview - October 24, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.0-preview. See the release notes for more information on the changes.

8.0.0

8.0.0 - October 3rd, 2024

Breaking Changes

• Increased the default maximum retry count when resolving Key Vault references and increased the minimum refresh interval to 1 minute. This helps prevent requests to Key Vault from being throttled and will reduce the chance of failing to resolve a secret due to momentary failures. #589
• Removed .NET 7 as a target framework as .NET 7 is out of support. #567
• The APIs AzureAppConfigurationRefreshOptions.SetCacheExpiration and FeatureFlagOptions.CacheExpirationInterval have been deprecated and will be removed in a future release. They are replaced with AzureAppConfigurationRefreshOptions.SetRefreshInterval and FeatureFlagOptions.SetRefreshInterval, respectively. This change does not affect functionality but aims to eliminate confusion regarding cache expiration implied by the previous API names. #350

Enhancements

• Variant Feature Flags and Telemetry: This is the first stable release with support for the variants, allocation, and telemetry properties for feature flags added by version 4.0.0 of the Microsoft.FeatureManagement.* libraries. While variant feature flags can still be toggled on or off, they also allow for different configurations, ranging from simple primitives to complex JSON objects. Variant feature flags are particularly useful for feature rollouts, configuration rollouts, and feature experimentation (also known as A/B testing).

• This is the first stable release of the load balancing mode introduced in 8.0.0-preview.3. Load balancing enables your application to distribute requests to App Configuration across all available replicas. This enhancement improves the scalability of applications that typically experience high request volumes to App Configuration, ensuring they remain within quota limits. Load balancing mode is off by default and can be activated by setting the new AzureAppConfigurationOptions.LoadBalancingEnabled property to true. #535

• Added the ability to configure options used to connect to Key Vault resources that have no registered SecretClient with the following new API. #274

  public AzureAppConfigurationKeyVaultOptions ConfigureClientOptions(Action<SecretClientOptions> configure)

  This API can be called from within the AzureAppConfigurationOptions.ConfigureKeyVault method.

8.0.0-preview.3

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.0.0-preview.3 - July 18, 2024

Breaking Changes

• Removed .NET 7 as a target framework as .NET 7 is out of support. #567
• The APIs AzureAppConfigurationRefreshOptions.SetCacheExpiration and FeatureFlagOptions.CacheExpirationInterval have been deprecated and will be removed in a future release. They are replaced with AzureAppConfigurationRefreshOptions.SetRefreshInterval and FeatureFlagOptions.SetRefreshInterval, respectively. This change does not affect functionality but aims to eliminate confusion regarding cache expiration implied by the previous API names. #350

Enhancements

• A load balancing mode has been introduced, enabling your application to distribute requests to App Configuration across all available replicas. This enhancement improves the scalability of applications that typically experience high request volumes to App Configuration, ensuring they remain within quota limits. Load balancing mode is off by default and can be activated by setting the new AzureAppConfigurationOptions.LoadBalancingEnabled property to true. #535
• Variant feature flags are now output using the Microsoft feature flag schema v2.0.0, while the output of configuration for classic feature flags remains unchanged. #543

Microsoft.Azure.AppConfiguration.AspNetCore 8.0.0-preview.3 - July 18, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.0.0-preview.3. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.0.0-preview.3 - July 18, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.0.0-preview.3. See the release notes for more information on the changes.

7.3.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 7.3.0 - July 16th, 2024

Enhancements

• Upgraded the package reference for Azure.Security.KeyVault.Secrets to 4.6.0. #572

Bug Fixes

• Loading invalid feature flags should no longer throw an error when TryRefreshAsync is invoked or when the optional argument is true in the AddAzureAppConfiguration method. #551

Microsoft.Azure.AppConfiguration.AspNetCore 7.3.0 - July 16th, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.3.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 7.3.0 - July 16th, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.3.0. See the release notes for more information on the changes.

7.2.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 7.2.0 - May 2, 2024

Enhancements

• Added support for .NET 8 as a target framework. #530
• Improved JSON key-value deserialization. #537
• Updated Azure.Data.AppConfiguration reference to 1.4.1. #514.

Microsoft.Azure.AppConfiguration.AspNetCore 7.2.0 - May 2, 2024

Enhancements

• Added support for .NET 8 as a target framework. #530
• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.2.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 7.2.0 - May 2, 2024

Enhancements

• Added support for .NET 8 as a target framework. #530
• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.2.0. See the release notes for more information on the changes.

8.0.0-preview.2

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.0.0-preview.2 - March 18, 2024

Bug Fixes

• Fixed a bug where a FormatException may be thrown for a variant feature flag when the configuration value was not set to a string or null. With this fix, the configuration value of a variant can be a string, number, boolean, array, or JSON object. #531

Microsoft.Azure.AppConfiguration.AspNetCore 8.0.0-preview.2 - March 18, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.0.0-preview.2. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.0.0-preview.2 - March 18, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.0.0-preview.2. See the release notes for more information on the changes.

8.0.0-preview

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.0.0-preview - February 28, 2024

Enhancements

• Added new fields to feature flag telemetry metadata, including FeatureFlagId, FeatureFlagReference, and ETag. #517

Bug Fixes

• Fixed a bug where a feature flag would not be parsed correctly by the Microsoft.FeatureManagement library if the flag was enabled but had no filters. #525

Microsoft.Azure.AppConfiguration.AspNetCore 8.0.0-preview - February 28, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.0.0-preview. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.0.0-preview - February 28, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.0.0-preview. See the release notes for more information on the changes.

7.1.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 7.1.0 - February 26, 2024

Enhancements

• This is the first stable release of the Replica Auto-Discovery enhancement that was introduced in 7.1.0-preview.

Bug Fixes

• Fixed a bug where the provider would throw a KeyVaultReferenceException instead of retrying for transient errors while connecting to Key Vault during startup, even if the startup timeout had not elapsed. #516

Microsoft.Azure.AppConfiguration.AspNetCore 7.1.0 - February 26, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.1.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 7.1.0 - February 26, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.1.0. See the release notes for more information on the changes.

7.1.0-preview

Microsoft.Extensions.Configuration.AzureAppConfiguration 7.1.0-preview - January 19, 2024

Enhancements

• Replica Auto-Discovery: For App Configuration stores with geo-replication enabled, the provider will now automatically discover any additional replicas and attempt to connect to them when it fails to connect to user-provided endpoints in code. This capability allows applications to leverage geo-replication for enhanced resiliency without code change and redeployment. Replica discovery is enabled by default and can be disabled by setting the new AzureAppConfigurationOptions.ReplicaDiscoveryEnabled property equal to false. #442.

• Added support for the variants, allocation, and telemetry properties for feature flags introduced in version 4.0.0-preview of the Microsoft.FeatureManagement library. #476

Bug Fixes

• Fixed a bug where passing a null value for the key parameter to AzureAppConfigurationRefreshOptions.Register would throw a NullReferenceException. #503
• Fixed a bug with AzureAppConfigurationOptions.Select, FeatureFlagOptions.Select, and AzureAppConfigurationOptions.SelectSnapshot where additional calls with the same filters after the first call were ignored. The provider will now correctly use only the last call with duplicate filters to preserve the expected precedence. #490

Microsoft.Azure.AppConfiguration.AspNetCore 7.1.0-preview - January 19, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.1.0-preview. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 7.1.0-preview - January 19, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.1.0-preview. See the release notes for more information on the changes.

7.0.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 7.0.0 - November 21, 2023

Breaking Changes

• AddAzureAppConfiguration now throws ArgumentException for invalid inputs even if the optional parameter is equal to true. #318

Enhancements

• This is the first stable release of the following API introduced in the 7.0.0-preview release. #387

  public AzureAppConfigurationOptions SelectSnapshot(string name)

• Added support for the requirement_type property for feature flags introduced in version 2.6.0-preview of the Microsoft.FeatureManagement library. #406

• The initial configuration load now uses time-based retries instead of count-based retries in case of failures. The time-based retry often works more effectively in real-world scenarios, making applications more resilient to transient errors during startup. By default, the retry timeout is set to 100 seconds in AzureAppConfigurationOptions.StartupOptions.Timeout, but you can customize it using the following new API. #458

  public AzureAppConfigurationOptions ConfigureStartupOptions(Action<StartupOptions> configure)

• Added netstandard2.1 as a target framework. #482

Microsoft.Azure.AppConfiguration.AspNetCore 7.0.0 - November 21, 2023

• Removed .NET Core 3.1 as a target framework as .NET Core 3.1 is out of support. #482
• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.0.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 7.0.0 - November 21, 2023

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.0.0. See the release notes for more information on the changes.