|
1 | 1 | ---
|
2 |
| -title: "Quickstart: Set a Durable Functions app to use Azure Functions Durable Task Scheduler (preview)" |
| 2 | +title: "Quickstart: Configure 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 | 5 | ms.date: 04/24/2025
|
6 | 6 | zone_pivot_groups: dts-runtime
|
7 | 7 | ---
|
8 | 8 |
|
9 |
| -# Quickstart: Set a Durable Functions app to use Azure Functions Durable Task Scheduler (preview) |
| 9 | +# Quickstart: Configure a Durable Functions app to use Azure Functions Durable Task Scheduler (preview) |
10 | 10 |
|
11 | 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-functions-storage-providers.md), also known as *backends*, for storing orchestration and entity runtime state. |
| 13 | +You can use the Durable Task Scheduler as a backend for your Durable Functions, to store orchestration and entity runtime state. |
14 | 14 |
|
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**. |
| 15 | +In this quickstart, you: |
| 16 | + |
| 17 | +> [!div class="checklist"] |
| 18 | +> * Configure an existing Durable Functions app to use the Durable Task Scheduler. |
| 19 | +> * Set up the Durable Task emulator for local development. |
| 20 | +> * Deploy your app to Azure on the App Service plan using Visual Studio Code. |
| 21 | +> * Monitor the status of your app and task hub on the Durable Task Scheduler dashboard. |
16 | 22 |
|
17 | 23 | > [!NOTE]
|
18 |
| -> |
19 |
| -> - To learn more about the benefit of using Durable Task Scheduler, see [Durable Functions backend providers overview](../durable-functions-storage-providers.md). |
20 |
| -> |
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 |
| -> |
23 |
| -> - Durable Task Scheduler currently only supports Durable Functions running on **Functions Premium** and **App Service** plans. |
| 24 | +> Durable Task Scheduler currently only supports Durable Functions running on **Functions Premium** and **App Service** plans. |
24 | 25 |
|
25 | 26 | ## Prerequisites
|
26 | 27 |
|
@@ -56,15 +57,15 @@ You also need:
|
56 | 57 |
|
57 | 58 | ::: zone pivot="csharp"
|
58 | 59 |
|
59 |
| -> [!NOTE] |
60 |
| -> The Durable Task Scheduler extension requires **Microsoft.Azure.Functions.Worker.Extensions.DurableTask** version `1.2.2` or higher. |
61 |
| -
|
62 | 60 | Install the latest version of the [Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged) package by using the [dotnet add package](/dotnet/core/tools/dotnet-add-package) command:
|
63 | 61 |
|
64 | 62 | ```bash
|
65 | 63 | dotnet add package Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged --prerelease
|
66 | 64 | ```
|
67 | 65 |
|
| 66 | +> [!NOTE] |
| 67 | +> The Durable Task Scheduler extension requires **Microsoft.Azure.Functions.Worker.Extensions.DurableTask** version `1.2.2` or higher. |
| 68 | +
|
68 | 69 | ::: zone-end
|
69 | 70 |
|
70 | 71 | ::: zone pivot="other"
|
@@ -116,20 +117,18 @@ Add connection information for local development:
|
116 | 117 | }
|
117 | 118 | ```
|
118 | 119 |
|
119 |
| -Get the Durable Task Scheduler emulator port number in [the next step](#set-up-durable-task-scheduler-emulator). |
120 |
| - |
121 |
| -## Set up Durable Task Scheduler emulator |
| 120 | +## Set up Durable Task emulator |
122 | 121 |
|
123 | 122 | 1. Pull the docker image containing the emulator.
|
124 | 123 |
|
125 | 124 | ```bash
|
126 |
| - docker pull mcr.microsoft.com/dts/dts-emulator:v0.0.5 |
| 125 | + docker pull mcr.microsoft.com/dts/dts-emulator:v0.0.6 |
127 | 126 | ```
|
128 | 127 |
|
129 | 128 | 1. Run the emulator.
|
130 | 129 |
|
131 | 130 | ```bash
|
132 |
| - docker run -d -p 8080:8080 -p 8082:8082 mcr.microsoft.com/dts/dts-emulator:v0.0.5 |
| 131 | + docker run -d -p 8080:8080 -p 8082:8082 mcr.microsoft.com/dts/dts-emulator:v0.0.6 |
133 | 132 | ```
|
134 | 133 |
|
135 | 134 | The following output indicates the emulator started successfully.
|
|
0 commit comments