Merge pull request #299434 from hhunter-ms/release-dts

Copyedit/accuracy pass

Author: JamesJBarnett

articles/azure-functions/durable/TOC.yml

@@ -35,13 +35,13 @@
   - name: Create a Durable Functions app - Java
     displayName: get started, chaining
     href: quickstart-java.md
-  - name: Create an app with Durable Task SDK and Durable Task Scheduler
-    displayName: get started, durable task scheduler
-    href: ./durable-task-scheduler/quickstart-portable-durable-task-sdks.md
   - name: Configure Durable Functions app with Durable Task Scheduler
     displayName: get started, durable task scheduler
     href: ./durable-task-scheduler/quickstart-durable-task-scheduler.md
-  - name: Configure a container app with Durable Task SDK and Durable Task Scheduler
+  - name: Create an app with Durable Task SDK and Durable Task Scheduler
+    displayName: get started, durable task scheduler
+    href: ./durable-task-scheduler/quickstart-portable-durable-task-sdks.md
+  - name: Host a Durable Task SDK app on Azure Container Apps
     displayName: get started, durable task scheduler
     href: ./durable-task-scheduler/quickstart-container-apps-durable-task-sdk.md
   - name: Configure Durable Functions app with MSSQL
@@ -116,28 +116,24 @@
     href: ./durable-task-scheduler/durable-task-scheduler.md
   - name: Choosing an orchestration framework
     href: ./durable-task-scheduler/choose-orchestration-framework.md
-  - name: Concepts
-    items:
-    - name: Identity
-      href: ./durable-task-scheduler/durable-task-scheduler-identity.md
-    - name: Monitoring dashboard
-      href: ./durable-task-scheduler/durable-task-scheduler-dashboard.md
-    - name: Auto-purge 
-      href: ./durable-task-scheduler/durable-task-scheduler-auto-purge.md
+  - name: Create Durable Task Scheduler resources
+    href: ./durable-task-scheduler/develop-with-durable-task-scheduler.md
+  - name: Identity
+    href: ./durable-task-scheduler/durable-task-scheduler-identity.md
+  - name: Monitoring dashboard
+    href: ./durable-task-scheduler/durable-task-scheduler-dashboard.md
+  - name: Auto-purge 
+    href: ./durable-task-scheduler/durable-task-scheduler-auto-purge.md
   - name: Durable Functions
     items:
       - name: Throughput benchmark
         href: ./durable-task-scheduler/durable-task-scheduler-work-item-throughput.md
-      - name: How-to guides
-        items:
-          - name: Create Durable Task Scheduler 
-            href: ./durable-task-scheduler/develop-with-durable-task-scheduler.md
+      - name: Durable Task Scheduler in Durable Functions
+        href: ./durable-task-scheduler/develop-with-durable-task-scheduler-functions.md
   - name: Durable Task SDKs
     items:
-    - name: How-to guides
-      items:
-      - name: Autoscaling with the Durable Task SDKs in Azure Container Apps
-        href: ./durable-task-scheduler/durable-task-scheduler-auto-scaling.md
+    - name: Configure autoscale for Azure Container Apps hosting
+      href: ./durable-task-scheduler/durable-task-scheduler-auto-scaling.md
   - name: Billing
     href: ./durable-task-scheduler/durable-task-scheduler-dedicated-sku.md
   - name: Troubleshoot
@@ -170,8 +166,8 @@
       items:
       - name: Durable Functions
         href: /python/api/azure-functions-durable/azure.durable_functions
-      - name: Durable Task SDK
-        href: /python/api/azure-functions-durable/azure.durable_functions #placeholder
+      - name: Durable Task SDK - Management APIs
+        href: /python/api/azure-mgmt-durabletask/azure.mgmt.durabletask
     - name: Java API
       items:
        - name: Durable Functions

articles/azure-functions/durable/durable-functions-mssql-container-apps-hosting.md

@@ -2,20 +2,22 @@
 title: Choosing an orchestration framework
 description: Learn which orchestration framework works for your scenario.
 ms.topic: conceptual
-ms.date: 05/05/2025
+ms.date: 05/06/2025
 ---
 
 # Choosing an orchestration framework
 
