Skip to content

Commit 4f534b8

Browse files
committed
rename isolated worker process
1 parent 1b7997c commit 4f534b8

File tree

70 files changed

+152
-145
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

70 files changed

+152
-145
lines changed

Diff for: articles/azure-functions/create-first-function-cli-csharp.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,7 @@ The return object is an [ActionResult](/dotnet/api/microsoft.aspnetcore.mvc.acti
119119

120120
# [Isolated process](#tab/isolated-process)
121121

122-
*HttpExample.cs* contains a `Run` method that receives request data in the `req` variable is an [HttpRequestData](/dotnet/api/microsoft.azure.functions.worker.http.httprequestdata) object that's decorated with the **HttpTriggerAttribute**, which defines the trigger behavior. Because of the isolated process model, `HttpRequestData` is a representation of the actual `HttpRequest`, and not the request object itself.
122+
*HttpExample.cs* contains a `Run` method that receives request data in the `req` variable is an [HttpRequestData](/dotnet/api/microsoft.azure.functions.worker.http.httprequestdata) object that's decorated with the **HttpTriggerAttribute**, which defines the trigger behavior. Because of the isolated worker process model, `HttpRequestData` is a representation of the actual `HttpRequest`, and not the request object itself.
123123

124124
:::code language="csharp" source="~/functions-docs-csharp/http-trigger-isolated/HttpExample.cs":::
125125

Diff for: articles/azure-functions/create-first-function-vs-code-csharp.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ adobe-target-content: ./create-first-function-vs-code-csharp-ieux
1515

1616
In this article, you use Visual Studio Code to create a C# function that responds to HTTP requests. After testing the code locally, you deploy it to the serverless environment of Azure Functions. This article creates an HTTP triggered function that runs on .NET 6.0. There's also a [CLI-based version](create-first-function-cli-csharp.md) of this article.
1717

18-
By default, this article shows you how to create C# functions that run [in the same process as the Functions host](functions-dotnet-class-library.md). These _in-process_ C# functions are only supported on Long Term Support (LTS) versions of .NET, such as .NET 6. To create C# functions on .NET 6 that can also run on [other supported versions](functions-versions.md) for Azure functions [in an isolated process](dotnet-isolated-process-guide.md).
18+
By default, this article shows you how to create C# functions that run [in the same process as the Functions host](functions-dotnet-class-library.md). These _in-process_ C# functions are only supported on Long Term Support (LTS) versions of .NET, such as .NET 6. To create C# functions on .NET 6 that can also run on [other supported versions](functions-versions.md) for Azure functions [in an isolated worker process](dotnet-isolated-process-guide.md).
1919

2020
Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.
2121

Diff for: articles/azure-functions/dotnet-isolated-process-guide.md

+14-14
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
---
2-
title: Guide for running C# Azure Functions in an isolated process
3-
description: Learn how to use a .NET isolated process to run your C# functions in Azure, which supports .NET 5.0 and later versions.
2+
title: Guide for running C# Azure Functions in an isolated worker process
3+
description: Learn how to use a .NET isolated worker process to run your C# functions in Azure, which supports non-LTS versions of .NET and .NET Framework apps.
44

55
ms.service: azure-functions
66
ms.topic: conceptual
77
ms.date: 09/29/2022
88
ms.custom: template-concept
99
recommendations: false
10-
#Customer intent: As a developer, I need to know how to create functions that run in an isolated process so that I can run my function code on current (not LTS) releases of .NET.
10+
#Customer intent: As a developer, I need to know how to create functions that run in an isolated worker process so that I can run my function code on current (not LTS) releases of .NET.
1111
---
1212

13-
# Guide for running C# Azure Functions in an isolated process
13+
# Guide for running C# Azure Functions in an isolated worker process
1414

15-
This article is an introduction to using C# to develop .NET isolated process functions, which runs Azure Functions in an isolated process. This allows you to decouple your function code from the Azure Functions runtime, check out [supported version](#supported-versions) for Azure functions in an isolated process. [In-process C# class library functions](functions-dotnet-class-library.md) aren't supported on .NET 7.0.
15+
This article is an introduction to using C# to develop .NET isolated worker process functions, which runs Azure Functions in an isolated worker process. This allows you to decouple your function code from the Azure Functions runtime, check out [supported version](#supported-versions) for Azure functions in an isolated worker process. [In-process C# class library functions](functions-dotnet-class-library.md) aren't supported on .NET 7.0.
1616

1717
| Getting started | Concepts| Samples |
1818
|--|--|--|
1919
| <ul><li>[Using Visual Studio Code](create-first-function-vs-code-csharp.md?tabs=isolated-process)</li><li>[Using command line tools](create-first-function-cli-csharp.md?tabs=isolated-process)</li><li>[Using Visual Studio](functions-create-your-first-function-visual-studio.md?tabs=isolated-process)</li></ul> | <ul><li>[Hosting options](functions-scale.md)</li><li>[Monitoring](functions-monitoring.md)</li> | <ul><li>[Reference samples](https://github.com/Azure/azure-functions-dotnet-worker/tree/main/samples)</li></ul> |
2020

21-
## Why .NET isolated process?
21+
## Why .NET isolated worker process?
2222

23-
Previously Azure Functions has only supported a tightly integrated mode for .NET functions, which run [as a class library](functions-dotnet-class-library.md) in the same process as the host. This mode provides deep integration between the host process and the functions. For example, .NET class library functions can share binding APIs and types. However, this integration also requires a tighter coupling between the host process and the .NET function. For example, .NET functions running in-process are required to run on the same version of .NET as the Functions runtime. To enable you to run outside these constraints, you can now choose to run in an isolated process. This process isolation also lets you develop functions that use current .NET releases (such as .NET 7.0), not natively supported by the Functions runtime. Both isolated process and in-process C# class library functions run on .NET 6.0. To learn more, see [Supported versions](#supported-versions).
23+
Previously Azure Functions has only supported a tightly integrated mode for .NET functions, which run [as a class library](functions-dotnet-class-library.md) in the same process as the host. This mode provides deep integration between the host process and the functions. For example, .NET class library functions can share binding APIs and types. However, this integration also requires a tighter coupling between the host process and the .NET function. For example, .NET functions running in-process are required to run on the same version of .NET as the Functions runtime. To enable you to run outside these constraints, you can now choose to run in an isolated worker process. This process isolation also lets you develop functions that use current .NET releases (such as .NET 7.0), not natively supported by the Functions runtime. Both isolated worker process and in-process C# class library functions run on .NET 6.0. To learn more, see [Supported versions](#supported-versions).
2424

2525
Because these functions run in a separate process, there are some [feature and functionality differences](#differences-with-net-class-library-functions) between .NET isolated function apps and .NET class library function apps.
2626

@@ -55,14 +55,14 @@ When your functions run out-of-process, your .NET project uses a unique set of p
5555

5656
### Core packages
5757

58-
The following packages are required to run your .NET functions in an isolated process:
58+
The following packages are required to run your .NET functions in an isolated worker process:
5959

6060
+ [Microsoft.Azure.Functions.Worker](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker/)
6161
+ [Microsoft.Azure.Functions.Worker.Sdk](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Sdk/)
6262

6363
### Extension packages
6464

65-
Because functions that run in a .NET isolated process use different binding types, they require a unique set of binding extension packages.
65+
Because functions that run in a .NET isolated worker process use different binding types, they require a unique set of binding extension packages.
6666

6767
You'll find these extension packages under [Microsoft.Azure.Functions.Worker.Extensions](https://www.nuget.org/packages?q=Microsoft.Azure.Functions.Worker.Extensions).
6868

@@ -85,7 +85,7 @@ A [HostBuilder] is used to build and return a fully initialized [IHost] instance
8585
8686
### Configuration
8787

88-
The [ConfigureFunctionsWorkerDefaults] method is used to add the settings required for the function app to run in an isolated process, which includes the following functionality:
88+
The [ConfigureFunctionsWorkerDefaults] method is used to add the settings required for the function app to run in an isolated worker process, which includes the following functionality:
8989

9090
+ Default set of converters.
9191
+ Set the default [JsonSerializerOptions] to ignore casing on property names.
@@ -140,7 +140,7 @@ For a more complete example of using custom middleware in your function app, see
140140

141141
A function can accept a [CancellationToken](/dotnet/api/system.threading.cancellationtoken) parameter, which enables the operating system to notify your code when the function is about to be terminated. You can use this notification to make sure the function doesn't terminate unexpectedly in a way that leaves data in an inconsistent state.
142142

143-
Cancellation tokens are supported in .NET functions when running in an isolated process. The following example raises an exception when a cancellation request has been received:
143+
Cancellation tokens are supported in .NET functions when running in an isolated worker process. The following example raises an exception when a cancellation request has been received:
144144

145145
:::code language="csharp" source="~/azure-functions-dotnet-worker/samples/Net7Worker/EventHubCancellationToken.cs" id="docsnippet_cancellation_token_throw":::
146146

@@ -152,7 +152,7 @@ The following example performs clean-up actions if a cancellation request has be
152152

153153
You can compile your function app as [ReadyToRun binaries](/dotnet/core/deploying/ready-to-run). ReadyToRun is a form of ahead-of-time compilation that can improve startup performance to help reduce the impact of [cold-start](event-driven-scaling.md#cold-start) when running in a [Consumption plan](consumption-plan.md).
154154

155-
ReadyToRun is available in .NET 3.1, .NET 6 (both in-process and isolated process), and .NET 7, and it requires [version 3.0 or later](functions-versions.md) of the Azure Functions runtime.
155+
ReadyToRun is available in .NET 3.1, .NET 6 (both in-process and isolated worker process), and .NET 7, and it requires [version 3.0 or later](functions-versions.md) of the Azure Functions runtime.
156156

157157
To compile your project as ReadyToRun, update your project file by adding the `<PublishReadyToRun>` and `<RuntimeIdentifier>` elements. The following is the configuration for publishing to a Windows 32-bit function app.
158158

@@ -256,7 +256,7 @@ namespace MyDotnetFrameworkProject
256256
}
257257
```
258258

259-
Next, you need to manually attach to the process using a .NET Framework debugger. Visual Studio doesn't do this automatically for isolated process .NET Framework apps yet, and the "Start Debugging" operation should be avoided.
259+
Next, you need to manually attach to the process using a .NET Framework debugger. Visual Studio doesn't do this automatically for isolated worker process .NET Framework apps yet, and the "Start Debugging" operation should be avoided.
260260

261261
In your project directory (or its build output directory), run:
262262

@@ -302,7 +302,7 @@ This section describes the current state of the functional and behavioral differ
302302

303303
## Remote Debugging using Visual Studio
304304

305-
Because your isolated process app runs outside the Functions runtime, you need to attach the remote debugger to a separate process. To learn more about debugging using Visual Studio, see [Remote Debugging](functions-develop-vs.md?tabs=isolated-process#remote-debugging).
305+
Because your isolated worker process app runs outside the Functions runtime, you need to attach the remote debugger to a separate process. To learn more about debugging using Visual Studio, see [Remote Debugging](functions-develop-vs.md?tabs=isolated-process#remote-debugging).
306306
## Next steps
307307

308308
+ [Learn more about triggers and bindings](functions-triggers-bindings.md)

Diff for: articles/azure-functions/functions-app-settings.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -310,7 +310,7 @@ Valid values:
310310
| Value | Language |
311311
|---|---|
312312
| `dotnet` | [C# (class library)](functions-dotnet-class-library.md)<br/>[C# (script)](functions-reference-csharp.md) |
313-
| `dotnet-isolated` | [C# (isolated process)](dotnet-isolated-process-guide.md) |
313+
| `dotnet-isolated` | [C# (isolated worker process)](dotnet-isolated-process-guide.md) |
314314
| `java` | [Java](functions-reference-java.md) |
315315
| `node` | [JavaScript](functions-reference-node.md)<br/>[TypeScript](functions-reference-node.md#typescript) |
316316
| `powershell` | [PowerShell](functions-reference-powershell.md) |

Diff for: articles/azure-functions/functions-bindings-azure-sql-input.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,7 @@ The stored procedure `dbo.DeleteToDo` must be created on the SQL database. In t
119119

120120
# [Isolated process](#tab/isolated-process)
121121

122-
Isolated process isn't currently supported.
122+
Isolated worker process isn't currently supported.
123123

124124
<!-- Uncomment to support C# script examples.
125125
# [C# Script](#tab/csharp-script)

Diff for: articles/azure-functions/functions-bindings-azure-sql-output.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ namespace AzureSQLSamples
154154

155155
# [Isolated process](#tab/isolated-process)
156156

157-
Isolated process isn't currently supported.
157+
Isolated worker process isn't currently supported.
158158

159159
<!-- Uncomment to support C# script examples.
160160
# [C# Script](#tab/csharp-script)

Diff for: articles/azure-functions/functions-bindings-azure-sql.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -33,10 +33,10 @@ Add the extension to your project by installing this [NuGet package](https://www
3333

3434
# [Isolated process](#tab/isolated-process)
3535

36-
Functions execute in an isolated C# worker process. To learn more, see [Guide for running C# Azure Functions in an isolated process](dotnet-isolated-process-guide.md).
36+
Functions execute in an isolated C# worker process. To learn more, see [Guide for running C# Azure Functions in an isolated worker process](dotnet-isolated-process-guide.md).
3737

3838
> [!NOTE]
39-
> In the current preview, Azure SQL bindings aren't supported when your function app runs in an isolated process.
39+
> In the current preview, Azure SQL bindings aren't supported when your function app runs in an isolated worker process.
4040
4141
<!--
4242
Add the extension to your project by installing this [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.SignalRService/).

Diff for: articles/azure-functions/functions-bindings-cosmosdb-v2-input.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1689,7 +1689,7 @@ Here's the binding data in the *function.json* file:
16891689
::: zone pivot="programming-language-csharp"
16901690
## Attributes
16911691

1692-
Both [in-process](functions-dotnet-class-library.md) and [isolated process](dotnet-isolated-process-guide.md) C# libraries use attributes to define the function. C# script instead uses a function.json configuration file.
1692+
Both [in-process](functions-dotnet-class-library.md) and [isolated worker process](dotnet-isolated-process-guide.md) C# libraries use attributes to define the function. C# script instead uses a function.json configuration file.
16931693

16941694
# [Functions 2.x+](#tab/functionsv2/in-process)
16951695

Diff for: articles/azure-functions/functions-bindings-cosmosdb-v2-output.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -626,7 +626,7 @@ def main(req: func.HttpRequest, doc: func.Out[func.Document]) -> func.HttpRespon
626626
::: zone pivot="programming-language-csharp"
627627
## Attributes
628628

629-
Both [in-process](functions-dotnet-class-library.md) and [isolated process](dotnet-isolated-process-guide.md) C# libraries use attributes to define the function. C# script instead uses a function.json configuration file.
629+
Both [in-process](functions-dotnet-class-library.md) and [isolated worker process](dotnet-isolated-process-guide.md) C# libraries use attributes to define the function. C# script instead uses a function.json configuration file.
630630

631631
# [Functions 2.x+](#tab/functionsv2/in-process)
632632

Diff for: articles/azure-functions/functions-bindings-cosmosdb-v2-trigger.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ An in-process class library is a compiled C# function runs in the same process a
2626

2727
# [Isolated process](#tab/isolated-process)
2828

29-
An isolated process class library compiled C# function runs in a process isolated from the runtime. Isolated process is required to support C# functions running on .NET 5.0.
29+
An isolated worker process class library compiled C# function runs in a process isolated from the runtime.
3030

3131
# [C# script](#tab/csharp-script)
3232

Diff for: articles/azure-functions/functions-bindings-cosmosdb-v2.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ Functions execute in the same process as the Functions host. To learn more, see
4141

4242
# [Isolated process](#tab/isolated-process)
4343

44-
Functions execute in an isolated C# worker process. To learn more, see [Guide for running functions on .NET 5.0 in Azure](dotnet-isolated-process-guide.md).
44+
Functions execute in an isolated C# worker process. To learn more, see [Guide for running C# Azure Functions in an isolated worker process](dotnet-isolated-process-guide.md).
4545

4646
# [C# script](#tab/csharp-script)
4747

Diff for: articles/azure-functions/functions-bindings-error-pages.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ public static async Task Run([EventHubTrigger("myHub", Connection = "EventHubCon
107107

108108
# [Isolated process](#tab/isolated-process/fixed-delay)
109109

110-
Retry policies aren't yet supported when running in an isolated process.
110+
Retry policies aren't yet supported when running in an isolated worker process.
111111

112112
# [C# Script](#tab/csharp-script/fixed-delay)
113113

@@ -156,7 +156,7 @@ public static async Task Run([EventHubTrigger("myHub", Connection = "EventHubCon
156156

157157
# [Isolated process](#tab/isolated-process/exponential-backoff)
158158

159-
Retry policies aren't yet supported when running in an isolated process.
159+
Retry policies aren't yet supported when running in an isolated worker process.
160160

161161
# [C# Script](#tab/csharp-script/exponential-backoff)
162162

Diff for: articles/azure-functions/functions-bindings-event-grid-output.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ For information on setup and configuration details, see [How to work with Event
2626
The type of the output parameter used with an Event Grid output binding depends on the Functions runtime version, the binding extension version, and the modality of the C# function. The C# function can be created using one of the following C# modes:
2727

2828
* [In-process class library](functions-dotnet-class-library.md): compiled C# function that runs in the same process as the Functions runtime.
29-
* [Isolated process class library](dotnet-isolated-process-guide.md): compiled C# function that runs in a process isolated from the runtime. Isolated process is required to support C# functions running on .NET 5.0.
29+
* [Isolated worker process class library](dotnet-isolated-process-guide.md): compiled C# function that runs in a worker process isolated from the runtime.
3030
* [C# script](functions-reference-csharp.md): used primarily when creating C# functions in the Azure portal.
3131

3232
# [In-process](#tab/in-process)
@@ -441,7 +441,7 @@ def main(eventGridEvent: func.EventGridEvent,
441441
::: zone pivot="programming-language-csharp"
442442
## Attributes
443443

444-
Both [in-process](functions-dotnet-class-library.md) and [isolated process](dotnet-isolated-process-guide.md) C# libraries use attribute to configure the binding. C# script instead uses a function.json configuration file.
444+
Both [in-process](functions-dotnet-class-library.md) and [isolated worker process](dotnet-isolated-process-guide.md) C# libraries use attribute to configure the binding. C# script instead uses a function.json configuration file.
445445

446446
The attribute's constructor takes the name of an application setting that contains the name of the custom topic, and the name of an application setting that contains the topic key.
447447

@@ -564,7 +564,7 @@ Requires you to define a custom type, or use a string. See the [Example section]
564564

565565
# [Functions 1.x](#tab/functionsv1/isolated-process)
566566

567-
Functions version 1.x doesn't support isolated process.
567+
Functions version 1.x doesn't support isolated worker process.
568568

569569
# [Extension v3.x](#tab/extensionv3/csharp-script)
570570

0 commit comments

Comments
 (0)