Skip to content

Commit 68a87a7

Browse files
authored
Merge pull request #307886 from mattchenderson/net10-ga
.NET 10 GA updates
2 parents ecc7ced + 5723c15 commit 68a87a7

4 files changed

Lines changed: 41 additions & 28 deletions

File tree

articles/azure-functions/dotnet-isolated-process-guide.md

Lines changed: 26 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,11 @@ ms.custom:
1717

1818
# Guide for running C# Azure Functions in the isolated worker model
1919

20+
> [!NOTE]
21+
> GA support for .NET 10 is rolling out but is not yet available in all regions. For the latest information about support for .NET 10 in global Azure, see this [tracking thread on GitHub](https://github.com/Azure/azure-functions-dotnet-worker/issues/3152).
22+
>
23+
> You can't run .NET 10 apps on Linux in the Consumption plan. To run on Linux, you should instead use the [Flex Consumption plan](./flex-consumption-plan.md).
24+
2025
This article is an introduction to working with Azure Functions in .NET, using the isolated worker model. This model allows your project to target versions of .NET independently of other runtime components. For information about specific .NET versions supported, see [supported version](#supported-versions).
2126

2227
Use the following links to get started right away building .NET isolated worker model functions.
@@ -65,15 +70,22 @@ The following packages are required to run your .NET functions in an isolated wo
6570
+ [Microsoft.Azure.Functions.Worker]
6671
+ [Microsoft.Azure.Functions.Worker.Sdk]
6772

68-
#### Version 2.x
73+
Minimum versions of these packages are required based on your target .NET version:
6974

70-
The 2.x versions of the core packages change the supported frameworks and bring in support for new .NET APIs from these later versions. When you target .NET 9 or later, your app needs to reference version 2.0.0 or later of both packages.
75+
| .NET version | `Microsoft.Azure.Functions.Worker` | `Microsoft.Azure.Functions.Worker.Sdk` |
76+
|----------------|------------------------------------|-----------------------------------------|
77+
| .NET 10 | 2.50.0 or later | 2.0.5 or later |
78+
| .NET 9 | 2.0.0 or later | 2.0.0 or later |
79+
| .NET 8 | 1.16.0 or later | 1.11.0 or later |
80+
| .NET Framework | 1.16.0 or later | 1.11.0 or later |
7181

72-
When updating to the 2.x versions, note the following changes:
82+
#### Version 2.x
83+
84+
The 2.x versions of the core packages change the supported frameworks and bring in support for new .NET APIs from these later versions. When updating to the 2.x versions, note the following changes:
7385

7486
- Starting with version 2.0.0 of [Microsoft.Azure.Functions.Worker.Sdk]:
7587
- The SDK includes default configurations for [SDK container builds](/dotnet/core/docker/publish-as-container).
76-
- The SDK includes support for [`dotnet run`](/dotnet/core/tools/dotnet-run) when the [Azure Functions Core Tools](./functions-develop-local.md) is installed. On Windows, the Core Tools needs to be installed through a mechanism other than NPM.
88+
- The SDK includes support for [`dotnet run`](/dotnet/core/tools/dotnet-run) when the [Azure Functions Core Tools](./functions-develop-local.md) is installed. On Windows, the Core Tools need to be installed through a mechanism other than NPM.
7789
- Starting with version 2.0.0 of [Microsoft.Azure.Functions.Worker]:
7890
- This version adds support for `IHostApplicationBuilder`. Some examples in this guide include tabs to show alternatives using `IHostApplicationBuilder`. These examples require the 2.x versions.
7991
- Service provider scope validation is included by default if run in a development environment. This behavior matches ASP.NET Core.
@@ -1320,16 +1332,17 @@ While it might be possible to target a given release from a local Functions proj
13201332

13211333
Azure Functions currently can be used with the following "Preview" or "Go-live" .NET releases:
13221334

1323-
| Operating system | .NET preview version |
1324-
|------------------|-------------------------------|
1325-
| Linux | .NET 10 RC1<sup>1,2,3</sup> |
1326-
| Windows | .NET 10 Preview 5<sup>1,2</sup> |
1335+
| Operating system | .NET preview version |
1336+
|------------------|----------------------|
1337+
| Linux | .NET 10 RC1 |
1338+
| Windows | .NET 10 Preview 5 |
13271339

1328-
1. Apps targeting .NET 10 must use [version 2.0.5 or later of `Microsoft.Azure.Functions.Worker.Sdk`][Microsoft.Azure.Functions.Worker.Sdk]. You should also update to [version 2.50.0-preview1 or later of `Microsoft.Azure.Functions.Worker`][Microsoft.Azure.Functions.Worker], which updates dependencies to align with .NET 10. When using Visual Studio, you also need to use [Visual Studio 2026 Insiders][vs-insiders] and [update the Functions tools and templates](#considerations-for-using-net-preview-versions) to version 4.114.0 or later.
1329-
2. For the latest information about support for .NET 10 in global Azure, see this [tracking thread on GitHub](https://github.com/Azure/azure-functions-dotnet-worker/issues/3152).
1330-
3. You can't run .NET 10 apps on Linux in the Consumption plan. To run on Linux, you should instead use the [Flex Consumption plan](./flex-consumption-plan.md).
1340+
> [!NOTE]
1341+
> GA support for .NET 10 is rolling out but is not yet available in all regions. For the latest information about support for .NET 10 in global Azure, see this [tracking thread on GitHub](https://github.com/Azure/azure-functions-dotnet-worker/issues/3152).
1342+
>
1343+
> You can't run .NET 10 apps on Linux in the Consumption plan. To run on Linux, you should instead use the [Flex Consumption plan](./flex-consumption-plan.md).
13311344

1332-
See [Supported versions][supported-versions] for a list of generally available releases that you can use.
1345+
<!-- See [Supported versions][supported-versions] for a list of generally available releases that you can use. -->
13331346

13341347
### Using a preview .NET SDK
13351348

@@ -1366,7 +1379,7 @@ Keep these considerations in mind when using Functions with preview versions of
13661379

13671380
+ Make sure you have the latest Functions tools and templates. To update your tools:
13681381

1369-
1. Navigate to **Tools** > **Options**, choose **Azure Functions** under **Projects and Solutions**.
1382+
1. Navigate to **Tools** > **Options**, choose **Azure Functions** under **Projects and Solutions** > **More Settings**.
13701383
1. Select **Check for updates** and install updates as prompted.
13711384

13721385
+ During a preview period, your development environment might have a more recent version of the .NET preview than the hosted service. This can cause your function app to fail when deployed. To address this, you can specify the version of the SDK to use in [`global.json`](/dotnet/core/tools/global-json).

includes/functions-dotnet-migrate-v4-versions.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,20 +10,20 @@ ms.author: mahender
1010

1111
When you migrate your function app, you have the opportunity to choose the target version of .NET. You can update your C# project to one of the following versions of .NET that are supported by Functions version 4.x:
1212

13-
| .NET version | [.NET Official Support Policy] release type | Functions process model<sup>1,2</sup> |
14-
| --- | --- | --- |
15-
| .NET 10 | Preview<sup>3</sup> | [Isolated worker model] |
16-
| .NET 9 | STS (end of support November 10, 2026)<sup>4</sup> | [Isolated worker model] |
17-
| .NET 8 | LTS (end of support November 10, 2026) | [Isolated worker model],<br/>[In-process model]<sup>2</sup> |
18-
| .NET Framework 4.8 | [See policy][netfxpolicy] | [Isolated worker model] |
13+
| .NET version | [.NET Official Support Policy] release type | Functions process model<sup>1,2</sup> |
14+
|--------------------|----------------------------------------------------|-------------------------------------------------------------|
15+
| .NET 10 | LTS (end of support November 14 2028) | [Isolated worker model] |
16+
| .NET 9 | STS (end of support November 10, 2026)<sup>3</sup> | [Isolated worker model] |
17+
| .NET 8 | LTS (end of support November 10, 2026) | [Isolated worker model],<br/>[In-process model]<sup>2</sup> |
18+
| .NET Framework 4.8 | [See policy][netfxpolicy] | [Isolated worker model] |
1919

2020
<sup>1</sup> The [isolated worker model] supports Long Term Support (LTS) and Standard Term Support (STS) versions of .NET, as well as .NET Framework. The [in-process model] only supports LTS releases of .NET, ending with .NET 8. For a full feature and functionality comparison between the two models, see [Differences between in-process and isolate worker process .NET Azure Functions](../articles/azure-functions/dotnet-isolated-in-process-differences.md).
2121

2222
<sup>2</sup> Support ends for the in-process model on November 10, 2026. For more information, see [this support announcement](https://aka.ms/azure-functions-retirements/in-process-model). For continued full support, you should [migrate your apps to the isolated worker model](../articles/azure-functions/migrate-dotnet-to-isolated-model.md).
2323

24-
<sup>3</sup> See [Preview .NET versions in the isolated worker model](../articles/azure-functions/dotnet-isolated-process-guide.md#preview-net-versions) for details on support, current restrictions, and instructions for using the preview version.
24+
<!-- <sup>3</sup> See [Preview .NET versions in the isolated worker model](../articles/azure-functions/dotnet-isolated-process-guide.md#preview-net-versions) for details on support, current restrictions, and instructions for using the preview version. -->
2525

26-
<sup>4</sup> .NET 9 previously had an expected end-of-support date of May 12, 2026. During the .NET 9 service window, the .NET team extended support for STS versions to 24 months, starting with .NET 9. For more information, see [the blog post](https://devblogs.microsoft.com/dotnet/dotnet-sts-releases-supported-for-24-months/).
26+
<sup>3</sup> .NET 9 previously had an expected end-of-support date of May 12, 2026. During the .NET 9 service window, the .NET team extended support for STS versions to 24 months, starting with .NET 9. For more information, see [the blog post](https://devblogs.microsoft.com/dotnet/dotnet-sts-releases-supported-for-24-months/).
2727

2828
[.NET Official Support Policy]: https://dotnet.microsoft.com/platform/support/policy
2929
[netfxpolicy]: https://dotnet.microsoft.com/platform/support/policy/dotnet-framework

includes/functions-dotnet-supported-versions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ The following table shows the highest level of .NET or .NET Framework that can b
1919

2020
| Functions runtime version | [Isolated worker model](../articles/azure-functions/dotnet-isolated-process-guide.md) | [In-process model](../articles/azure-functions/functions-dotnet-class-library.md)<sup>4</sup> |
2121
| ---- | --- | ---- |
22-
| Functions 4.x<sup>1</sup> | .NET 10 (preview)<br/>.NET 9.0<br/>.NET 8.0<br/>.NET Framework 4.8<sup>2</sup> | .NET 8.0 |
22+
| Functions 4.x<sup>1</sup> | .NET 10<br/>.NET 9.0<br/>.NET 8.0<br/>.NET Framework 4.8<sup>2</sup> | .NET 8.0 |
2323
| Functions 1.x<sup>3</sup> | n/a | .NET Framework 4.8 |
2424

2525
<sup>1</sup> .NET 6 was previously supported on both models but reached the [end of official support] on November 12, 2024. .NET 7 was previously supported on the isolated worker model but reached the [end of official support] on May 14, 2024.

includes/functions-supported-languages.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -51,12 +51,12 @@ For more information, see [Develop C# class library functions using Azure Functi
5151

5252
### [v4.x](#tab/v4/isolated-process)
5353

54-
| Supported version | Support level | Expected end-of-support date |
55-
| ---- | ---- |--- |
56-
| .NET 10 | Preview | See [.NET and .NET Core release lifecycle][dotnet-policy]. |
57-
| .NET 9 | GA | [November 10, 2026][dotnet-policy]<sup>1</sup> |
58-
| .NET 8 | GA | [November 10, 2026][dotnet-policy] |
59-
| .NET Framework 4.8.1 | GA | See [.NET Framework Support Policy][dotnet-framework-policy]. |
54+
| Supported version | Support level | Expected end-of-support date |
55+
|----------------------|---------------|---------------------------------------------------------------|
56+
| .NET 10 | GA | [November 14, 2028][dotnet-policy]. |
57+
| .NET 9 | GA | [November 10, 2026][dotnet-policy]<sup>1</sup> |
58+
| .NET 8 | GA | [November 10, 2026][dotnet-policy] |
59+
| .NET Framework 4.8.1 | GA | See [.NET Framework Support Policy][dotnet-framework-policy]. |
6060

6161
<sup>1</sup> .NET 9 previously had an expected end-of-support date of May 12, 2026. During the .NET 9 service window, the .NET team extended support for STS versions to 24 months, starting with .NET 9. For more information, see [the blog post](https://devblogs.microsoft.com/dotnet/dotnet-sts-releases-supported-for-24-months/).
6262

0 commit comments

Comments
 (0)