|
2 | 2 | title: Azure Functions Extension Bundles
|
3 | 3 | description: Learn how to use extension bundles to make the correct set of Azure Functions trigger and binding extensions available in your non-.NET function code.
|
4 | 4 | ms.topic: concept-article
|
5 |
| -ms.date: 05/30/2025 |
| 5 | +ms.date: 07/25/2025 |
6 | 6 |
|
7 | 7 | #Customer intent: I want to understand how to correctly install extension bundles so that the functionality implemented in the extensions is available to my functions in my preferred development language.
|
8 | 8 | ---
|
@@ -46,6 +46,19 @@ Keep these considerations in mind when you work with extension bundles:
|
46 | 46 | - Use the latest version range to obtain optimal app performance and access to the latest features.
|
47 | 47 | - In the unlikely event that you can't use an extension bundle, you must instead [explicitly install extensions](./functions-bindings-register.md#explicitly-install-extensions).
|
48 | 48 |
|
| 49 | +## Upgrade extension bundles |
| 50 | + |
| 51 | +It's important to keep your bundle version up-to-date so that your apps can continue to be eligible for new features, security patches, and performance optimizations. |
| 52 | + |
| 53 | +To upgrade your app to the most recent bundle, edit the host.json file in the root of your app project. Replace the value of `extensionBundle.version` with the most recent [supported extension bundles version](#supported-extension-bundles). |
| 54 | + |
| 55 | +Keep these considerations in mind when upgrading the extension bundle version used by your app: |
| 56 | + |
| 57 | ++ Always verify your app locally after upgrading the bundle version to ensure compatibility with the updated extensions. You can use the [func start](functions-core-tools-reference.md#func-start) command in Azure Functions Core Tools or F5 in Visual Studio or Visual Studio Code to run your function app locally. |
| 58 | ++ The way that you trigger extensions to be updated based on changes to the bundle version in the host.json file depends on your app environment: |
| 59 | + + Local project: extensions are updated locally when Core Tools starts, either from the `func start` command or when debugging in your development tools. |
| 60 | + + Function app: extensions are updated when you deploy the updated host.json file to your function app in Azure. |
| 61 | + |
49 | 62 | ## Previewing extension bundles
|
50 | 63 |
|
51 | 64 | Prerelease versions of specific binding extensions are maintained in a preview extension bundle: `Microsoft.Azure.Functions.ExtensionBundle.Preview`. You can use this preview extension bundle to take advantage of preview extensions and new behaviors in existing extensions before they reach general availability (GA).
|
|
0 commit comments