Общие сведения о пакетах SDK для устойчивых задач

Портативные SDK для устойчивых задач - это библиотеки с открытым исходным кодом для создания устойчивых оркестраций, операций и сущностей с использованием стандартного кода. Они работают на любой вычислительной платформе — Контейнеры приложений Azure, Kubernetes или виртуальных машинах. Каждый SDK подключается к Durable Task Scheduler в качестве своей управляемой серверной части.

При необходимости используйте пакеты SDK для устойчивых задач:

• Оркеструйте многошаговые рабочие процессы, которые устойчивы к перезапускам процессов и сбоям инфраструктуры.
• Распределяйте работу параллельно и надежно агрегируйте результаты.
• Подождите внешние события (утверждения человека, веб-перехватчики, таймеры) без использования вычислительных ресурсов.
• Запускать на любой вычислительной платформе без привязки к Функции Azure.

Подсказка

Не знаете, следует ли использовать пакеты SDK для устойчивых задач или Устойчивые функции? См. раздел "Выбор платформы оркестрации". Более широкий обзор экосистемы устойчивых задач см. в разделе "Что такое устойчивая задача?".

Доступные пакеты SDK для устойчивых задач

В следующей таблице приведены сведения о доступных пакетах SDK для устойчивых задач, их пакетах и местах поиска исходного кода и примеров.

Язык	Пакеты	Статус	Исходный материал	Образцы
.NET	Microsoft.DurableTask.Worker.AzureManaged Microsoft.DurableTask.Client.AzureManaged	GA	durabletask-dotnet	.NET примеры
Python	durabletask-azuremanaged	GA	durabletask-python	Примеры Python
Java	durabletask-client durabletask-azure-managed	GA	durabletask-java	Примеры для Java
JavaScript / TypeScript	@microsoft/durabletask-js @microsoft/durabletask-js-azuremanaged	Preview	durabletask-js	примеры JS

Installation

Каждый пакет SDK поставляется двумя пакетами:

• Воркер пакет для определения координации действий и активностей
• Клиентский пакет для планирования экземпляров оркестрации и управления ими.

Установите оба пакета, чтобы приступить к работе.

C#

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

Пакет SDK .NET работает с любой моделью размещения .NET: ASP.NET Core, консольными приложениями или рабочими службами. Он поддерживает типобезопасную оркестрацию и определения активности с генераторами исходного кода, а также интегрируется с внедрением зависимостей.

Python

pip install durabletask-azuremanaged

Пакет SDK Python работает с любым хостингом Python версии 3.9 и выше. Он поддерживает оркестрации на основе генератора с асинхронными действиями.

Java

<dependency>
    <groupId>com.microsoft</groupId>
    <artifactId>durabletask-client</artifactId>
    <version>1.9.0</version>
</dependency>
<dependency>
    <groupId>com.microsoft</groupId>
    <artifactId>durabletask-azure-managed</artifactId>
    <version>1.9.0</version>
</dependency>

Пакет SDK Java работает с любым размещением Java 8 и более поздних версий, включая приложения Spring Boot.

JavaScript

npm install @microsoft/durabletask-js @microsoft/durabletask-js-azuremanaged

Пакет SDK javaScript или TypeScript требует Node.js 22 или более поздней версии. Он поддерживает оркестрацию на основе генератора и устойчивые сущности.

Замечание

Пакет SDK JavaScript или TypeScript в настоящее время находится в предварительной версии. Он не совместим с пакетом SDK javaScript Azure Устойчивые функции (durable-functions).

Начало работы

Все пакеты SDK соответствуют одному и тому же шаблону:

1. Установите рабочие и клиентские пакеты для вашего языка. См . раздел "Установка".

2. Запустите эмулятор для локальной разработки с помощью Docker:

   docker run --name dtsemulator -d -p 8080:8080 -p 8082:8082 mcr.microsoft.com/dts/dts-emulator:latest
   

3. Определите оркестрации и активности в коде приложения.

4. Запустите работчика для обработки рабочих элементов оркестрации и действий.

5. Используйте клиент для планирования новых экземпляров оркестрации и запроса их состояния.

Пошаговое руководство по рабочему коду см. в кратком руководстве по созданию приложения с пакетами SDK для устойчивых задач.

Сравнение функций

В следующей таблице показаны функции, поддерживаемые каждым пакетом SDK.

Функция	.NET	Python	Java	JavaScript
Оркестровки	✅	✅	✅	✅
Действия	✅	✅	✅	✅
Вложенные оркестрации	✅	✅	✅	✅
Устойчивые таймеры	✅	✅	✅	✅
Внешние события	✅	✅	✅	✅
Устойчивые сущности	✅	✅	✅	✅
Политики повторных попыток	✅	✅	✅	✅
Начать заново	✅	✅	✅	✅
Приостановка и возобновление	✅	✅	✅	✅

Дальнейшие действия

Краткое руководство. Создание приложения с помощью пакетов SDK для устойчивых задач

• Общие сведения о планировщике устойчивых задач
• Выбор платформы оркестрации
• Что такое устойчивая задача?