Desarrollo con el Programador de Tareas Persistentes

El programador de tareas duraderas es un proveedor de back-end muy eficaz y totalmente administrado para Durable Task con un panel de supervisión listo para usar. Azure ofrece dos marcos de orquestación orientados a desarrolladores que funcionan con Durable Task Scheduler 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.

  1. Extraiga la imagen de Docker que contiene el emulador.

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

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

Configuración de la CLI

  1. Inicie sesión en Azure y asegúrese de que tiene la versión más reciente de la CLI.

    az login
az upgrade

  2. Instale la extensión Durable Task Scheduler CLI.

    az extension add --name durabletask

  3. Si ya ha instalado la extensión de la CLI de Durable Task Scheduler, actualice a la versión más reciente.

    az extension update --name durabletask

  4. Compruebe la versión instalada:

    az extension show --name durabletask

Más información sobre los comandos de az durabletask.

Cree un programador y una central de tareas

  1. Cree un grupo de recursos.

    az group create --name YOUR_RESOURCE_GROUP --location LOCATION

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

  3. 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"
}

  1. En el portal de Azure, busque Programador de Tareas Durable y selecciónelo en los resultados.

    Captura de pantalla de la búsqueda del Durable Task Scheduler en el portal.

  2. Seleccione Crear para abrir el panel Programador de tareas duraderas .

    Captura de pantalla de la página de creación del Programador de tareas durables.

  3. Rellene los campos de la pestaña Aspectos básicos . Seleccione Revisar y crear.

  4. Una vez superada la validación, seleccione 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

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

  2. 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 el portal de Azure, busque Programador de Tareas Durable y selecciónelo en los resultados.

Captura de pantalla de la búsqueda del servicio Durable Task Scheduler en el portal.

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>

Puede ver todos los centros de tareas creados en un programador de tareas en la Información general del recurso en el portal de Azure.

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

Eliminación de un programador y un centro de tareas

  1. Elimine primero el centro de tareas:

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

  2. Eliminación del programador:

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

  1. Abra el recurso scheduler en el portal de Azure y seleccione Delete:

    Recorte de pantalla del recurso del programador en el portal con el botón Eliminar resaltado.

  2. Busque el programador con el centro de tareas que desea eliminar y, a continuación, seleccione ese centro de tareas. Seleccione Eliminar:

    Recorte de pantalla del recurso de la central de tareas en el portal con el botón Eliminar resaltado.

Configuración de la autenticación basada en identidades para que la aplicación acceda a Durable Task Scheduler

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

Para conceder acceso a la aplicación, asigne el rol Colaborador de datos de Durable Task a la identidad administrada. Para ver los pasos completos de configuración, consulte Configuración del acceso basado en identidades en Durable Task Scheduler.

Acceso al panel de control del planificador de Durable Task

Para acceder al panel de control del programador de tareas duraderas, asigne el rol Durable Task Dashboard Viewer a la identidad del desarrollador. Para obtener más información, consulte el panel del Programador de tareas durables.

Contenido relacionado

  • Last updated on