You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-functions/extension-bundles.md
+17-16Lines changed: 17 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,16 +27,18 @@ You define an extension bundle reference in the *host.json* project file by addi
27
27
28
28
## Supported extension bundles
29
29
30
-
This table lists the default `Microsoft.Azure.Functions.ExtensionBundle`bundles that are currently GA and any known end-of-support dates.
30
+
This table lists all `Microsoft.Azure.Functions.ExtensionBundle`bundle versions and the current [support status](#support-policy).
31
31
32
-
| Bundle version | Version in host.json |Included extensions| End-of-support date |
32
+
| Bundle version | Version in host.json |Support state| End-of-support date |
33
33
| --- | --- | --- | --- |
34
-
|4.x |`[4.0.0, 5.0.0)`| See [extensions.json](https://github.com/Azure/azure-functions-extension-bundles/blob/main/src/Microsoft.Azure.Functions.ExtensionBundle/extensions.json)used to generate the bundle.| Not yet determined |
35
-
|3.x |`[3.3.0, 4.0.0)`| See [extensions.json](https://github.com/Azure/azure-functions-extension-bundles/blob/main-v3/src/Microsoft.Azure.Functions.ExtensionBundle/extensions.json)used to generate the bundle.| 05/30/2026 |
36
-
|2.x |`[2.*, 3.0.0)`| See [extensions.json](https://github.com/Azure/azure-functions-extension-bundles/blob/main-v2/src/Microsoft.Azure.Functions.ExtensionBundle/extensions.json)used to generate the bundle.| 05/30/2026 |
37
-
|1.x |`[1.*, 2.0.0)`| See [extensions.json](https://github.com/Azure/azure-functions-extension-bundles/blob/v1.x/src/Microsoft.Azure.Functions.ExtensionBundle/extensions.json)used to generate the bundle.| 05/30/2026 |
34
+
|[4.x](https://github.com/Azure/azure-functions-extension-bundles/blob/main/src/Microsoft.Azure.Functions.ExtensionBundle/extensions.json)|`[4.0.0, 5.0.0)`| Active| Not yet determined |
The default extension bundles are defined using version ranges, and this table links to the extension definitions for the bundle. For more information, see [Support policy](#support-policy).
39
+
The default extension bundles are defined using version ranges. Select the **Bundle version** to see the _extensions.json_ definition file used to generate the current major extension bundle version.
40
+
41
+
For more information, see [Support policy](#support-policy).
40
42
41
43
## Extension bundles considerations
42
44
@@ -69,19 +71,18 @@ Keep these considerations in mind when choosing to use a non-GA extension bundle
69
71
70
72
## Support policy
71
73
72
-
Major version releases of extension bundles can occur when there are breaking changes or updates in the dependencies of the underlying binding extensions. These breaking changes, often introduced in Azure SDKs, require updates to the bundle to remain compatible.
73
-
74
-
Each major version of an extension bundle is supported for a minimum of 12 months after the next major version is released. This overlap period gives you time to plan, test, and upgrade your apps before the previous version is retired.
74
+
Major version releases of extension bundles can occur when there are breaking changes or updates in the dependencies of the underlying binding extensions. These breaking changes, often introduced in Azure SDKs, require updates to the bundle to remain compatible.
75
75
76
76
You can view the extension bundle versions and their included extensions in the [Azure Functions Extension Bundles GitHub repo](https://github.com/Azure/azure-functions-extension-bundles/releases). Individual .NET packages are found on [https://nuget.org](https://nuget.org).
77
77
78
-
### Notification phase
79
-
80
-
Microsoft provides advance notice before retiring an extension bundle or binding extension version. When you receive such a notification, you should begin planning to upgrade your function apps to a latest supported extension bundle version. This upgrade ensures that your apps continue to access new features, performance improvements, and support.
81
-
82
-
### Retirement phase
78
+
The removal of support for previously GA bundles follows these phases:
83
79
84
-
After the retirement of an extension bundle or binding extension version, function apps that use retired versions can still be created and deployed and continue to run on the platform. However, your function apps aren’t eligible for new features, security patches, and performance optimizations until you upgrade them to use a supported extension bundle version. You must upgrade your functions apps to a supported bundle version before you can receive support.
80
+
| Phase | Description |
81
+
| ----- | ----- |
82
+
| Active | This is the latest GA extension bundle version, and it is the recommended version for your function apps. Bundle versions remain active for at least 12 months after being declared GA. |
83
+
| Notification| Microsoft provides advanced notice before retiring an extension bundle or binding extension version. When you receive such a notification, you should begin planning to upgrade your function apps to a latest supported extension bundle version. This upgrade ensures that your apps continue to access new features, performance improvements, and support. |
84
+
| Deprecation phase | Occurs 12 months after the next major version of an extension bundle moves into GA. This overlap period gives you time to plan, test, and upgrade your apps before the previous version is retired. |
85
+
| Retirement phase | After the retirement of an extension bundle or binding extension version, function apps that use retired versions can still be created and deployed and continue to run on the platform. However, your function apps aren’t eligible for new features, security patches, and performance optimizations until you upgrade them to use a supported extension bundle version. You must upgrade your functions apps to a supported bundle version before you can receive support.|
0 commit comments