Durable Task Framework 使用教程

Durable Task Framework 使用教程

durabletaskDurable Task Framework allows users to write long running persistent workflows in C# using the async/await capabilities.项目地址:https://gitcode.com/gh_mirrors/du/durabletask

1. 项目的目录结构及介绍

Durable Task Framework 是一个用于编写持久化、长时间运行的工作流的 C# 框架。以下是其 GitHub 仓库的主要目录结构：

durabletask/
├── docs/
│   └── telemetry/
├── eng/
├── samples/
├── src/
│   ├── DurableTask.AzureStorage/
│   ├── DurableTask.Core/
│   ├── DurableTask.Emulator/
│   ├── DurableTask.ServiceBus/
│   └── DurableTask.SqlServer/
├── test/
│   └── DurableTask.AzureStorage.Tests/
├── tools/
├── .gitattributes
├── .gitignore
├── Directory.Build.targets
├── DurableTask.sln
├── LICENSE
├── README.md
└── SECURITY.md

目录介绍

• docs/: 包含项目文档，如遥测信息。
• eng/: 工程相关文件。
• samples/: 示例代码。
• src/: 源代码，包含多个子项目，如 DurableTask.AzureStorage 和 DurableTask.Core。
• test/: 测试代码。
• tools/: 工具相关文件。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略配置文件。
• Directory.Build.targets: MSBuild 配置文件。
• DurableTask.sln: 解决方案文件。
• LICENSE: 许可证文件。
• README.md: 项目介绍文件。
• SECURITY.md: 安全相关信息。

2. 项目的启动文件介绍

Durable Task Framework 的启动文件通常位于 src/ 目录下的各个子项目中。以 DurableTask.Core 为例，主要的启动文件包括：

• Program.cs: 主程序入口文件。
• Startup.cs: 启动配置文件，用于配置服务和中间件。

示例代码

using DurableTask.Core;

namespace MyDurableTaskApp
{
    class Program
    {
        static void Main(string[] args)
        {
            var orchestrationService = new AzureStorageOrchestrationService();
            var taskHubWorker = new TaskHubWorker(orchestrationService);

            // 添加 orchestration 和 activity
            taskHubWorker.AddTaskOrchestrations(typeof(MyOrchestration));
            taskHubWorker.AddTaskActivities(typeof(MyActivity));

            // 启动任务中心
            taskHubWorker.StartAsync().Wait();

            Console.WriteLine("Durable Task Framework started.");
            Console.ReadLine();

            // 停止任务中心
            taskHubWorker.StopAsync(true).Wait();
        }
    }
}

3. 项目的配置文件介绍

Durable Task Framework 的配置文件通常包括：

• appsettings.json: 应用程序配置文件，包含连接字符串、日志级别等配置。
• DurableTask.AzureStorage.dll.config: 特定于 Azure Storage 的配置文件。

示例配置

{
  "DurableTask": {
    "AzureStorage": {
      "ConnectionString": "YourAzureStorageConnectionString",
      "TaskHubName": "MyTaskHub"
    }
  }
}

配置文件介绍

• ConnectionString: Azure Storage 连接字符串。
• TaskHubName: 任务中心的名称。

通过以上配置，可以确保 Durable Task Framework 正确连接到 Azure Storage 并使用指定的任务中心。

以上是 Durable Task Framework 的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用该框架。

durabletaskDurable Task Framework allows users to write long running persistent workflows in C# using the async/await capabilities.项目地址:https://gitcode.com/gh_mirrors/du/durabletask