Utveckla med Durable Task Scheduler

Durable Task Scheduler är en högpresterande, fullständigt hanterad backendtjänst för Durable Task med en redo att använda övervakningsinstrumentpanel. Azure erbjuder två utvecklarorienterade orkestreringsramverk som fungerar med Durable Task Scheduler 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.

Hållbar uppgiftsschemaemulator

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

  1. Hämta Docker-avbildningen som innehåller emulatorn.

    docker pull mcr.microsoft.com/dts/dts-emulator:latest
    
  2. 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

Konfigurera CLI

  1. Logga in på Azure och kontrollera att du har den senaste CLI-versionen.

    az login
    az upgrade
    
  2. Installera CLI-tillägget Durable Task Scheduler.

    az extension add --name durabletask
    
  3. Om du redan har installerat CLI-tillägget Durable Task Scheduler uppgraderar du till den senaste versionen.

    az extension update --name durabletask
    
  4. Kontrollera din installerade version:

    az extension show --name durabletask
    

Läs mer om kommandona för az durabletask.

Skapa en schemaläggare och en aktivitetshubb

  1. Skapa en resursgrupp.

    az group create --name YOUR_RESOURCE_GROUP --location LOCATION
    
  2. 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": {}
    }
    
  3. 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"
    }
    
  1. I Azure-portalen söker du efter Durable Task Scheduler och väljer den i resultatet.

    Skärmbild av sökning efter Durable Task Scheduler i portalen.

  2. Välj Skapa för att öppna fönstret Durable Task Scheduler .

    Skärmbild av sidan Skapa för Durable Task Scheduler.

  3. Fyll i fälten på fliken Grundläggande . Välj Granska + skapa.

  4. När valideringen har godkänts väljer du Skapa.

    Distributionen kan ta mellan 15 och 20 minuter.

Visa alla durable Task Scheduler-resurser i en prenumeration

  1. 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>
    
  2. 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.

Skärmbild av sökning efter tjänsten Durable Task Scheduler i portalen.

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 en schemaläggare och en aktivitetshubb

  1. Ta först bort aktivitetshubben:

    az durabletask taskhub delete --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUB
    
  2. Ta bort schemaläggaren:

    az durabletask scheduler delete --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER
    
  1. Öppna scheduler-resursen i Azure-portalen och välj Delete:

    Skärmbild av scheduler-resursen i portalen som markerar borttagningsknappen.

  2. Leta reda på schemaläggaren med den aktivitetshubb som du vill ta bort och välj sedan den aktivitetshubben. Välj Ta bort:

    Skärmbild av aktivitetshubbens resurs i portalen som markerar borttagningsknappen.

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

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

Om du vill ge din app åtkomst tilldelar du rollen Durable Task Data Contributor till den hanterade identiteten. Fullständiga installationssteg finns i Konfigurera identitetsbaserad åtkomst i Durable Task Scheduler.

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

Om du vill komma åt Durable Task Scheduler-instrumentpanelen, tilldela rollen Durable Task Dashboard Viewer till din utvecklaridentitet. Mer information finns i Instrumentpanelen för Durable Task Scheduler.