Sviluppare utilizzando Durable Task Scheduler

Durable Task Scheduler è un provider back-end completamente gestito a prestazioni elevate per Durable Task con un dashboard di monitoraggio predefinito. Azure offre due framework di orchestrazione orientati agli sviluppatori che funzionano con Durable Task Scheduler per creare app: DURABLE Task SDK e Durable Functions.

In questo articolo si apprenderà come:

  • Eseguire l'emulatore di Durable Task Scheduler
  • Eseguire operazioni CRUD su un'utilità di pianificazione e un hub attività.

Altre informazioni sulle funzionalità del Pianificatore di Attività Durable, sulle aree supportate e sui piani.

Emulatore del pianificatore di attività durevoli

L'emulatore dell'utilità di pianificazione durable task è attualmente disponibile solo come immagine Docker.

  1. Scaricare l'immagine Docker contenente l'emulatore.

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

  2. Eseguire l'emulatore.

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

    Questo comando espone un singolo hub delle attività denominato default. Se sono necessari più hub attività, è possibile impostare la variabile DTS_TASK_HUB_NAMES di ambiente nel contenitore su un elenco delimitato da virgole di nomi di hub attività come nel comando seguente:

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

Prerequisiti

Configurare la CLI

  1. Accedere a Azure e assicurarsi di avere la versione più recente dell'interfaccia della riga di comando.

    az login
az upgrade

  2. Installare l'estensione dell'interfaccia della riga di comando di Durable Task Scheduler.

    az extension add --name durabletask

  3. Se è già stata installata l'estensione dell'interfaccia della riga di comando di Durable Task Scheduler, eseguire l'aggiornamento alla versione più recente.

    az extension update --name durabletask

  4. Controllare la versione installata:

    az extension show --name durabletask

Altre informazioni sui comandi di az durabletask.

Creare un pianificatore e un hub attività

  1. Crea un gruppo di risorse.

    az group create --name YOUR_RESOURCE_GROUP --location LOCATION

  2. Usando l'estensione durabletask dell'interfaccia della riga di comando, creare un pianificatore.

    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"

    Il completamento del processo di creazione può richiedere fino a 15 minuti.

    Risultato

    {
    "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. Creare un hub attività.

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

    Risultato

    {
  "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. Nel portale di Azure cercare Durable Task Scheduler e selezionarlo nei risultati.

    Screenshot della ricerca del Pianificatore di attività durevole nel portale.

  2. Scegli Crea per aprire il riquadro Scheduler delle attività durature.

    Screenshot della pagina di creazione per il Pianificatore di attività durevole.

  3. Compilare i campi nella scheda Informazioni di base . Selezionare Rivedi e crea.

  4. Al termine della convalida, selezionare Crea.

    La distribuzione può richiedere da 15 a 20 minuti.

Visualizza tutte le risorse del Scheduler di Attività Durabile nella sottoscrizione

  1. Ottenere un elenco di tutti i nomi dei scheduler nella sottoscrizione eseguendo il comando seguente.

    az durabletask scheduler list --subscription <SUBSCRIPTION_ID>

  2. È possibile limitare i risultati a un gruppo di risorse specifico aggiungendo il --resource-group flag .

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

Nel portale di Azure cercare Durable Task Scheduler e selezionarlo nei risultati.

Screenshot della ricerca del servizio Pianificatore di attività durevole nel portale.

È possibile visualizzare l'elenco delle risorse dell'utilità di pianificazione create in tutte le sottoscrizioni a cui si ha accesso.

Visualizzare tutti gli hub attività in un Pianificatore di attività durevole

Ottenere un elenco di hub di attività in un pianificatore specifico eseguendo:

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

È possibile visualizzare tutti gli hub attività creati in un pianificatore nella sezione Overview della risorsa sul portale di Azure.

Screenshot della scheda Panoramica di Pianificatore di attività durevole nel portale.

Eliminare un pianificatore e un hub delle attività

  1. Eliminare prima l'"hub delle attività":

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

  2. Eliminare il programmatore

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

  1. Aprire la risorsa dell'utilità di pianificazione nel portale di Azure e selezionare Delete:

    Screenshot della risorsa del pianificatore nel portale che evidenzia il pulsante elimina.

  2. Trova il pianificatore con l'hub attività che desideri eliminare, quindi seleziona quell'hub attività. Selezionare Elimina:

    Screenshot dell'hub attività nel portale che evidenzia il pulsante elimina.

Configurare l'autenticazione basata su identità per l'app per accedere a Durable Task Scheduler

Durable Task Scheduler supporta solo l'autenticazione dell'identità gestita tramite identità gestite assegnate dall'utente o assegnate dal sistema. Le identità assegnate dall'utente sono consigliate perché non sono associate al ciclo di vita dell'app e possono essere riutilizzate dopo il deprovisioning dell'app.

Per concedere l'accesso all'app, assegnare all'identità gestita il ruolo Collaboratore per i dati delle attività durevoli. Per la procedura di configurazione completa, vedere Configure identity-based access in Durable Task Scheduler.

Accedere al dashboard dello schedulatore di Durable Task

Per accedere al dashboard dello Scheduler di attività durevoli, assegnare il ruolo Visualizzatore dashboard di attività durevoli all'identità dello sviluppatore. Per informazioni dettagliate, vedere Dashboard del pianificatore di attività durevoli.

Contenuti correlati

  • Last updated on