-Azure offers two developer-oriented orchestration frameworks you can use to build apps: **Durable Task SDKs** and **Durable Functions**. In this article, you learn:
+Azure offers two developer-oriented orchestration frameworks you can use to build apps: **Durable Task SDKs** and **Durable Functions**. These frameworks simplify the implementation of application patterns involving complex, long-running, and multi-step operations by providing built-in state persistence and automatic retries. These frameworks ensure durable execution, meaning code can continue executing even with interruptions or infrastructure failures. Since all state information is persisted, execution continues in another process or machine from the point of failure.
+
+In this article, you learn:
 
 > [!div class="checklist"]
 > - The benefits of using an orchestration framework.
 > - Which framework works best for your scenario. 
 
 ## Scenarios requiring orchestration 
 
-Application or orchestration patterns that benefit from the statefulness offered by an orchestration framework include: 
+Application patterns that benefit from the Durable Task SDKs and Durable Functions include: 
 - **Function chaining:** For executing sequential workflow steps in order, passing data between steps with data transformations at each step, and building pipelines where each activity builds on the previous one.
 - **Fan-out/fan-in:** For batch jobs, ETL (extract, transfer, and load), and any scenario that requires parallel processing. 
 - **Human interactions:** For two-factor authentication, workflows that require human approval. 
@@ -125,12 +127,16 @@ Walk through one of the following quickstarts to configure your applications to
 | **Local development quickstart** | [Create an app with Durable Task SDKs and Durable Task Scheduler](./quickstart-portable-durable-task-sdks.md) using either the .NET, Python, or Java SDKs. | Run a fan-in/fan-out orchestration locally using the Durable Task Scheduler emulator and review orchestration history using the dashboard. |
 | **Deploy to Azure Container Apps using Azure Developer CLI** | [Configure Durable Task SDKs in your container app with Azure Functions Durable Task Scheduler][./quickstart-container-apps-durable-task-sdk.md] | Deploy a function chaining pattern solution using the Azure Developer CLI. |
 
-## Limitations
- 
-- **The Durable Task Framework (DTFx) support**
-   - DTFx is an open-source .NET orchestration framework similar to the .NET Durable Task SDK. While it *can* be used to build apps that run on platforms like Azure Kubernetes Services, **DTFx doesn't receive official Microsoft support**.
+
+> [!NOTE]
+> The Durable Task Framework (DTFx) is an open-source .NET orchestration framework similar to the .NET Durable Task SDK. While it *can* be used to build apps that run on platforms like Azure Kubernetes Services, **DTFx doesn't receive official Microsoft support**.
 
 ## Next steps
 
-> [!div class="nextstepaction"]
-> [Learn more about the Durable Task Scheduler](./durable-task-scheduler.md) 
+For Durable Task Scheduler for Durable Functions:
+- [Quickstart: Configure a Durable Functions app to use Azure Functions Durable Task Scheduler](./quickstart-durable-task-scheduler.md)
+- [Develop with the Azure Functions Durable Task Scheduler](./develop-with-durable-task-scheduler.md)
+
+For Durable Task Scheduler for the Durable Task SDKs:
+- [Quickstart: Create an app with Durable Task SDK and Durable Task Scheduler](./quickstart-portable-durable-task-sdks.md)
+- [Quickstart: Configure a container app with Durable Task SDK and Durable Task Scheduler](./quickstart-container-apps-durable-task-sdk.md)

articles/azure-functions/durable/durable-task-scheduler/choose-orchestration-framework.md

