Gambaran umum SDK Tugas Tahan Lama

SDK Tugas Tahan Lama adalah pustaka sumber terbuka portabel untuk membangun orkestrasi, aktivitas, dan entitas yang tahan lama menggunakan kode biasa. Mereka bekerja pada platform komputasi apa pun—Azure Container Apps, Kubernetes, atau VM. Setiap SDK terhubung ke Durable Task Scheduler sebagai backend terkelolanya.

Gunakan SDK Tugas Tahan Lama saat Anda perlu:

• Mengatur alur kerja multi-langkah yang bertahan dari proses mulai ulang dan kegagalan infrastruktur.
• Menyebarkan pekerjaan secara paralel dan mengumpulkan hasil secara andal.
• Tunggu peristiwa eksternal (persetujuan manusia, webhook, timer) tanpa mengkonsumsi komputasi.
• Run pada platform komputasi apa pun tanpa terkunci dalam Azure Functions.

Petunjuk / Saran

Tidak yakin apakah akan menggunakan SDK Tugas Tahan Lama atau Durable Functions? Lihat Memilih kerangka kerja orkestrasi Anda. Untuk gambaran umum yang lebih luas tentang ekosistem Tugas Tahan Lama, lihat Apa itu Durable Task?.

SDK Tugas Tahan Lama yang Tersedia

Tabel berikut ini meringkas SDK Tugas Tahan Lama yang tersedia, paketnya, dan tempat menemukan kode sumber dan sampel.

Bahasa	Paket	Kedudukan	Sumber	Samples
.NET	Microsoft.DurableTask.Worker.AzureManaged Microsoft.DurableTask.Client.AzureManaged	GA	durabletask-dotnet	.NET sampel
Python	durabletask-azuremanaged	GA	durabletask-python	Sampel Python
Java	durabletask-client durabletask-azure-managed	GA	durabletask-java	Sampel Java
JavaScript / TypeScript	@microsoft/durabletask-js @microsoft/durabletask-js-azuremanaged	Preview	durabletask-js	Sampel JS

Penginstalan

Setiap SDK mengirimkan dua paket:

• Paket pekerja untuk menentukan orkestrasi dan aktivitas
• Paket klien untuk menjadwalkan dan mengelola instans orkestrasi.

Instal kedua paket untuk memulai.

C#

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

SDK .NET berfungsi dengan model hosting .NET apa pun: ASP.NET Core, aplikasi konsol, atau layanan pekerja. Ini mendukung orkestrasi yang aman tipe dan definisi aktivitas dengan generator kode sumber, serta berintegrasi dengan injeksi dependensi.

Python

pip install durabletask-azuremanaged

SDK Python berfungsi dengan hosting Python 3.9+. Ini mendukung orkestrasi berbasis generator dengan aktivitas asinkron.

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 berfungsi dengan hosting Java 8+, termasuk aplikasi Spring Boot.

JavaScript

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

JavaScript atau TypeScript SDK memerlukan Node.js 22 atau lebih tinggi. Ini mendukung orkestrasi berbasis generator dan entitas tahan lama.

Nota

JavaScript atau TypeScript SDK saat ini berada dalam tahap pratinjau. Ini tidak kompatibel dengan Azure Durable Functions JavaScript SDK (durable-functions).

Get started

Semua SDK mengikuti pola yang sama:

1. Instal paket pekerja dan klien untuk bahasa Anda. Lihat Penginstalan.

2. Mulai emulator untuk pengembangan lokal menggunakan Docker:

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

3. Tentukan orkestrasi dan aktivitas dalam kode aplikasi Anda.

4. Mulai sebuah pekerja untuk memproses item kerja orkestrasi dan aktivitas.

5. Gunakan klien untuk menjadwalkan instans orkestrasi baru dan mengkueri statusnya.

Untuk panduan dengan kode kerja, lihat Mulai Cepat: Membuat aplikasi dengan SDK Tugas Tahan Lama.

Perbandingan fitur

Tabel berikut ini memperlihatkan fitur yang didukung setiap SDK.

Feature	.NET	Python	Java	JavaScript
Orkestrasi	✅	✅	✅	✅
Aktivitas	✅	✅	✅	✅
Sub-orkestrasi	✅	✅	✅	✅
Timer tahan lama	✅	✅	✅	✅
Peristiwa eksternal	✅	✅	✅	✅
Entitas tahan lama	✅	✅	✅	✅
Kebijakan Pengulangan	✅	✅	✅	✅
Lanjutkan sebagai baru	✅	✅	✅	✅
Tangguhkan/Lanjutkan	✅	✅	✅	✅

Langkah berikutnya

Mulai Cepat: Membuat aplikasi dengan Durable Task SDK

• Gambaran umum Durable Task Scheduler
• Pilih kerangka kerja orkestrasi Anda
• Apa itu Durable Task?