Översikt över SDK:er för varaktiga uppgifter

Durable Task SDK:er är portabla bibliotek med öppen källkod för att skapa varaktiga orkestreringar, aktiviteter och entiteter med vanlig kod. De fungerar på valfri beräkningsplattform – Azure Container Apps, Kubernetes eller virtuella datorer. Varje SDK ansluter till Durable Task Scheduler som dess hanterade serverdel.

Använd SDK:erna för varaktiga uppgifter när du behöver:

  • Samordna arbetsflöden i flera steg som klarar omstarter av processer och infrastrukturfel.
  • Arbeta parallellt och aggregera resultaten på ett tillförlitligt sätt.
  • Vänta på externa händelser (mänskliga godkännanden, webhooks, timers) utan att förbruka beräkning.
  • Kör på en beräkningsplattform utan att vara låst till Azure Functions.

Tips/Råd

Är du osäker på om du vill använda SDK:er för varaktiga uppgifter eller Durable Functions? Se Välj ditt orkestreringsramverk. En bredare översikt över durable task-ekosystemet finns i Vad är durable task?.

Tillgängliga SDK:er för varaktiga aktiviteter

I följande tabell sammanfattas tillgängliga Durable Task SDK:er, deras paket och var du hittar källkod och exempel.

Språk Paket Status Källa Exempel
.NET Microsoft.DurableTask.Worker.AzureManaged
Microsoft.DurableTask.Client.AzureManaged
GA durabletask-dotnet .NET exempel
Python durabletask-azuremanaged GA durabletask-python Python-exempel
Java durabletask-client
durabletask-azure-managed
GA durabletask-java Java-exempel
JavaScript/TypeScript @microsoft/durabletask-js
@microsoft/durabletask-js-azuremanaged
Preview durabletask-js JS-exempel

Installation

Varje SDK levereras med två paket:

  • Ett arbetspaket för att definiera orkestreringar och aktiviteter
  • Ett klientpaket för schemaläggning och hantering av orkestreringsinstanser.

Installera båda paketen för att komma igång.

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

.NET SDK fungerar med alla .NET värdmodeller: ASP.NET Core, konsolappar eller arbetstjänster. Den stöder typsäkra orkestrerings- och aktivitetsdefinitioner med källgeneratorer och integreras med beroendeinmatning.

Get started

Alla SDK:er följer samma mönster:

  1. Installera arbets- och klientpaketen för ditt språk. Se Installation.

  2. Starta emulatorn för lokal utveckling med Docker:

    docker run --name dtsemulator -d -p 8080:8080 -p 8082:8082 mcr.microsoft.com/dts/dts-emulator:latest
    
  3. Definiera orkestreringar och aktiviteter i programkoden.

  4. Starta en arbetare för att bearbeta orkestrerings- och aktivitetsarbetsobjekt.

  5. Använd klienten för att schemalägga nya orkestreringsinstanser och fråga efter deras status.

En genomgång med arbetskod finns i Snabbstart: Skapa en app med Durable Task SDK:er.

Jämförelse av funktioner

I följande tabell visas de funktioner som varje SDK stöder.

Feature .NET Python Java JavaScript
Orkestreringar ✅ ✅ ✅ ✅
Aktiviteter ✅ ✅ ✅ ✅
Suborkestreringar ✅ ✅ ✅ ✅
Hållbara timers ✅ ✅ ✅ ✅
Externa händelser ✅ ✅ ✅ ✅
Varaktiga entiteter ✅ ✅ ✅ ✅
Principer för nya försök ✅ ✅ ✅ ✅
Fortsätt som ny ✅ ✅ ✅ ✅
Pausa/återuppta ✅ ✅ ✅ ✅

Nästa steg