https://github.com/jviau/durabletask-hosting
A Microsoft.Extensions.Hosting wrapper around the Microsoft.Azure.DurableTask framework.
https://github.com/jviau/durabletask-hosting
azure dependency-injection durabletask hosting orchestrations
Last synced: 3 months ago
JSON representation
A Microsoft.Extensions.Hosting wrapper around the Microsoft.Azure.DurableTask framework.
- Host: GitHub
- URL: https://github.com/jviau/durabletask-hosting
- Owner: jviau
- License: apache-2.0
- Created: 2020-04-13T18:27:47.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2025-03-10T17:07:45.000Z (4 months ago)
- Last Synced: 2025-04-13T13:03:50.974Z (3 months ago)
- Topics: azure, dependency-injection, durabletask, hosting, orchestrations
- Language: C#
- Homepage:
- Size: 683 KB
- Stars: 30
- Watchers: 5
- Forks: 8
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DurableTask-Hosting
[](https://github.com/jviau/durabletask-hosting/actions?query=workflow%3A%22.NET+Core%22)
Hosting:
[](https://www.nuget.org/packages/Vio.DurableTask.Hosting)
Dependency Injection:
[](https://www.nuget.org/packages/Vio.DurableTask.DependencyInjection)
A [Microsoft.Extensions.Hosting](https://www.nuget.org/packages/Microsoft.Extensions.Hosting/) wrapper around the [azure/durabletask](https://github.com/azure/durabletask) framework.
## Getting Started
See [Samples](./samples/DurableTask.Samples) for a quick start example.
1. Add nuget package: `dotnet add package Vio.DurableTask.Hosting`
2. Add to your host builder:
``` CSharp
await Host.CreateDefaultBuilder()
.ConfigureServices(services =>
{
// Can configure orchestrations, activities, and middleware in the service
// container with any scope desired.
services.AddSingleton();
services.AddScoped(); // must implement "ITaskMiddleware"
})
.ConfigureTaskHubWorker((context, builder) =>
{
// add orchestration service
builder.WithOrchestrationService(new LocalOrchestrationService());
// add orchestration directly _not_ in service container. Will be treated as transient.
builder.AddOrchestration();
// will be fetched from service provider.
builder.AddOrchestration();
// will be fetched from service provider.
builder.UseOrchestrationMiddleware();
// same as orchestration: can be part of the services or not.
builder.AddActivity();
})
.RunConsoleAsync(); // starts the worker.
```
All orchestrations, activities, and middleware will now be constructed via dependency injection.
## Service Scope
A new `IServiceScope` is created for the duration of every `OrchestrationInstance` run. This scope will be used for all actions, middleware, and the orchestration itself and disposed after both the middleware & orchestration pipeline has finished execution. Scopes are not preserved between runs of the same `OrchestrationInstance`.