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
A function app runs on a specific version of the Azure Functions runtime. By default, function apps are created in latest 4.x version of the Functions runtime. Apps are only supported when running on a [supported major version](functions-versions.md). This article explains how to configure a function app in Azure to target, or _pin_ to, a specific version when required.
14
-
15
-
>[!IMPORTANT]
16
-
>When possible, you should always run your functions on the latest supported version of the Azure Functions runtime. You should only pin your app to a specific version when instructed to do so because of an issue in the latest version. You should always move up to the latest runtime version as soon as your functions can run correctly.
13
+
A function app runs on a specific version of the Azure Functions runtime. By default, function apps are created in latest 4.x version of the Functions runtime. Your function apps are only supported when running on a [supported major version](functions-versions.md). This article explains how to configure a function app in Azure to target, or _pin_ to, a specific version when required.
17
14
18
15
::: zone pivot="platform-windows"
19
16
The way that you target a specific version depends on whether you're running Windows or Linux. This version of the article supports Windows. Choose your operating system at the top of the article.
20
17
::: zone-end
21
18
::: zone pivot="platform-linux"
22
19
The way that you target a specific version depends on whether you're running Windows or Linux. This version of the article supports Linux. Choose your operating system at the top of the article.
23
-
::: zone-end
24
-
During local development, your installed version of Azure Functions Core Tools must match major runtime version targeted in Azure. For more information, see [Core Tools versions](functions-run-local.md#v2).
20
+
::: zone-end
21
+
>[!IMPORTANT]
22
+
>When possible, you should always run your functions on the latest supported version of the Azure Functions runtime. You should only pin your app to a specific version when instructed to do so because of an issue in the latest version. You should always move up to the latest runtime version as soon as your functions can run correctly.
23
+
24
+
During local development, your installed version of Azure Functions Core Tools must match major runtime version used by the function app in Azure. For more information, see [Core Tools versions](functions-run-local.md#v2).
25
25
26
26
## Update your runtime version
27
27
@@ -88,7 +88,7 @@ Replace `<FUNCTION_APP>` with the name of your function app and `<RESOURCE_GROUP
88
88
89
89
Azure Functions lets you use the `FUNCTIONS_EXTENSION_VERSION` application setting to target the runtime version used by a given function app. When you specify only the major version (`~4`), the function app is automatically updated to new minor versions of the runtime when they become available. Minor version updates are done automatically because new minor versions shouldn't introduce breaking changes.
90
90
::: zone pivot="platform-linux"
91
-
Linux apps use the [`linuxFxVersion` site setting](./functions-app-settings.md#linuxfxversion) along with `FUNCTIONS_EXTENSION_VERSION` to determine the correct Linux base image in which to run your functions. When you specify a value of `~4` for `FUNCTIONS_EXTENSION_VERSION`, the runtime automatically chooses the latest base image for you based on the runtime version of your language stack.
91
+
Linux apps use the [`linuxFxVersion` site setting](./functions-app-settings.md#linuxfxversion) along with `FUNCTIONS_EXTENSION_VERSION` to determine the correct Linux base image in which to run your functions. When you create a new funtion app on Linux, the runtime automatically chooses the correct base image for you based on the runtime version of your language stack.
92
92
::: zone-end
93
93
Pinning to a specific runtime version causes your function app to restart.
Copy file name to clipboardExpand all lines: includes/functions-migrate-apps.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ ms.date: 03/12/2024
6
6
ms.author: glenga
7
7
---
8
8
9
-
When your app has existing functions, you must take precautions before moving to a later runtime version. The following articles detail breaking changes between versions, including language-specific breaking changes. They also provide you with step-by-step instructions for a successful migration of your existing function app.
9
+
When your app has existing functions, you must take precautions before moving to a later major runtime version. The following articles detail breaking changes between major versions, including language-specific breaking changes. They also provide you with step-by-step instructions for a successful migration of your existing function app.
10
10
11
11
+[Migrate from runtime version 3.x to version 4.x](../articles/azure-functions/migrate-version-3-version-4.md)
12
12
+[Migrate from runtime version 1.x to version 4.x](../articles/azure-functions/migrate-version-1-version-4.md)
0 commit comments