Edit

Share via


Support policy for Azure App Configuration client libraries

This document outlines the support policy for Azure App Configuration client libraries. The policy is aligned with the Azure SDK Support Policy and it applies to all programming languages. For the list of libraries in scope, see existing releases. This policy excludes libraries for the Java Spring framework which are governed by the Azure Spring support policy outlined here and here.

Key terms

  • Active Support: During this phase, a major version receives regular updates, including new features, bug fixes, and security patches.
  • Deprecation Mode: In this phase, a major version receives only critical bug fixes and security updates. No new features are introduced.

Support lifecycle

Each major version of Azure App Configuration libraries follows this support lifecycle:

  • Active Support Period: A minimum of 12 months from the release date of the major version. During this time, the library is fully supported with updates and enhancements.
  • Deprecation Mode: Begins either:
    • Upon the release of the next major version, or
    • At the end of the 12-month active support period, whichever occurs later. Deprecation mode lasts for at least 12 months, focusing on critical bug fixes and security updates.
  • Out of Support: After the deprecation mode period ends, the major version is no longer supported. No further updates, including bug fixes or security patches, will be provided. Customers are encouraged to upgrade to a supported version.

This ensures a minimum of 24 months of total support from the release date of each major version, with at least 12 months of active support followed by at least 12 months of maintenance.

Example lifecycle

For illustration:

  • Microsoft.Extensions.Configuration.AzureAppConfiguration 8.x.x:
    • Released: October 9, 2024
    • Active Support: Until at least October 9, 2025 (12 months)
    • Deprecation Mode: Begins October 9, 2025, or upon release of 9.x (whichever is later), lasting at least 12 months
    • Out of Support: After deprecation mode ends (e.g., October 9, 2026, or later if 9.x is released after October 9, 2025)

Existing releases

For major versions released prior to the adoption of this policy, a grace period will be enacted. Any major version currently in deprecation mode as of the announcement of this policy will receive at least 12 months of maintenance support starting from May 20, 2025.

Configuration providers

Microsoft.Azure.AppConfiguration.AspNetCore
Version Release Date Deprecation Mode Start Date Out of Support Start Date
8.x.x October 9, 2024 -- --
7.x.x November 21, 2023 November 21, 2024 May 20, 2026*
6.x.x March 28, 2023 March 28, 2024 March 28, 2025
Microsoft.Azure.AppConfiguration.Functions.Worker
Version Release Date Deprecation Mode Start Date Out of Support Start Date
8.x.x October 9, 2024 -- --
7.x.x November 21, 2023 November 21, 2024 May 20, 2026*
6.x.x March 28, 2023 March 28, 2024 March 28, 2025
Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration
Version Release Date Deprecation Mode Start Date Out of Support Start Date
3.x.x April 12, 2023 -- --
Microsoft.Extensions.Configuration.AzureAppConfiguration
Version Release Date Deprecation Mode Start Date Out of Support Start Date
8.x.x October 9, 2024 -- --
7.x.x November 21, 2023 November 21, 2024 May 20, 2026*
6.x.x March 28, 2023 March 28, 2024 March 28, 2025

Feature management

Microsoft.FeatureManagement
Version Release Date Deprecation Mode Start Date Out of Support Start Date
4.x.x November 1, 2024 -- --
3.x.x October 27, 2023 November 1, 2024 May 20, 2026*
2.x.x February 27, 2020 October 27, 2023 October 27, 2024
Microsoft.FeatureManagement.AspNetCore
Version Release Date Deprecation Mode Start Date Out of Support Start Date
4.x.x November 1, 2024 -- --
3.x.x October 27, 2023 November 1, 2024 May 20, 2026*
2.x.x February 27, 2020 October 27, 2023 October 27, 2024

This table lists the highest out-of-support version for any given library. Any existing library version lower than the ones listed here is considered to be out of support.

* Dates marked with an asterisk '*' denote an extension due to the initial announcement grace period.
** The aforementioned grace period does not apply to the Kubernetes configuration provider.

Using unsupported versions

If you are using a version of an Azure App Configuration client library that is no longer supported we strongly recommend upgrading to a supported version to benefit from the latest features, bug fixes, and security updates.

Tip

To ensure continued support and access to the latest improvements, check the release notes for the latest supported versions of Azure App Configuration client libraries. To check the release notes see configuration providers and feature management.