Översikt över Durable Functions i den isolerade .NET-arbetaren

Den här artikeln är en översikt över Durable Functions i den isolerade .NET-arbetaren. Med den isolerade arbetaren kan din Durable Functions-app köras på en annan .NET-version än Azure Functions-värd.

Varför ska du använda Durable Functions i den isolerade .NET-arbetaren?

Med den här modellen kan du få alla de stora fördelar som följer med Azure Functions .NET-isolerade arbetsprocess. Mer information finns i Fördelar med den isolerade arbetsmodellen. Dessutom innehåller den här nya SDK:n några nya funktioner.

Funktionsförbättringar av Durable Functions i processstadiet

• Orkestreringsdata kan införas direkt: MyOrchestration([OrchestrationTrigger] TaskOrchestrationContext context, T input)
• Stöd för starkt skrivna anrop och klassbaserade aktiviteter och orkestreringar (OBS! i förhandsversion. Mer information finns här.)
• Plus alla fördelar med Azure Functions .NET-isolerad arbetare.

Generatorer för källkod och klassbaserade aktiviteter samt orkestreringar

Krav: lägg till <PackageReference Include="Microsoft.DurableTask.Generators" Version="1.0.0-preview.1" /> i projektet.

Genom att lägga till källgeneratorpaketet får du åtkomst till två nya funktioner:

• Klassbaserade aktiviteter och orkestreringar, ett alternativt sätt att skriva Durable Functions. I stället för "funktionsbaserad" skriver du vältypade klasser som ärver typer från Durable SDK.
• Strikt typade tilläggsmetoder för att anropa underorkestreringar och aktiviteter. Dessa tilläggsmetoder kan också användas från "funktionsbaserade" aktiviteter och orkestreringar.

Funktionsbaserat exempel

public static class MyFunctions
{
    [Function(nameof(MyActivity))] 
    public static async Task<string> MyActivity([ActivityTrigger] string input)
    {
        // implementation
    }

    [Function(nameof(MyOrchestration))] 
    public static async Task<string> MyOrchestration([OrchestrationTrigger] TaskOrchestrationContext context, string input)
    {
        // implementation
        return await context.CallActivityAsync(nameof(MyActivity), input);
    }
}

Klassbaserat exempel

[DurableTask(nameof(MyActivity))]
public class MyActivity : TaskActivity<string, string>
{
    private readonly ILogger logger;

    public MyActivity(ILogger<MyActivity> logger) // activities have access to DI.
    {
        this.logger = logger;
    }

    public async override Task<string> RunAsync(TaskActivityContext context, string input)
    {
        // implementation
    }
}

[DurableTask(nameof(MyOrchestration))]
public class MyOrchestration : TaskOrchestrator<string, string>
{
    public async override Task<string> RunAsync(TaskOrchestrationContext context, string input)
    {
        ILogger logger = context.CreateReplaySafeLogger<MyOrchestration>(); // orchestrations do NOT have access to DI.

        // An extension method was generated for directly invoking "MyActivity".
        return await context.CallMyActivityAsync(input);
    }
}

Varaktiga entiteter

Varaktiga entiteter stöds i den isolerade .NET-arbetaren. Mer information finns i utvecklarguiden.

Migreringsguide

Den här processen förutsätter att du börjar med ett .NET Durable Functions 2.x-projekt som körs i process med Functions-värd.

Migrera projektet

Det första steget är att migrera .NET-projektet till den isolerade arbetsprocessen.

Referens för uppdateringspaket

När du har migrerat din app för att använda isolate worker-processen måste du uppdatera Ditt Durable Functions NuGet-paket för att referera till det isolerade arbetarspecifika paketet, som i det här exemplet:

Gammal:

<ItemGroup>
  <PackageReference Include="Microsoft.Azure.WebJobs.Extensions.DurableTask" Version="2.9.0" />
</ItemGroup>

Ny:

<ItemGroup>
  <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" Version="1.1.0" />
</ItemGroup>

Uppdatera koden

Durable Functions för .NET-isolerad process är ett helt nytt paket med olika typer och namnrum. Det finns nödvändiga ändringar i koden som ett resultat, men många av API:erna överensstämmer utan ändringar som behövs.

Host.json schema

Schemat för Durable Functions .NET isolerad arbetare och Durable Functions 2.x har förblivit detsamma, inga ändringar ska behövas.

Offentliga API-ändringar

Den här tabellen är inte en fullständig lista över ändringar.

Förändringar i beteende

• Standardbeteendet för serialisering har ändrats från Newtonsoft.Json till System.Text.Json. Mer information finns här.