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/set-runtime-version.md
+5-15Lines changed: 5 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -127,12 +127,14 @@ The function app restarts after the change is made to the application setting.
127
127
128
128
## <aname="manual-version-updates-on-linux"></a>Pin to a specific version on Linux
129
129
130
+
To pin a Linux function app to a specific host version, you set a version-specific base image URL in the [`linuxFxVersion` site setting][`linuxFxVersion`] in the format `DOCKER|<PINNED_VERSION_IMAGE_URI>`.
131
+
130
132
> [!IMPORTANT]
131
133
> Pinned function apps on Linux don't receive regular security and host functionality updates. Unless recommended by a support professional, use the [`FUNCTIONS_EXTENSION_VERSION`](functions-app-settings.md#functions_extension_version) setting and a standard [`linuxFxVersion`] value for your language and version, such as `Python|3.9`. For valid values, see the [`linuxFxVersion` reference article][`linuxFxVersion`].
132
134
>
133
135
> For apps running in a Consumption plan, setting [`linuxFxVersion`] to a specific image may also increase cold start times. This is because pinning to a specific image prevents Functions from using some cold start optimizations.
134
136
135
-
To pin a Linux function app to a specific host version, you specify a base image URL in the [`linuxFxVersion` site setting][`linuxFxVersion`] in the format `DOCKER|<PINNED_VERSION_IMAGE_URI>`. The following table provides an example of [`linuxFxVersion`] values required to pin a Node.js 10 function app to a specific runtime version of 3.0.13142:
137
+
The following table provides an example of [`linuxFxVersion`] values required to pin a Node.js 18 function app to a specific runtime version of 4.11.2:
@@ -141,13 +143,7 @@ To pin a Linux function app to a specific host version, you specify a base image
141
143
142
144
When needed, a support professional can provide you with a valid base image URI for your application.
143
145
144
-
# [Portal](#tab/portal)
145
-
146
-
Viewing and modifying site config settings for function apps isn't supported in the Azure portal. Use the Azure CLI instead.
147
-
148
-
# [Azure CLI](#tab/azurecli)
149
-
150
-
You can view and set the [`linuxFxVersion`] by using the Azure CLI.
146
+
Use the following Azure CLI commands to view and set the [`linuxFxVersion`]. You can't currently set [`linuxFxVersion`] in the portal or by using Azure PowerShell.
151
147
152
148
To view the current runtime version, use with the [az functionapp config show](/cli/azure/functionapp/config) command.
153
149
@@ -166,16 +162,10 @@ az functionapp config set --name <FUNCTION_APP> \
166
162
--linux-fx-version <LINUX_FX_VERSION>
167
163
```
168
164
169
-
Replace `<FUNCTION_APP>` with the name of your function app. Also replace `<RESOURCE_GROUP>` with the name of the resource group for your function app. Also, replace `<LINUX_FX_VERSION>` with the value of a specific image as described above.
165
+
Replace `<FUNCTION_APP>` with the name of your function app. Also replace `<RESOURCE_GROUP>` with the name of the resource group for your function app. Finally, replace `<LINUX_FX_VERSION>` with the value of a specific image provided to you by a support professional.
170
166
171
167
You can run this command from the [Azure Cloud Shell](../cloud-shell/overview.md) by choosing **Try it** in the preceding code sample. You can also use the [Azure CLI locally](/cli/azure/install-azure-cli) to execute this command after executing [`az login`](/cli/azure/reference-index#az-login) to sign in.
172
168
173
-
# [PowerShell](#tab/powershell)
174
-
175
-
Azure PowerShell can't be used to set the [`linuxFxVersion`] at this time. Use the Azure CLI instead.
176
-
177
-
---
178
-
179
169
The function app restarts after the change is made to the site config.
0 commit comments