Développer avec le planificateur de tâches durables (préversion)

2025-05-12

Durable Task Scheduler est un fournisseur back-end hautement performant et entièrement géré pour Durable Functions avec un tableau de bord de supervision prête à l’emploi. Azure propose deux frameworks d’orchestration orientés développeur qui fonctionnent avec Durable Functions pour créer des applications : sdk Durable Task et Durable Functions.

Dans cet article, vous allez apprendre à :

Exécuter l’émulateur Planificateur de tâches durables
Effectuez des opérations CRUD sur un planificateur et un hub de tâches.

En savoir plus sur les fonctionnalités durables du planificateur de tâches, les régions prises en charge et les plans.

Émulateur de Planificateur de Tâches Durable

L’émulateur Durable Task Scheduler est disponible uniquement en tant qu’image Docker aujourd’hui.

Extrayez l’image Docker contenant l’émulateur.

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

Exécutez l’émulateur.
```
docker run -itP mcr.microsoft.com/dts/dts-emulator:latest
```
Cette commande expose un hub de tâches unique nommé default. Si vous avez besoin de plusieurs hubs de tâches, vous pouvez définir la variable DTS_TASK_HUB_NAMES d’environnement sur le conteneur sur une liste délimitée par des virgules de noms de hub de tâches comme dans la commande suivante :
```
docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:latest
```

Conditions préalables

Dernière version d’Azure CLI.

Configurer l’interface CLI

Connectez-vous à Azure CLI et vérifiez que vous disposez de la dernière version installée.
```
az login
az upgrade
```
Installez l’extension CLI Durable Task Scheduler.
```
az extension add --name durabletask
```
Si vous avez déjà installé l’extension CLI Durable Task Scheduler, effectuez une mise à niveau vers la dernière version.
```
az extension add --upgrade --name durabletask
```

Créer un planificateur et un hub de tâches

Créez un groupe de ressources.

az group create --name YOUR_RESOURCE_GROUP --location LOCATION

À l’aide de l’extension durabletask CLI, créez un planificateur.

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"

Le processus de création peut prendre jusqu’à 15 minutes.

Sortie

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

Créez un hub de tâches.

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

Sortie

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

Dans le portail Azure, recherchez Durable Task Scheduler et sélectionnez-le dans les résultats.
Cliquez sur Créer pour ouvrir le volet Planificateur de tâches durables (préversion) Azure Functions .
Renseignez les champs sous l’onglet Informations de base . Cliquez sur Vérifier + créer. Une fois la validation réussie, cliquez sur Créer.

Le déploiement peut prendre environ 15 à 20 minutes.

Afficher toutes les ressources durables du planificateur de tâches dans un abonnement

Obtenez la liste de tous les noms du planificateur au sein d’un abonnement en exécutant la commande suivante.
```
az durabletask scheduler list --subscription <SUBSCRIPTION_ID>
```
Vous pouvez limiter les résultats à un groupe de ressources spécifique en ajoutant l’indicateur --resource-group .
```
az durabletask scheduler list --subscription <SUBSCRIPTION_ID> --resource-group <RESOURCE_GROUP_NAME>
```

Dans le portail Azure, recherchez Durable Task Scheduler et sélectionnez-le dans les résultats.

Vous pouvez voir la liste des ressources du planificateur créées dans tous les abonnements auxquels vous avez accès.

Afficher tous les hubs de tâches dans un planificateur de tâches durable

Récupérez une liste de hubs de tâches dans un planificateur spécifique en exécutant :

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

Vous pouvez voir tous les hubs de tâches créés dans un planificateur dans la vue d’ensemble de la ressource sur le portail Azure.

Capture d’écran de l’onglet Vue d’ensemble du Planificateur de tâches durables dans le portail.

Supprimer le planificateur et le hub de tâches

Supprimez le planificateur :

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

Supprimez un hub de tâches :

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

Ouvrez la ressource du planificateur sur le portail Azure, puis cliquez sur Supprimer :
Recherchez le planificateur avec le hub de tâches que vous souhaitez supprimer, puis cliquez sur ce hub de tâches. Cliquez sur Supprimer :

Configurer l’authentification basée sur l’identité pour que l’application accède à Durable Task Scheduler

Le planificateur de tâches durables prend uniquement en charge l’authentification basée sur l’identité managée affectée par l’utilisateur ou affectée par le système. Les identités affectées par l’utilisateur sont recommandées, car elles ne sont pas liées au cycle de vie de l’application et peuvent être réutilisées une fois l’application déprovisionnée.

En savoir plus sur l’accès basé sur l’identité dans Durable Task Scheduler.

Accéder au tableau de bord du planificateur de tâches durables

Attribuez le rôle requis à votre identité de développeur (e-mail) pour accéder au tableau de bord du Planificateur de tâches durables.

Étapes suivantes

Pour utiliser durable Task Scheduler avec Durable Functions :

Démarrage rapide : Configurer une application Durable Functions pour utiliser azure Functions Durable Task Scheduler

Pour utiliser le planificateur de tâches durables avec les kits SDK de tâche durables :