Desarrollo con el Programador de tareas duraderas (versión preliminar)

2025-05-12

Durable Task Scheduler es un proveedor de back-end muy eficaz y totalmente administrado para Durable Functions con un panel de supervisión predefinido. Azure ofrece dos marcos de orquestación orientados a desarrolladores que funcionan con Durable Functions para compilar aplicaciones: SDK de Durable Task y Durable Functions.

En este artículo, aprenderá a:

Ejecutar el emulador del programador de tareas duraderas
Realice operaciones CRUD en un programador y una central de tareas.

Obtenga más información sobre las características de Durable Task Scheduler, las regiones admitidas y los planes.

Emulador del programador de tareas duraderas

El emulador del programador de tareas duraderas solo está disponible como imagen de Docker en la actualidad.

Extraiga la imagen de Docker que contiene el emulador.

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

Ejecutar el emulador.
```
docker run -itP mcr.microsoft.com/dts/dts-emulator:latest
```
Este comando expone una única central de tareas denominada default. Si necesita más de una central de tareas, establezca la variable de entorno DTS_TASK_HUB_NAMES en el contenedor en una lista delimitada por comas de nombres de la central de tareas como en el siguiente comando:
```
docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:latest
```

Prerrequisitos

La última versión de la CLI de Azure.

Configuración de la CLI

Inicie sesión en la CLI de Azure y asegúrese de que tenga instalada la última versión.
```
az login
az upgrade
```
Instale la extensión Durable Task Scheduler CLI.
```
az extension add --name durabletask
```
Si ya ha instalado la extensión de la CLI de Durable Task Scheduler, actualice a la versión más reciente.
```
az extension add --upgrade --name durabletask
```

Cree un programador y una central de tareas

Cree un grupo de recursos.

az group create --name YOUR_RESOURCE_GROUP --___location LOCATION

Con la extensión de la CLI de durabletask, cree un programador.

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"

Es posible que el proceso de creación tarde hasta 15 minutos en completarse.

Salida

{
    "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": {}
}

Creación de una central de tareas.

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

Salida

{
  "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"
}

En Azure Portal, busque Programador de tareas duraderas y selecciónelo en los resultados.
Haga clic en Crear para abrir el panel Azure Functions: programador de tareas duraderas (versión preliminar).
Rellene los campos de la pestaña Datos básicos. Haga clic en Revisar + crear. Cuando supere la validación, haga clic en Crear.

La implementación podría tardar entre 15 y 20 minutos.

Visualización de todos los recursos del Programador de tareas durables en una suscripción

Para obtener una lista de todos los nombres de programador de una suscripción, ejecute el comando siguiente.
```
az durabletask scheduler list --subscription <SUBSCRIPTION_ID>
```

Restrinja los resultados a un grupo de recursos específico agregando la marca --resource-group.

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

En Azure Portal, busque Programador de tareas duraderas y selecciónelo en los resultados.

Verá la lista de recursos del programador creados en todas las suscripciones a las que tenga acceso.

Visualización de todos los centros de tareas en un programador de tareas durable

Recupere una lista de las centrales de tareas en un programador específico con la ejecución de:

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

Verá todas las centrales de tareas creadas en un programador en la Información general del recurso en Azure Portal.

Captura de pantalla de la pestaña información general del Programador de tareas durables en el portal.

Eliminar el programador y la central de tareas

Eliminación del programador:

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

Eliminación de una central de tareas:

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

Abra el recurso del programador en Azure Portal y haga clic en Eliminar:
Busque el programador con la central de tareas que quiera eliminar y haga clic en esa central de tareas. Haga clic en Eliminar:

Configurar la autenticación basada en identidad para que la aplicación acceda a Durable Task Scheduler

Durable Task Scheduler solo admite la autenticación de identidad administrada asignada por el usuario o asignada por el sistema . Se recomiendan identidades asignadas por el usuario, ya que no están vinculadas al ciclo de vida de la aplicación y se pueden reutilizar después de desaprovisionar la aplicación.

Obtenga más información sobre el acceso basado en identidades en Durable Task Scheduler.

Acceso al panel de control del planificador de Durable Task

Asigne el rol requerido a su identidad de desarrollador (correo electrónico) para obtener acceso al tablero del programador de tareas duraderas.

Pasos siguientes

Para usar el programador de tareas duraderas con Durable Functions:

Inicio rápido: Configuración de una aplicación de Durable Functions para usar El programador de tareas durables de Azure Functions

Para usar Durable Task Scheduler con los SDK de Durable Task: