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
The following table lists the currently available default *Microsoft.Azure.Functions.ExtensionBundle* bundles, defined using version ranges and with links to the extension definitions for the bundle.
31
+
### Supported extension bundles
32
+
33
+
The following table lists the default `Microsoft.Azure.Functions.ExtensionBundle` bundles that are currently generally available (GA).
30
34
31
35
| Bundle version | Version in host.json | Included extensions |
32
36
| --- | --- | --- |
@@ -35,12 +39,34 @@ The following table lists the currently available default *Microsoft.Azure.Funct
35
39
| 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. |
36
40
| 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. |
37
41
42
+
The default extension bundles are defined using version ranges, and this table links to the extension definitions for the bundle. For a complete list of extension bundle releases and extension versions in each release, see the [extension bundles release page](https://github.com/Azure/azure-functions-extension-bundles/releases).
43
+
44
+
### Extension bundles considerations
45
+
38
46
Keep these considerations in mind when working with extension bundles:
39
47
40
48
+ When possible, you should set a `version` range value in *host.json* from this table, such as `[4.0.0, 5.0.0)`, instead of defining a custom range.
41
49
+ Use the latest version range to obtain optimal app performance and access to the latest features.
42
50
43
-
For a complete list of extension bundle releases and extension versions in each release, see the [extension bundles release page](https://github.com/Azure/azure-functions-extension-bundles/releases).
51
+
### Preview extension bundles
52
+
53
+
Prerelease versions of specific binding extensions are frequently made available in preview extension bundles. These preview extension bundles, which have an ID of `Microsoft.Azure.Functions.ExtensionBundle.Preview`, allow you to take advantage of new extension behaviors before they are declared as GA. Keep these considerations in mind when choosing to use a non-GA extension bundle:
54
+
55
+
+ Preview bundles can include features that are still under development and not yet ready for production use.
56
+
+ Breaking changes occur between preview versions without prior notice, which can include changes to:
57
+
+ Trigger and binding definitions
58
+
+ Extensions included in the preview
59
+
+ Performance characteristics and stability
60
+
+ Security updates might require you to upgrade versions.
61
+
+ You must completely test preview bundles in nonproduction environments and avoid using preview bundles in production. When you must use a preview bundle in production, take these extra precautions:
62
+
+ Pin your bundle to a specific well-tested bundle version instead of to a range. Pinning prevents automatic upgrading of your bundle version before you have a chance to verify the update in a nonproduction environment.
63
+
+ Move your app to using a GA bundle version as soon as the functionality becomes available in a fully supported bundle release.
64
+
+ To stay informed about bundle updates, including moving from preview to GA, you should:
65
+
+ Monitor preview bundle version releases on the [extension bundles release page](https://github.com/Azure/azure-functions-extension-bundles/releases). - Releases · Azure/azure-functions-extension-bundles
66
+
+ Monitor [extension specific reference documentation](./functions-triggers-bindings.md).
67
+
+ Review the NuGet package versions of specific preview extensions you're using.
68
+
+ Track significant updates or changes on the change logs published on NuGet.org for each preview extension.
0 commit comments