Ontwikkelen met Durable Task Scheduler

Durable Task Scheduler is een uiterst presterende, volledig beheerde back-endprovider voor Durable Task met een out-of-the-box bewakingsdashboard. Azure biedt twee frameworks voor ontwikkelaarsgeoriënteerde indelingen die werken met Durable Task Scheduler 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.

Duurzame Taakplanner-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 Azure en zorg ervoor dat u de nieuwste CLI-versie hebt.

    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 az durabletask opdrachten.

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 de 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 Durable Task Scheduler te openen.

    Schermopname van de aanmaakpagina voor de Durable Task Scheduler.

  3. Vul de velden in op het tabblad Basisbeginselen . Selecteer Beoordelen en maken.

  4. Zodra de validatie is geslaagd, selecteert u 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 de 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.

Een planner en taakhub verwijderen

  1. Verwijder eerst de taakhub:

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

  2. Verwijder de scheduler:

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

  1. Open de scheduler-resource in de Azure-portal en selecteer Delete:

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

  2. Zoek de scheduler met de taakhub die u wilt verwijderen en selecteer die taakhub. Selecteer Verwijderen:

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

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

Durable Task Scheduler biedt alleen ondersteuning voor verificatie van beheerde identiteiten met behulp van door de gebruiker toegewezen of door het systeem toegewezen identiteiten. Gebruikertoegewezen identiteiten zijn aanbevolen omdat ze niet zijn gekoppeld aan de levenscyclus van de app en opnieuw kunnen worden gebruikt nadat de app niet meer in gebruik is.

Als u uw app toegang wilt verlenen, wijst u de rol Inzender voor duurzame taakgegevens toe aan de beheerde identiteit. Zie Toegang op basis van identiteit configureren in Durable Task Scheduler voor volledige installatiestappen.

Toegang tot het durable Task Scheduler-dashboard

Als u toegang wilt krijgen tot het dashboard Durable Task Scheduler, wijst u de rol Durable Task Dashboard Viewer toe aan uw ontwikkelaarsidentiteit. Zie het dashboard Durable Task Scheduler voor meer informatie.

Verwante inhoud

  • Last updated on