Delen via

Ontwikkelen met Durable Task Scheduler

De Durable Task Scheduler is een uiterst presterende, volledig beheerde back-endprovider voor Durable Functions met een out-of-the-box bewakingsdashboard. Azure biedt twee frameworks voor ontwikkelaarsgeoriënteerde indelingen die met Durable Functions werken om apps te bouwen: Durable Task SDK's en Durable Functions.

In dit artikel leert u het volgende:

  • De Durable Task Scheduler-emulator uitvoeren
  • CRUD-bewerkingen uitvoeren op een planner en een taakhub.

Meer informatie over Durable Task Scheduler-functies, ondersteunde regio's en plannen.

Durable Task Scheduler-emulator

De Durable Task Scheduler-emulator is momenteel alleen beschikbaar als Docker-image.

  1. Haal de Docker-installatiekopie op die de emulator bevat.

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

  2. Voer de emulator uit.

    docker run -itP mcr.microsoft.com/dts/dts-emulator:latest

    Met deze opdracht wordt één taakhub met de naam defaultweergegeven. Als u meer dan één taakhub nodig hebt, kunt u de omgevingsvariabele DTS_TASK_HUB_NAMES in de container instellen op een door komma's gescheiden lijst met taakhubnamen, zoals in de volgende opdracht:

    docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:latest

Vereiste voorwaarden

De CLI instellen

  1. Meld u aan bij de Azure CLI en zorg ervoor dat u de meest recente versie hebt geïnstalleerd.

    az login
az upgrade

  2. Installeer de DURABLE Task Scheduler CLI-extensie.

    az extension add --name durabletask

  3. Als u de DURABLE Task Scheduler CLI-extensie al hebt geïnstalleerd, voert u een upgrade uit naar de nieuwste versie.

    az extension update --name durabletask

  4. Controleer de geïnstalleerde versie:

    az extension show --name durabletask

Meer informatie over de verschillende az durabletask opdrachten die u kunt gebruiken.

Een planner en taakhub maken

  1. Maak een resourcegroep.

    az group create --name YOUR_RESOURCE_GROUP --location LOCATION

  2. Maak een scheduler met behulp van de durabletask CLI-extensie.

    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"

    Het creatieproces kan tot 15 minuten duren.

    Uitvoer

    {
    "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. Een taakhub maken.

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

    Uitvoer

    {
  "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. Zoek in Azure Portal naar Durable Task Scheduler en selecteer deze in de resultaten.

    Schermopname van het zoeken naar de Durable Task Scheduler in de portal.

  2. Klik op Maken om het deelvenster Azure Functions: Durable Task Scheduler te openen.

    Schermopname van de aanmaakpagina voor de Durable Task Scheduler.

  3. Vul de velden in op het tabblad Basisbeginselen. Klik op Controleren + maken.

    Opmerking

    De verbruiks-SKU is momenteel beschikbaar als preview-versie. Ontdek meer over de aanbevolen combinaties van SKU's en orchestratieframeworks voor productiegebruik.

  4. Zodra de validatie is geslaagd, klikt u op Maken.

    De implementatie kan ongeveer 15 tot 20 minuten duren.

Alle Durable Task Scheduler-resources in een abonnement weergeven

  1. Haal een lijst op met alle schedulernamen binnen een abonnement door de volgende opdracht uit te voeren.

    az durabletask scheduler list --subscription <SUBSCRIPTION_ID>

  2. U kunt de resultaten beperken tot een specifieke resourcegroep door de --resource-group vlag toe te voegen.

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

Zoek in Azure Portal naar Durable Task Scheduler en selecteer deze in de resultaten.

Schermopname van het zoeken naar de Durable Task Scheduler-service in de portal.

U ziet de lijst met scheduler-resources die zijn gemaakt in alle abonnementen waarvoor u toegang hebt.

Alle taakhubs weergeven in een Durable Task Scheduler

Haal een lijst met taakhubs op in een specifieke scheduler door het volgende uit te voeren:

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

U kunt alle taakhubs zien die zijn gemaakt in een Scheduler in het overzicht van de resource in de Azure Portal.

Schermopname van het tabblad Overzicht van Durable Task Scheduler in de portal.

De scheduler en taakhub verwijderen

  1. Verwijder de scheduler:

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

  2. Een taakhub verwijderen:

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

  1. Open de scheduler-resource in Azure Portal en klik op Verwijderen:

    Schermopname van scheduler-resource in de portal met de knop Verwijderen gemarkeerd.

  2. Zoek de scheduler met de taakhub die u wilt verwijderen en klik vervolgens op die taakhub. Klik op Verwijderen:

    Schermopname van de taak-hubresource in de portal met de knop Verwijderen gemarkeerd.

Verificatie op basis van identiteit configureren voor app voor toegang tot Durable Task Scheduler

Durable Task Scheduler ondersteunt alleen door de gebruiker toegewezen of door het systeem toegewezen beheerde identiteitverificatie. Door de gebruiker toegewezen identiteiten worden aanbevolen, omdat ze niet zijn gekoppeld aan de levenscyclus van de app en opnieuw kunnen worden gebruikt nadat de inrichting van de app ongedaan is gemaakt.

Meer informatie over op identiteit gebaseerde toegang in Durable Task Scheduler.

Toegang tot het durable Task Scheduler-dashboard

Wijs de vereiste rol toe aan uw ontwikkelaarsidentiteit (e-mail) om toegang te krijgen tot het Durable Task Scheduler-dashboard.

Volgende stappen

Voor het gebruik van Durable Task Scheduler met Durable Functions:

Voor het gebruik van Durable Task Scheduler met de Durable Task SDK's:

  • Last updated on