|
2 | 2 | title: "Quickstart: Set a durable functions app to use Azure Functions durable task scheduler (preview)"
|
3 | 3 | description: Learn how to configure an existing durable functions app to use Azure Functions durable task scheduler.
|
4 | 4 | ms.topic: how-to
|
5 |
| -ms.date: 04/10/2025 |
| 5 | +ms.date: 04/24/2025 |
6 | 6 | zone_pivot_groups: dts-runtime
|
7 | 7 | ---
|
8 | 8 |
|
9 | 9 | # Quickstart: Set a durable functions app to use Azure Functions durable task scheduler (preview)
|
10 | 10 |
|
11 |
| -Write stateful functions in a serverless environment using durable functions, a feature of [Azure Functions](../functions-overview.md). Scenarios where durable functions is useful include orchestrating microservices and workflows, stateful patterns like fan-out/fan-in, and long-running tasks. |
| 11 | +Write stateful functions in a serverless environment using durable functions, a feature of [Azure Functions](../../functions-overview.md). Scenarios where durable functions is useful include orchestrating microservices and workflows, stateful patterns like fan-out/fan-in, and long-running tasks. |
12 | 12 |
|
13 |
| -Durable functions supports several [storage providers](../durable/durable-functions-storage-providers.md), also known as *backends*, for storing orchestration and entity runtime state. |
| 13 | +Durable functions supports several [storage providers](../durable-functions-storage-providers.md), also known as *backends*, for storing orchestration and entity runtime state. |
14 | 14 |
|
15 |
| -In this quickstart, you configure a durable functions app to use the [durable task scheduler](../durable/durable-functions-storage-providers.md#dts) as the backend and deploy the app to Azure using **Visual Studio Code**. |
| 15 | +In this quickstart, you configure a durable functions app to use the [durable task scheduler](../durable-functions-storage-providers.md#dts) as the backend and deploy the app to Azure using **Visual Studio Code**. |
16 | 16 |
|
17 | 17 | > [!NOTE]
|
18 | 18 | >
|
19 |
| -> - To learn more about the benefit of using durable task scheduler, see [durable functions backend providers overview](../durable/durable-functions-storage-providers.md). |
| 19 | +> - To learn more about the benefit of using durable task scheduler, see [durable functions backend providers overview](../durable-functions-storage-providers.md). |
20 | 20 | >
|
21 |
| -> - Migrating [task hub data](../durable/durable-functions-task-hubs.md) across backend providers currently isn't supported. Function apps that have existing runtime data need to start with a fresh, empty task hub after they switch to the durable task scheduler. Similarly, the task hub contents that are created by using the scheduler resource can't be preserved if you switch to a different backend provider. |
| 21 | +> - Migrating [task hub data](../durable-functions-task-hubs.md) across backend providers currently isn't supported. Function apps that have existing runtime data need to start with a fresh, empty task hub after they switch to the durable task scheduler. Similarly, the task hub contents that are created by using the scheduler resource can't be preserved if you switch to a different backend provider. |
22 | 22 | >
|
23 | 23 | > - Durable task scheduler currently only supports durable functions running on **Functions Premium** and **App Service** plans.
|
24 | 24 |
|
25 | 25 | ## Prerequisites
|
26 | 26 |
|
27 | 27 | This quickstart assumes you already have an Azure Functions project on your local computer with:
|
28 | 28 | - Durable functions added to your project including:
|
29 |
| - - An [orchestrator function](../durable/durable-functions-bindings.md#orchestration-trigger). |
30 |
| - - A [client function](../durable/durable-functions-bindings.md#orchestration-client) that triggers the durable functions app. |
| 29 | + - An [orchestrator function](../durable-functions-bindings.md#orchestration-trigger). |
| 30 | + - A [client function](../durable-functions-bindings.md#orchestration-client) that triggers the durable functions app. |
31 | 31 | - The project configured for local debugging.
|
32 | 32 |
|
33 | 33 | If you don't meet these prerequisites, we recommend that you begin with one of the following quickstarts to set up a local Functions project:
|
34 | 34 |
|
35 | 35 | ::: zone pivot="csharp"
|
36 | 36 |
|
37 |
| -- [Create a durable functions app - C#](../durable/durable-functions-isolated-create-first-csharp.md) |
| 37 | +- [Create a durable functions app - C#](../durable-functions-isolated-create-first-csharp.md) |
38 | 38 |
|
39 | 39 | ::: zone-end
|
40 | 40 |
|
41 | 41 | ::: zone pivot="other"
|
42 | 42 |
|
43 |
| -- [Create a durable functions app - JavaScript](../durable/quickstart-js-vscode.md) |
44 |
| -- [Create a durable functions app - Python](../durable/quickstart-python-vscode.md) |
45 |
| -- [Create a durable functions app - PowerShell](../durable/quickstart-powershell-vscode.md) |
46 |
| -- [Create a durable functions app - Java](../durable/quickstart-java.md) |
| 43 | +- [Create a durable functions app - JavaScript](../quickstart-js-vscode.md) |
| 44 | +- [Create a durable functions app - Python](../quickstart-python-vscode.md) |
| 45 | +- [Create a durable functions app - PowerShell](../quickstart-powershell-vscode.md) |
| 46 | +- [Create a durable functions app - Java](../quickstart-java.md) |
47 | 47 |
|
48 | 48 | ::: zone-end
|
49 | 49 |
|
50 | 50 | You also need:
|
51 | 51 | - [Docker](https://docs.docker.com/engine/install/) installed to run the durable task scheduler emulator.
|
52 |
| -- [Azurite](../../storage/common/storage-use-azurite.md#run-azurite) installed. |
53 |
| -- An [HTTP test tool](../functions-develop-local.md#http-test-tools) that keeps your data secure. |
| 52 | +- [Azurite](../../../storage/common/storage-use-azurite.md#run-azurite) installed. |
| 53 | +- An [HTTP test tool](../../functions-develop-local.md#http-test-tools) that keeps your data secure. |
54 | 54 |
|
55 | 55 | ## Add the durable task scheduler package
|
56 | 56 |
|
@@ -162,7 +162,7 @@ Get the durable task scheduler emulator port number in [the next step](#set-up-d
|
162 | 162 |
|
163 | 163 | :::image type="content" source="media/quickstart-durable-task-scheduler/function-list.png" alt-text="Screenshot of functions listed when running app locally.":::
|
164 | 164 |
|
165 |
| -1. Start an orchestration instance by sending an HTTP `POST` request to the URL endpoint using the [HTTP test tool](../functions-develop-local.md#http-test-tools) you chose. |
| 165 | +1. Start an orchestration instance by sending an HTTP `POST` request to the URL endpoint using the [HTTP test tool](../../functions-develop-local.md#http-test-tools) you chose. |
166 | 166 |
|
167 | 167 | 1. Copy the URL value for `statusQueryGetUri` and paste it in your browser's address bar. You should see the status on the orchestration instance:
|
168 | 168 |
|
@@ -206,7 +206,7 @@ Resource deployment could take around 15 to 20 minutes. Once that is finished, y
|
206 | 206 |
|
207 | 207 | ### Deploy your function app to Azure
|
208 | 208 |
|
209 |
| -[!INCLUDE [functions-publish-project-vscode](../../../includes/functions-deploy-project-vs-code.md)] |
| 209 | +[!INCLUDE [functions-publish-project-vscode](../../../../includes/functions-deploy-project-vs-code.md)] |
210 | 210 |
|
211 | 211 | #### Apps on Functions Premium plan
|
212 | 212 |
|
|
0 commit comments