@@ -0,0 +1,115 @@
+---
+title: Azure Functions Durable Task Scheduler in Durable Functions (preview)
+description: Learn how to develop with the Azure Functions Durable Task Scheduler for Durable Functions.
+ms.topic: how-to
+ms.date: 05/06/2025
+---
+
+# Durable Task Scheduler in Durable Functions (preview)
+
+The Azure Functions Durable Task Scheduler is a highly performant, fully managed backend provider for Durable Functions with an [out-of-the-box monitoring dashboard](./durable-task-scheduler-dashboard.md). Azure Functions extensions built into Durable Functions makes building event-driven scenarios easy. In this article, you learn how to:
+
+> [!div class="checklist"]
+> * Create a scheduler and task hub. 
+> * Configure identity-based authentication for your application to access Durable Task Scheduler.
+> * Monitor the status of your app and task hub on the Durable Task Scheduler dashboard. 
+
+Learn more about Durable Task Scheduler [features](./durable-task-scheduler.md#feature-highlights), [supported regions](./durable-task-scheduler.md#limitations-and-considerations), and [plans](./durable-task-scheduler.md#limitations-and-considerations).
+
+## Create a scheduler and task hub
+
+You can create a scheduler and task hub on Azure portal via two ways: 
+- **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.
+- **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.
+
+> [!NOTE]
+> 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. 
+
+# [Function app integrated creation](#tab/function-app-integrated-creation)  
+
+You can create a scheduler and a task hub as part of the Function app creation on Azure portal. 
+
+[!INCLUDE [function-app-integrated-creation](./includes/function-app-integrated-creation.md)]
+
+# [Top-level creation](#tab/top-level-creation) 
+
+1. In the Azure portal, search for **Durable Task Scheduler** and select it from the results. 
+
+    :::image type="content" source="media/create-durable-task-scheduler/search-for-durable-task-scheduler.png" alt-text="Screenshot of searching for the Durable Task Scheduler in the portal.":::
+
+1. Click **Create** to open the **Azure Functions: Durable Task Scheduler (preview)** pane.
+
+    :::image type="content" source="media/create-durable-task-scheduler/top-level-create-form.png" alt-text="Screenshot of the create page for the Durable Task Scheduler.":::
+
+1. Fill out the fields in the **Basics** tab. Click **Review + create**. Once the validation passes, click **Create**. 
+
+    Deployment may take around 15 to 20 minutes. 
+
+---
+
+## View all Durable Task Scheduler resources in a subscription
+
+In the Azure portal, search for **Durable Task Scheduler** and select it from the results. 
+
+:::image type="content" source="media/create-durable-task-scheduler/search-for-durable-task-scheduler.png" alt-text="Screenshot of searching for the Durable Task Scheduler service in the portal.":::
+
+You can see the list of scheduler resources created in all subscriptions you have access to. 
+
+## View all task hubs in a Durable Task Scheduler
+
+You can see all the task hubs created in a scheduler on the **Overview** of the resource on Azure portal. 
+
+:::image type="content" source="media/create-durable-task-scheduler/durable-task-scheduler-overview-portal.png" alt-text="Screenshot of overview tab of Durable Task Scheduler in the portal.":::
+
+## Delete the scheduler and task hub
+
+1. Open the scheduler resource on Azure portal and click **Delete**: 
+
+    :::image type="content" source="media/create-durable-task-scheduler/durable-task-scheduler-delete-portal.png" alt-text="Screenshot of scheduler resource in the portal highlighting delete button.":::
+
+1. Find the scheduler with the task hub you want to delete, then click into that task hub. Click **Delete**:
+
+    :::image type="content" source="media/create-durable-task-scheduler/task-hub-delete-portal.png" alt-text="Screenshot of task hub resource in the portal highlighting delete button.":::
+
+## Configure identity-based authentication for app to access Durable Task Scheduler
+
+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 deprovisioned.
+
+If you haven't already, [configure managed identity for your Durable Functions app](./durable-task-scheduler-identity.md).
+
+## Access the Durable Task Scheduler dashboard
+
+[Assign the required role to your *developer identity (email)*](./durable-task-scheduler-dashboard.md#access-the-durable-task-scheduler-dashboard) to gain access to the Durable Task Scheduler dashboard. 
+
+## Auto scaling in Functions Premium plan 
+
+For Durable Functions apps on the Functions Premium plan, you can enable autoscaling using the *Runtime Scale Monitoring* setting. 
+
+1. In the portal overview of your function app, navigate to **Settings** > **Configuration**.
+
+1. Under the **Function runtime settings** tab, turn on **Runtime Scale Monitoring**. 
+
+    :::image type="content" source="media/develop-with-durable-task-scheduler/runtime-scale-monitoring.png" alt-text="Screenshot of searching for Durable Task Scheduler in the portal.":::
+
+You can also set autoscaling using the Azure CLI.
+
+```azurecli
+az resource update -g <resource_group> -n <function_app_name>/config/web --set properties.functionsRuntimeScaleMonitoringEnabled=1 --resource-type Microsoft.Web/sites
+```
+
+## Limitations
+
+- **Supported hosting plans:** 
+
+   The Durable Task Scheduler currently only supports Durable Functions running on *Functions Premium* and *App Service* plans. For apps running on the Functions Premium plan, you must [enable the *Runtime Scale Monitoring* setting](#auto-scaling-in-functions-premium-plan) to get auto scaling of the app.
+
+   The *Consumption*, *Flex Consumption*, and *Azure Container App* hosting plans aren't yet supported when using the Durable Task Scheduler.
+
+- **Migrating [task hub data](../durable-functions-task-hubs.md) across backend providers:** 
+
+   Currently, migrating across providers 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.
+
+## Next steps
+
+> [!div class="nextstepaction"]
+> [Run and deploy your Durable Functions app using the Durable Task Scheduler](./quickstart-durable-task-scheduler.md)