Présentation des SDK Durable Task

Les kits SDK Durable Task sont portables et open source pour créer des orchestrations, des activités et des entités durables à l’aide de code ordinaire. Ils fonctionnent sur n’importe quelle plateforme de calcul , Azure Container Apps, Kubernetes ou machines virtuelles. Chaque SDK se connecte au Planificateur de tâches durables comme back-end géré.

Utilisez les SDK Durable Task lorsque vous devez :

  • Orchestrez des flux de travail en plusieurs étapes qui survivent aux redémarrages de processus et aux défaillances d’infrastructure.
  • Travailler en parallèle et agréger les résultats de manière fiable.
  • Attendez les événements externes (approbations humaines, webhooks, minuteurs) sans consommer de calcul.
  • S'exécuter sur n'importe quelle plateforme informatique sans être limité à Azure Functions.

Conseil / Astuce

Vous ne savez pas si vous devez utiliser les SDK Durable Task ou les Durable Functions ? Consultez Choisir votre infrastructure d’orchestration. Pour une vue d’ensemble plus large de l’écosystème de tâches durables, consultez Qu’est-ce que la tâche durable ?.

Kits SDK de tâches durables disponibles

Le tableau suivant récapitule les kits SDK Durable Task disponibles, leurs packages et l’emplacement où trouver le code source et les exemples.

Language Paquets État Origine Échantillons
.NET Microsoft.DurableTask.Worker.AzureManaged
Microsoft.DurableTask.Client.AzureManaged
GA durabletask-dotnet Exemples .NET
Python durabletask-azuremanaged GA durabletask-python Exemples Python
Java durabletask-client
durabletask-azure-managed
GA durabletask-java Exemples Java
JavaScript / TypeScript @microsoft/durabletask-js
@microsoft/durabletask-js-azuremanaged
Aperçu durabletask-js exemples JS
Go github.com/microsoft/durabletask-go Bêta durabletask-go exemples Go

Installation

Chaque SDK fournit un worker pour exécuter orchestrations, activités et entités, ainsi qu’un client pour la planification et la gestion des instances. Selon le langage, ces composants sont livrés dans des paquets séparés ou dans un seul paquet ou module. Installez les packages affichés pour votre langue.

dotnet add package Microsoft.DurableTask.Worker.AzureManaged
dotnet add package Microsoft.DurableTask.Client.AzureManaged

Le sdk .NET fonctionne avec n’importe quel modèle d’hébergement .NET : ASP.NET Core, applications console ou services worker. Il prend en charge les définitions d’orchestration et d’activité de type sécurisé avec les générateurs de code source, et s’intègre avec l’injection de dépendances.

Get started

Tous les kits SDK suivent le même modèle :

  1. Installez les paquets SDK ou le module pour votre langage de programmation. Consultez Installation.

  2. Démarrez l’émulateur pour le développement local à l’aide de Docker :

    docker run --name dtsemulator -d -p 8080:8080 -p 8082:8082 mcr.microsoft.com/dts/dts-emulator:latest
    
  3. Définissez des orchestrations et des activités dans votre code d’application.

  4. Démarrer un worker pour traiter les éléments de travail d’orchestration et d’activité

  5. Utilisez le client pour planifier de nouvelles instances d’orchestration et interroger leur état.

Pour obtenir une procédure pas à pas avec du code fonctionnel, consultez Démarrage rapide : Créer une application avec des kits SDK Durable Task.

Comparaison des fonctionnalités

Le tableau suivant présente les fonctionnalités prises en charge par chaque kit SDK.

Fonctionnalité .NET Python Java JavaScript Go (bêta)
Orchestrations ✅ ✅ ✅ ✅ ✅
Activités ✅ ✅ ✅ ✅ ✅
Sous-orchestrations ✅ ✅ ✅ ✅ ✅
Timers durables ✅ ✅ ✅ ✅ ✅
Événements externes ✅ ✅ ✅ ✅ ✅
Entités durables ✅ ✅ ✅ ✅ ✅
Stratégies de nouvelle tentative ✅ ✅ ✅ ✅ ✅
Continuer en tant que nouveau ✅ ✅ ✅ ✅ ✅
Suspendre/reprendre ✅ ✅ ✅ ✅ ✅

Étapes suivantes