Skip to content

Commit 21b958c

Browse files
committed
Final review and clean-up
1 parent ea24cca commit 21b958c

File tree

4 files changed

+18
-13
lines changed

4 files changed

+18
-13
lines changed

articles/azure-functions/migrate-version-1-version-4.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Migrate apps from Azure Functions version 1.x to 4.x
33
description: This article shows you how to upgrade your existing function apps running on version 1.x of the Azure Functions runtime to be able to run on version 4.x of the runtime.
44
ms.service: azure-functions
55
ms.topic: how-to
6-
ms.date: 10/19/2022
6+
ms.date: 11/05/2022
77
ms.custom: template-how-to-pattern
88
zone_pivot_groups: programming-languages-set-functions
99
---
@@ -365,7 +365,7 @@ To update your project to Azure Functions 4.x:
365365

366366
1. Move to one of the [Node.js versions supported on version 4.x](functions-reference-node.md#node-version).
367367

368-
1. Add both `version` and `extensionBundle` elements to the host.json, so that it looks like the following:
368+
1. Add both `version` and `extensionBundle` elements to the host.json, so that it looks like the following example:
369369

370370
[!INCLUDE [functions-extension-bundles-json-v3](../../includes/functions-extension-bundles-json-v3.md)]
371371

@@ -385,9 +385,9 @@ To update your project to Azure Functions 4.x:
385385

386386
The `AzureWebJobsStorage` setting can be either the Azurite storage emulator or an actual Azure storage account. For more information, see [Local storage emulator](/functions-develop-local.md#local-storage-emulator).
387387
::: zone-end
388-
388+
::: zone pivot="programming-language-javascript,programming-language-csharp"
389389
[!INCLUDE [functions-migrate-v4](../../includes/functions-migrate-v4.md)]
390-
390+
::: zone-end
391391
## Behavior changes after version 1.x
392392

393393
This section details changes made after version 1.x in both trigger and binding behaviors as well as in core Functions features and behaviors.

articles/azure-functions/migrate-version-3-version-4.md

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Migrate apps from Azure Functions version 3.x to 4.x
33
description: This article shows you how to upgrade your existing function apps running on version 3.x of the Azure Functions runtime to be able to run on version 4.x of the runtime.
44
ms.service: azure-functions
55
ms.topic: how-to
6-
ms.date: 10/23/2022
6+
ms.date: 11/05/2022
77
zone_pivot_groups: programming-languages-set-functions
88
---
99

@@ -214,7 +214,7 @@ To update your project to Azure Functions 4.x:
214214
3. If needed, move to one of the [Node.js versions supported on version 4.x](functions-reference-node.md#node-version).
215215
::: zone-end
216216
::: zone pivot="programming-language-powershell"
217-
3. If needed, upgrade to PowerShell 7.2. For more information, see [PowerShell versions](functions-reference-powershell.md#powershell-versions).
217+
3. Take this opportunity to upgrade to PowerShell 7.2, which is recommended. For more information, see [PowerShell versions](functions-reference-powershell.md#powershell-versions).
218218
::: zone-end
219219
::: zone pivot="programming-language-python"
220220
3. If you're using Python 3.6, move to one of the [supported versions](functions-reference-python.md#python-version).
@@ -224,7 +224,7 @@ To update your project to Azure Functions 4.x:
224224

225225
## Breaking changes between 3.x and 4.x
226226

227-
The following are key breaking changes to be aware of before upgrading a 3.x app to 4.x, including language-specific breaking changes. For a full list, see Azure Functions GitHub issues labeled [*Breaking Change: Approved*](https://github.com/Azure/azure-functions/issues?q=is%3Aissue+label%3A%22Breaking+Change%3A+Approved%22+is%3A%22closed+OR+open%22). More changes are expected during the preview period. Subscribe to [App Service Announcements](https://github.com/Azure/app-service-announcements/issues) for updates.
227+
The following are key breaking changes to be aware of before upgrading a 3.x app to 4.x, including language-specific breaking changes. For a full list, see Azure Functions GitHub issues labeled [*Breaking Change: Approved*](https://github.com/Azure/azure-functions/issues?q=is%3Aissue+label%3A%22Breaking+Change%3A+Approved%22+is%3A%22closed+OR+open%22).
228228

229229
If you don't see your programming language, go select it from the [top of the page](#top).
230230

@@ -236,7 +236,7 @@ If you don't see your programming language, go select it from the [top of the pa
236236

237237
- Azure Functions 4.x now enforces [minimum version requirements for extensions](functions-versions.md#minimum-extension-versions). Upgrade to the latest version of affected extensions. For non-.NET languages, [upgrade](./functions-bindings-register.md#extension-bundles) to extension bundle version 2.x or later. ([#1987](https://github.com/Azure/Azure-Functions/issues/1987))
238238

239-
- Default and maximum timeouts are now enforced in 4.x for function app running on Linux in a Consumption plan. ([#1915](https://github.com/Azure/Azure-Functions/issues/1915))
239+
- Default and maximum timeouts are now enforced in 4.x for function apps running on Linux in a Consumption plan. ([#1915](https://github.com/Azure/Azure-Functions/issues/1915))
240240

241241
- Azure Functions 4.x uses `Azure.Identity` and `Azure.Security.KeyVault.Secrets` for the Key Vault provider and has deprecated the use of Microsoft.Azure.KeyVault. For more information about how to configure function app settings, see the Key Vault option in [Secret Repositories](security-concepts.md#secret-repositories). ([#2048](https://github.com/Azure/Azure-Functions/issues/2048))
242242

@@ -272,4 +272,9 @@ If you don't see your programming language, go select it from the [top of the pa
272272
- Shared memory transfer is enabled by default. ([#1973](https://github.com/Azure/Azure-Functions/issues/1973))
273273

274274
- Default thread count has been updated. Functions that aren't thread-safe or have high memory usage may be impacted. ([#1962](https://github.com/Azure/Azure-Functions/issues/1962))
275-
::: zone-end
275+
::: zone-end
276+
277+
## Next steps
278+
279+
> [!div class="nextstepaction"]
280+
> [Learn more about Functions versions](functions-versions.md)

includes/functions-migrate-v4-linuxfxversion.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,16 @@ ms.date: 11/03/2022
66
ms.author: glenga
77
---
88
::: zone pivot="programming-language-csharp,programming-language-java,programming-language-javascript,programming-language-typescript,programming-language-python"
9-
You might also need to update the `linuxFxVersion` site setting to target your specific language language version. If you already have the correct value of `linuxFxVersion` set, you can skip this step. For more information, see [Valid `linuxFxVersion` values](../articles/azure-functions/functions-app-settings.md#valid-linuxfxversion-values).
9+
You might also need to update the `linuxFxVersion` site setting to target your specific language version. If you already have the correct value of `linuxFxVersion` set, you can skip this step. For more information, see [Valid `linuxFxVersion` values](../articles/azure-functions/functions-app-settings.md#valid-linuxfxversion-values).
1010
::: zone-end
1111
::: zone pivot="programming-language-powershell"
12-
PowerShell apps aren't supported on Linux before Functions 4.x. This means you shouldn't need to upgrade a PowerShell function app running on Linux.
12+
PowerShell apps aren't supported on Linux before Functions 4.x. This fact means you shouldn't need to upgrade a PowerShell function app running on Linux.
1313
::: zone-end
1414
::: zone pivot="programming-language-csharp"
1515
```azurecli
1616
az functionapp config set --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> --linux-fx-version "DOTNET|6.0"
1717
```
18-
If you are migrating to .NET Functions isolated worker process, use either `DOTNET-ISOLATED|6.0` or `DOTNET-ISOLATED|7.0` for `--linux-fx-version`.
18+
If you're migrating to .NET Functions isolated worker process, use either `DOTNET-ISOLATED|6.0` or `DOTNET-ISOLATED|7.0` for `--linux-fx-version`.
1919
:::zone-end
2020
::: zone pivot="programming-language-java"
2121
```azurecli

includes/functions-migrate-v4.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Update-AzFunctionAppSetting -AppSetting @{"FUNCTIONS_EXTENSION_VERSION" = "~4"}
2929
```
3030
---
3131

32-
During upgrade, you must also set an additional setting, which differs between Windows and Linux.
32+
During upgrade, you must also set another setting, which differs between Windows and Linux.
3333

3434
# [Windows](#tab/windows/azure-cli)
3535

0 commit comments

Comments
 (0)