Skip to content

Commit 2e4bb71

Browse files
committed
fix links and quick sweep for any other dts instead of full name
Signed-off-by: Hannah Hunter <[email protected]>
2 parents 592487d + f0432e5 commit 2e4bb71

9 files changed

+51
-39
lines changed

articles/azure-functions/durable/durable-functions-storage-providers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Durable Functions storage providers - Azure
33
description: Learn about the different storage providers for Durable Functions and how they compare
44
author: cgillum
55
ms.topic: conceptual
6-
ms.date: 03/05/2025
6+
ms.date: 03/17/2025
77
ms.author: azfuncdf
88
#Customer intent: As a developer, I want to understand what storage providers are available Durable Functions and which one I should choose.
99
---

articles/azure-functions/durable/durable-task-scheduler/develop-with-durable-task-scheduler.md

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Develop with the Azure Functions durable task scheduler (preview)
33
description: Learn how to develop with the Azure Functions durable task scheduler and task hub resources
44
author: lilyjma
55
ms.topic: how-to
6-
ms.date: 02/27/2025
6+
ms.date: 03/17/2025
77
ms.author: jiayma
88
ms.reviewer: azfuncdf
99
zone_pivot_groups: dts-devexp
@@ -62,11 +62,11 @@ Learn more about durable task scheduler [features](./durable-task-scheduler.md#f
6262
docker run -itP mcr.microsoft.com/dts/dts-emulator:v0.0.5
6363
```
6464

65-
The command above exposes a single task hub named `default`. If you need more than one task hub, you can set the environment variable `DTS_TASK_HUB_NAMES` on the container to a comma-delimited list of task hub names like below:
65+
The command above exposes a single task hub named `default`. If you need more than one task hub, you can set the environment variable `DTS_TASK_HUB_NAMES` on the container to a comma-delimited list of task hub names like below:
6666

67-
```bash
68-
docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:v0.0.5
69-
```
67+
```bash
68+
docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:v0.0.5
69+
```
7070

7171
## Create a scheduler and task hub
7272

@@ -154,8 +154,8 @@ docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.c
154154
::: zone pivot="az-portal"
155155

156156
You can create a scheduler and task hub on Azure portal via two ways:
157-
- **Function app integrated creation:** *(recommended)* automatically creates the managed identity resource and RBAC assignment needed for your app to access durable task scheduler.
158-
- **Top-level creation:** Requires you to [manually assign RBAC](#configure-identity-based-authentication-for-app-to-access-durable-task-scheduler) to configure scheduler access for your app.
157+
- **Function app integrated creation:** *(recommended)* automatically creates the managed identity resource and RBAC assignment, plus configures required environment variables for your app to access durable task scheduler.
158+
- **Top-level creation:** Requires you to [manually assign RBAC permission](#configure-identity-based-authentication-for-app-to-access-durable-task-scheduler) to configure scheduler access for your app.
159159

160160
> [!NOTE]
161161
> Durable task scheduler currently supports apps hosted in the **App Service** and **Functions Premium** plans, so this experience is available only when either of these plan types is picked.
@@ -266,7 +266,16 @@ You can see all the task hubs created in a scheduler on the **Overview** of the
266266

267267
Durable task scheduler **only** supports either *user-assigned* or *system-assigned* managed identity authentication. **User-assigned identities are recommended,** as they aren't tied to the lifecycle of the app and can be reused after the app is de-provisioned.
268268
269-
The following sections demonstrate how to configure identity resources for your durable functions app to access a scheduler and its task hubs.
269+
The following are the durable task scheduler related roles you can grant to an identity:
270+
271+
- **Durable Task Data Contributor**: Role for all data access operations. This role is a superset of all other roles.
272+
- **Durable Task Worker**: Role used by worker applications to interact with the durable task scheduler. Assign this role if your app is used *only* for processing orchestrations, activities, and entities.
273+
- **Durable Task Data Reader**: Role to read all durable task scheduler data. Assign this role if you only need listing of orchestrations and entities payloads.
274+
275+
> [!NOTE]
276+
> Most durable functions apps would require the Durable Task Data Contributor role.
277+
278+
The sections below demonstrate how to grant permissions to an identity resource and configure your durable functions app to use the identity for access to schedulers and task hubs.
270279
271280
### Assign RBAC (role-based access control) to managed identity resource
272281

articles/azure-functions/durable/durable-task-scheduler/dts-dedicated-sku.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Use the Dedicated SKU for Azure Functions durable task scheduler (preview)
33
description: Learn about how the Dedicated SKU in Azure Functions durable task scheduler.
44
ms.topic: conceptual
5-
ms.date: 03/14/2025
5+
ms.date: 03/17/2025
66
ms.author: azfuncdf
77
author: lilyjma
88
ms.subservice: durable

articles/azure-functions/durable/durable-task-scheduler/durable-task-scheduler-dashboard.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,11 @@ ms.date: 03/17/2025
77

88
# Debug and manage orchestrations using the Azure Functions durable task scheduler dashboard (preview)
99

10-
Observe, manage, and debug your task hub or scheduler's orchestations effectively using the durable task scheduler dashboard. Once you [assign the *Durable Task Data Contributor* role to your developer identity](./develop-with-durable-task-scheduler.md#accessing-durable-task-scheduler-dashboard), you can access the dashboard via either:
11-
- The task hub's dashboard endpoint URL in the Azure portal
12-
- Navigate to `https://dashboard.durabletask.io/` and your task endpoint to connect to it.
13-
14-
> [!NOTE]
15-
> Ensure [your developer identity (email) has the **Durable Task Data Contributor** role assigned to it](./develop-with-durable-task-scheduler.md#accessing-durable-task-scheduler-dashboard) before accessing the dashboard.
10+
Observe, manage, and debug your task hub or scheduler's orchestations effectively using the durable task scheduler dashboard. The dashboard is available when you run the [durable task scheduler emulator](./durable-task-scheduler.md#emulator-for-local-development) locally or create a scheduler resource on Azure.
11+
- **Running locally** doesn't require authentication.
12+
- **Creating a scheduler resource on Azure** requires that you [assign the *Durable Task Data Contributor* role to your identity](./develop-with-durable-task-scheduler.md#accessing-durable-task-scheduler-dashboard). You can then access the dashboard via either:
13+
- The task hub's dashboard endpoint URL in the Azure portal
14+
- Navigate to `https://dashboard.durabletask.io/` and your task hub endpoint to connect to it.
1615

1716
## Monitor orchestration progress and execution history
1817

articles/azure-functions/durable/durable-task-scheduler/durable-task-scheduler.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Azure Functions durable task scheduler backend for durable functions (preview)
33
description: Learn about the characteristics of the Azure Functions durable task scheduler backend.
44
ms.topic: conceptual
5-
ms.date: 03/05/2025
5+
ms.date: 03/17/2025
66
ms.author: azfuncdf
77
author: hhunter-ms
88
ms.subservice: durable
@@ -32,13 +32,13 @@ The following diagram shows the architecture of the durable task scheduler backe
3232

3333
The durable task scheduler runs in Azure as a separate resource from the app. This separation allows the scheduler to scale independently of the app and provides better isolation between the two components. This isolation is important for several reasons:
3434

35-
- **Reduced resource consumption**: BYO storage providers can consume a significant amount of CPU and memory resources. This resource consumption is due to the overhead of managing partitions and other complex state store interactions. By using a managed scheduler instead of a BYO storage provider, your app instances can run more efficiently and with less resource contention.
35+
- **Reduced resource consumption:** BYO storage providers can consume a significant amount of CPU and memory resources. This resource consumption is due to the overhead of managing partitions and other complex state store interactions. By using a managed scheduler instead of a BYO storage provider, your app instances can run more efficiently and with less resource contention.
3636

37-
- **Fault isolation**: Stability or availability issues in the durable task scheduler will not affect the stability or availability of your connected apps. With BYO storage providers, instability in the backend provider (which is a complex component) can create instability in the app logic. By separating the scheduler from the app, you can reduce the risk of cascading failures and improve overall reliability.
37+
- **Fault isolation:** Stability or availability issues in the durable task scheduler will not affect the stability or availability of your connected apps. With BYO storage providers, instability in the backend provider (which is a complex component) can create instability in the app logic. By separating the scheduler from the app, you can reduce the risk of cascading failures and improve overall reliability.
3838

39-
- **Independent scaling**: The scheduler resource can be scaled independently of the app, allowing for better infrastructure resource management and cost optimization. For example, multiple apps can share the same scheduler resource, improving overall resource utilization. This capability is especially useful for organizations with multiple teams or projects that require durable functions.
39+
- **Independent scaling:** The scheduler resource can be scaled independently of the app, allowing for better infrastructure resource management and cost optimization. For example, multiple apps can share the same scheduler resource, improving overall resource utilization. This capability is especially useful for organizations with multiple teams or projects that require durable functions.
4040

41-
- **Improved support experience**: The durable task scheduler is a managed service, which means that Azure can provide better support and diagnostics for issues related to the scheduler. When using a BYO storage provider, you might need to troubleshoot issues related to the backend provider, which can be complex and time-consuming. A managed service allows Azure to take care of the underlying infrastructure and provide a more streamlined support experience.
41+
- **Improved support experience:** The durable task scheduler is a managed service, which means that Azure can provide better support and diagnostics for issues related to the scheduler. When using a BYO storage provider, you might need to troubleshoot issues related to the backend provider, which can be complex and time-consuming. A managed service allows Azure to take care of the underlying infrastructure and provide a more streamlined support experience.
4242

4343
### App connectivity
4444

@@ -126,17 +126,17 @@ This benchmark showed that the durable task scheduler is roughly **five times fa
126126

127127
The *Consumption*, *Flex Consumption*, and *Azure Container App* hosting plans aren't yet supported when using the durable task scheduler.
128128

129-
- **Available regions**: Durable task scheduler resources can be created in a subset of Azure regions today. You can run the following command to get a list of the supported regions:
129+
- **Available regions:** Durable task scheduler resources can be created in a subset of Azure regions today. You can run the following command to get a list of the supported regions:
130130

131131
```bash
132132
az provider show --namespace Microsoft.DurableTask --query "resourceTypes[?resourceType=='schedulers'].locations | [0]" --out table
133133
```
134134

135135
Consider using the same region for your durable functions app and the durable task scheduler resources. Having these resources in different regions might impact performance and limit certain network-related functionality.
136136

137-
- **Scheduler quota**: You can currently create up to **five schedulers per region** per subscription.
137+
- **Scheduler quota:** You can currently create up to **five schedulers per region** per subscription.
138138

139-
- **Max payload size**: The durable task scheduler has a maximum payload size restrictions for the following JSON-serialized data types:
139+
- **Max payload size:** The durable task scheduler has a maximum payload size restrictions for the following JSON-serialized data types:
140140

141141
| Data type | Max size |
142142
| --------- | -------- |
@@ -146,7 +146,7 @@ This benchmark showed that the durable task scheduler is roughly **five times fa
146146
| Orchestration custom status | 1 MB |
147147
| Entity state | 1 MB |
148148

149-
- **Feature parity**: Some features might not be available in the durable task scheduler backend yet. For example, at the time of writing, the durable task scheduler doesn't support the following features:
149+
- **Feature parity:** Some features might not be available in the durable task scheduler backend yet. For example, at the time of writing, the durable task scheduler doesn't support the following features:
150150
151151
- [Orchestration rewind](../durable-functions-instance-management.md#rewind-instances-preview)
152152
- [Extended sessions](../durable-functions-azure-storage-provider.md#extended-sessions)

articles/azure-functions/durable/durable-task-scheduler/includes/assign-dev-identity-rbac-portal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
ms.service: azure-functions
33
ms.topic: include
4-
ms.date: 01/30/2025
4+
ms.date: 03/17/2025
55
ms.author: jiayma
66
ms.reviewer: azfuncdf
77
author: lilyjma

articles/azure-functions/durable/durable-task-scheduler/includes/assign-rbac-portal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
ms.service: azure-functions
33
ms.topic: include
4-
ms.date: 01/30/2025
4+
ms.date: 03/17/2025
55
---
66

77
> [!NOTE]

articles/azure-functions/durable/durable-task-scheduler/includes/function-app-integrated-creation.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -23,28 +23,28 @@ author: lilyjma
2323
| Do you want to deploy code or container image? | Keep the **Code** option selected. |
2424
| Runtime stack | Select the runtime you're using for this quickstart. |
2525
| Version | Select your runtimei stack version. |
26-
| Region | Select [one of the supported regions](../durable-task-scheduler.md). |
26+
| Region | Select [one of the supported regions](../durable-task-scheduler.md#limitations-and-considerations). |
2727
| Operating System | Select your operating system. |
2828

2929
1. Select the **Durable Functions** tab.
3030

3131
1. Choose **Durable Task Scheduler** as the backend provider for your durable functions.
3232

33-
1. Create a scheduler resource. This action automatically creates a task hub.
33+
1. Create a scheduler resource. This action will automatically create a task hub.
3434

3535
:::image type="content" source="../media/create-durable-task-scheduler/durable-func-tab.png" alt-text="Screenshot of creating an App Service plan Function app.":::
3636

3737
| Field | Description |
3838
| ----- | ----------- |
3939
| Storage backend | Select **Durable Task Scheduler**. |
40-
| Region | Select the same region you selected in the Basics tab for your function app. |
40+
| Region | It is recommended that the scheduler and function app regions should be the same. |
4141
| Durable task scheduler | Use the scheduler name offered, or click **Create new** to create a custom name. |
42-
| Plan | Select the **Dedicated** plan. |
42+
| Plan | Only **Dedicated** is available at the moment. |
4343
| Capacity units | Currently, you can only choose one Capacity Unit as an option. |
4444

4545
1. Click **Review + create** to review the resource creation.
4646

47-
A user-assigned managed identity with the required RBAC role has been created automatically so that the Function app can access durable task scheduler. You can find in the summary view information related to the managed identity resource, such as:
47+
A user-assigned managed identity with the required RBAC permission will be created automatically so that the Function app can access durable task scheduler. You can find in the summary view information related to the managed identity resource, such as:
4848
- The RBAC assigned to it (*Durable Task Data Contributor*)
4949
- The assignment scope (the scheduler or task hub name)
5050

articles/azure-functions/durable/durable-task-scheduler/quickstart-durable-task-scheduler.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Quickstart: Set a durable functions app to use Azure Functions durable t
33
description: Learn how to configure an existing durable functions app to use Azure Functions durable task scheduler.
44
author: lilyjma
55
ms.topic: how-to
6-
ms.date: 03/05/2025
6+
ms.date: 03/17/2025
77
ms.author: jiayma
88
ms.reviewer: azfuncdf
99
zone_pivot_groups: dts-runtime
@@ -28,7 +28,7 @@ In this quickstart, you configure a durable functions app to use the [durable ta
2828
## Prerequisites
2929

3030
This quickstart assumes you alredy have an Azure Functions project on your local computer with:
31-
- Durable functions added to your project include:
31+
- Durable functions added to your project including:
3232
- An [orchestrator function](../durable-functions-bindings.md#orchestration-trigger).
3333
- A [client function](../durable-functions-bindings.md#orchestration-client) that triggers the durable functions app.
3434
- The project configured for local debugging.
@@ -180,7 +180,7 @@ Get the durable task scheduler emulator port number in [the next step](#set-up-d
180180

181181
1. Run the application.
182182

183-
```sh
183+
```bash
184184
func start
185185
```
186186

@@ -216,6 +216,8 @@ Get the durable task scheduler emulator port number in [the next step](#set-up-d
216216
1. Click on the *default* task hub to see its dashboard.
217217

218218
> [!NOTE]
219+
> Learn more about the [durable task scheduler dashboard](./durable-task-scheduler-dashboard.md).
220+
>
219221
> The [durable task scheduler emulator](./durable-task-scheduler.md#emulator-for-local-development) stores orchestration data in memory, which means all data is lost when it shuts down.
220222
>
221223
> Running into issues testing? [See the troubleshooting guide.](./troubleshoot-durable-task-scheduler.md)
@@ -228,6 +230,8 @@ Create a durable task scheduler instance and Azure Functions app on Azure follow
228230

229231
[!INCLUDE [function-app-integrated-creation](./includes/function-app-integrated-creation.md)]
230232

233+
Resource deployment could take around 15 to 20 minutes. Once that is finished, you can deploy your app to Azure.
234+
231235
### Deploy your function app to Azure
232236

233237
[!INCLUDE [functions-publish-project-vscode](../../../../includes/functions-deploy-project-vs-code.md)]
@@ -244,17 +248,17 @@ If your app is running on the Functions Premium plan, turn on the *Runtime Scale
244248

245249
Run the following command to get your function's URL:
246250

247-
```bash
248-
az functionapp function list --resource-group <RESOURCE_GROUP_NAME> --name <FUNCTION_APP_NAME> --query '[].{Function:name, URL:invokeUrlTemplate}' --output table
251+
```azurecli
252+
az functionapp function list --resource-group <RESOURCE_GROUP_NAME> --name <FUNCTION_APP_NAME> --query '[].{Function:name, URL:invokeUrlTemplate}' --output json
249253
```
250254

251255
### Check orchestration status
252256

253-
Check the status of the orchestration instance and activity details on the durable task scheduler dashboard. Accessing the dashboard requires you to login. Follow the instructions below to assign the required role to your identity.
257+
Check the status of the orchestration instance and activity details on the durable task scheduler dashboard. Accessing the dashboard requires you to login. Follow the instructions below to assign the required role-based access control (RBAC) permission to your identity.
254258

255259
[!INCLUDE [assign-dev-identity-rbac-portal](./includes/assign-dev-identity-rbac-portal.md)]
256260

257-
Finally, navigate to `https://dashboard.durabletask.io/` and click on **Add Endpoint**. Fill out the required fields to connect the task hub.
261+
Finally, click **Overview** on the left menu of the task hub resource and navigate to the dashboard URL located at the top *Essentials* section.
258262

259263
## Clean up resources
260264

0 commit comments

Comments
 (0)