Utveckla med Durable Task Scheduler (förhandsversion)

2025-05-10

Durable Task Scheduler är en prestationskapabel, fullständigt hanterad backend-tjänst för Durable Functions med en inbyggd övervakningspanel. Azure erbjuder två utvecklarorienterade orkestreringsramverk som fungerar med Durable Functions för att skapa appar: Durable Task SDK:er och Durable Functions.

I den här artikeln lär du dig att:

Kör Durable Task Scheduler-emulatorn
Utför CRUD-åtgärder på en schemaläggare och en aktivitetshubb.

Läs mer om durable task scheduler-funktioner, regioner som stöds och planer.

Durable Task Scheduler-emulator

Durable Task Scheduler-emulatorn är bara tillgänglig som en Docker-avbildning idag.

Hämta docker-avbildningen som innehåller emulatorn.

docker pull mcr.microsoft.com/dts/dts-emulator:latest

Kör emulatorn.
```
docker run -itP mcr.microsoft.com/dts/dts-emulator:latest
```
Det här kommandot exponerar en enda aktivitetshubb med namnet default. Om du behöver mer än en aktivitetshubb kan du ange miljövariabeln i containern DTS_TASK_HUB_NAMES till en kommaavgränsad lista över uppgiftshubbsnamn som i följande kommando:
```
docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:latest
```

Förutsättningar

Den senaste versionen av Azure CLI.

Konfigurera CLI

Logga in på Azure CLI och se till att du har den senaste installerade.
```
az login
az upgrade
```
Installera CLI-tillägget Durable Task Scheduler.
```
az extension add --name durabletask
```
Om du redan har installerat CLI-tillägget Durable Task Scheduler uppgraderar du till den senaste versionen.
```
az extension add --upgrade --name durabletask
```

Skapa en schemaläggare och en aktivitetshubb

Skapa en resursgrupp.

az group create --name YOUR_RESOURCE_GROUP --location LOCATION

Skapa en schemaläggare med hjälp av durabletask CLI-tillägget.

az durabletask scheduler create --name "YOUR_SCHEDULER" --resource-group "YOUR_RESOURCE_GROUP" --location "LOCATION" --ip-allowlist "[0.0.0.0/0]" --sku-name "dedicated" --sku-capacity "1"

Skapandeprocessen kan ta upp till 15 minuter att slutföra.

Resultat

{
    "id": "/subscriptions/YOUR_SUBSCRIPTION_ID/resourceGroups/YOUR_RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/YOUR_SCHEDULER",
    "location": "northcentralus",
    "name": "YOUR_SCHEDULER",
    "properties": {
        "endpoint": "https://YOUR_SCHEDULER.northcentralus.durabletask.io",
        "ipAllowlist": [
            "0.0.0.0/0"
        ],
        "provisioningState": "Succeeded",
        "sku": {
            "capacity": 1,
            "name": "Dedicated",
            "redundancyState": "None"
        }
    },
    "resourceGroup": "YOUR_RESOURCE_GROUP",
    "systemData": {
        "createdAt": "2025-01-06T21:22:59Z",
        "createdBy": "YOUR_EMAIL@example.com",
        "createdByType": "User",
        "lastModifiedAt": "2025-01-06T21:22:59Z",
        "lastModifiedBy": "YOUR_EMAIL@example.com",
        "lastModifiedByType": "User"
    },
    "tags": {}
}

Skapa en aktivitetshubb.

az durabletask taskhub create --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUB

Resultat

{
  "id": "/subscriptions/YOUR_SUBSCRIPTION_ID/resourceGroups/YOUR_RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/YOUR_SCHEDULERS/taskHubs/YOUR_TASKHUB",
  "name": "YOUR_TASKHUB",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "resourceGroup": "YOUR_RESOURCE_GROUP",
  "systemData": {
    "createdAt": "2024-09-18T22:13:56.5467094Z",
    "createdBy": "OBJECT_ID",
    "createdByType": "User",
    "lastModifiedAt": "2024-09-18T22:13:56.5467094Z",
    "lastModifiedBy": "OBJECT_ID",
    "lastModifiedByType": "User"
  },
  "type": "microsoft.durabletask/scheduler/taskhubs"
}

I Azure-portalen söker du efter Durable Task Scheduler och väljer den i resultatet.
Klicka på Skapa för att öppna fönstret Azure Functions: Durable Task Scheduler (förhandsversion).
Fyll i fälten i fliken Grundläggande. Klicka på Granska + skapa. När valideringen har slutförts klickar du på Skapa.

Distributionen kan ta mellan 15 och 20 minuter.

Visa alla durable Task Scheduler-resurser i en prenumeration

Hämta en lista över alla scheduler-namn i en prenumeration genom att köra följande kommando.
```
az durabletask scheduler list --subscription <SUBSCRIPTION_ID>
```

Du kan begränsa resultatet till en specifik resursgrupp genom att lägga till --resource-group flaggan.

az durabletask scheduler list --subscription <SUBSCRIPTION_ID> --resource-group <RESOURCE_GROUP_NAME>

I Azure-portalen söker du efter Durable Task Scheduler och väljer den i resultatet.

Du kan se listan över scheduler-resurser som skapats i alla prenumerationer som du har åtkomst till.

Visa alla uppgiftshubbar i en tålig uppgiftsschemaläggare

Hämta en lista över aktivitetshubbar i en specifik schemaläggare genom att köra:

az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-name <SCHEDULER_NAME>

Du kan se alla aktivitetshubbar som skapats i en schemaläggare i Översikt över resursen på Azure-portalen.

Skärmbild av översiktsfliken för Durable Task Scheduler i portalen.

Ta bort schemaläggaren och aktivitetshubben

Ta bort schemaläggaren:

az durabletask scheduler --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER

Ta bort en aktivitetshubb:

az durabletask taskhub delete --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUB

Öppna scheduler-resursen på Azure-portalen och klicka på Ta bort:
Leta reda på schemaläggaren med den aktivitetshubb som du vill ta bort och klicka sedan på den aktivitetshubben. Klicka på Ta bort:

Konfigurera identitetsbaserad autentisering för appen för åtkomst till Durable Task Scheduler

Durable Task Scheduler stöder endastanvändartilldelad eller systemtilldelad hanterad identitetsautentisering . Användartilldelade identiteter rekommenderas eftersom de inte är kopplade till appens livscykel och kan återanvändas när appen har avetablerats.

Läs mer om identitetsbaserad åtkomst i Durable Task Scheduler.

Få åtkomst till instrumentpanelen för Durable Task Scheduler

Tilldela rollen som krävs till din utvecklaridentitet (e-post) för att få åtkomst till instrumentpanelen Durable Task Scheduler.

Nästa steg

För att använda Durable Task Scheduler med Durable Functions:

Snabbstart: Konfigurera en Durable Functions-app för att använda Azure Functions Durable Task Scheduler

För att använda Durable Task Scheduler med Durable Task SDK:er:

Feedback

Var den här sidan till hjälp?