Skip to content

Commit 097ac96

Browse files
committed
Added a portal tab for node.js upgrades
1 parent b864b26 commit 097ac96

File tree

2 files changed

+32
-5
lines changed

2 files changed

+32
-5
lines changed

articles/azure-functions/functions-reference-node.md

Lines changed: 32 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1418,21 +1418,48 @@ You can see the current version that the runtime is using by logging `process.ve
14181418
14191419
### Setting the Node version
14201420
1421+
You can set the Node.js version for your function app programmatically by using the Azure CLI. The command you use to set the Node.js version depends on whether your function app runs on Windows or Linux. You can also use the portal to change the Node.js version. For more information about Node.js versions, see [Supported versions](#supported-versions).
1422+
1423+
Before upgrading your Node.js version, make sure your function app is running on the latest version of the Azure Functions runtime. If you need to upgrade your runtime version, see [Migrate apps from Azure Functions version 3.x to version 4.x](migrate-version-3-version-4.md?pivots=programming-language-javascript).
1424+
1425+
# [Azure portal](#tab/azure-portal)
1426+
1427+
The following steps apply when your function app is running on either Linux or Windows.
1428+
1429+
1. In the [Azure portal](https://portal.azure.com), locate your function app and select **Configuration** on the left-hand side.
1430+
1431+
1. Select the **Function runtime settings** tab and verify that your function app is running on the latest version of the Functions runtime.
1432+
1433+
1. Select the **General settings** tab and update the **Node.js Version** to the latest version. Ideally, you have already locally verified that your functions run on the version you select.
1434+
1435+
:::image type="content" source="media/functions-reference-node/set-nodejs-version-portal.png" alt-text="Screenshot of setting Node.js for the function app to the latest LTS version in the Azure portal. ":::
1436+
1437+
1. When notified about a restart, select **Continue**, and then select **Save**.
1438+
14211439
# [Windows](#tab/windows-setting-the-node-version)
14221440
1423-
For Windows function apps, target the version in Azure by setting the `WEBSITE_NODE_DEFAULT_VERSION` [app setting](functions-how-to-use-azure-function-app-settings.md#settings) to a supported LTS version, such as `~18`.
1441+
Run the Azure CLI [`az functionapp config appsettings set`](/cli/azure/functionapp/config#az-functionapp-config-appsettings-set) command to update the Node.js version for your function app running on Windows:
1442+
1443+
```azurecli-interactive
1444+
az functionapp config appsettings set --settings WEBSITE_NODE_DEFAULT_VERSION=~18 \
1445+
--name <FUNCTION_APP_NAME> --resource-group <RESOURCE_GROUP_NAME>
1446+
```
1447+
1448+
This sets the [`WEBSITE_NODE_DEFAULT_VERSION` application setting](./functions-app-settings.md#website_node_default_version) the supported LTS version of `~18`.
14241449
14251450
# [Linux](#tab/linux-setting-the-node-version)
14261451
1427-
For Linux function apps, run the following Azure CLI command to update the Node version.
1452+
Run the Azure CLI [`az functionapp config set`](/cli/azure/functionapp/config#az-functionapp-config-set) command to update the Node.js version for your function app running on Linux:
14281453
1429-
```azurecli
1430-
az functionapp config set --linux-fx-version "node|18" --name "<MY_APP_NAME>" --resource-group "<MY_RESOURCE_GROUP_NAME>"
1454+
```azurecli-interactive
1455+
az functionapp config set --linux-fx-version "node|18" --name "<FUNCTION_APP_NAME>" \
1456+
--resource-group "<RESOURCE_GROUP_NAME>"
14311457
```
14321458
1459+
This sets the base image of the Linux function app to Node.js version 18.
14331460
---
14341461
1435-
To learn more about Azure Functions runtime support policy, refer to this [article](./language-support-policy.md).
1462+
After changes are made, your function app restarts. To learn more about Functions support for Node.js, see [Language runtime support policy](./language-support-policy.md).
14361463
14371464
<a name="access-environment-variables-in-code"></a>
14381465
89 KB
Loading

0 commit comments

Comments
 (0)