快速入门：创建 PowerShell Durable Functions 应用

在本快速入门中，你将使用Visual Studio Code创建和测试 PowerShell Durable Functions 应用，以便协调并链接对其他函数的调用。 然后，将其发布到Azure。

Durable Functions管理应用程序中的状态、检查点和重启，使你可以在无服务器环境中编写有状态工作流。

先决条件

若要完成本快速入门指南，你需要：

• 已安装 Visual Studio Code。

• 已安装 Visual Studio Code 扩展 Azure Functions。

• 已安装 Azure Functions Core Tools 最新版本。

• 一个 HTTP 测试工具，用于保护数据安全。 有关详细信息，请参阅 HTTP 测试工具。

• 一份 Azure 订阅。 若要使用 Durable Functions，必须具有 Azure 存储帐户。

如果没有 Azure 帐户，请在开始前创建一个免费帐户。

创建本地项目

在本部分，你将使用 Visual Studio Code 创建一个本地 Azure Functions 项目。

1. 在Visual Studio Code中，选择 F1（或选择 Ctrl/Cmd+Shift+P）以打开命令面板。 在提示符 (>) 处输入命令，然后选择“Azure Functions: 创建新项目”。

   

2. 选择浏览。 在“选择文件夹”对话框中，转到要用于项目的文件夹，然后选择“选择”。

3. 根据提示提供以下信息：

   提示	Action	说明
   为您的函数应用程序项目选择语言	选择“PowerShell”。	创建本地 PowerShell Functions 项目。
   选择版本	选择 Azure Functions v4。	只有在尚未安装 Core Tools 的情况下，才会出现此选项。 在本例中，当你首次运行应用时，即已安装 Core Tools。
   为项目的第一个函数选择模板	选择“暂时跳过”。
   选择您希望打开项目的方式	选择“在当前窗口中打开”。	在所选的文件夹中打开 Visual Studio Code。

当需要创建项目时，Visual Studio Code 会安装 Azure Functions Core Tools。 它还会在某个文件夹中创建一个函数应用项目。 此项目包含 host.json 和 local.settings.json 配置文件。

此外，还会在根文件夹中创建 package.json 文件。

配置独立的 Durable Functions SDK

独立 SDK 为 PowerShell Durable Functions提供最佳性能和最新功能。 在三个步骤中配置它：

步骤 1： 打开 local.settings.json 并验证是否存在以下设置。 根据需要添加或更新它们：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "powershell",
    "FUNCTIONS_WORKER_RUNTIME_VERSION" : "7.4",
    "ExternalDurablePowerShellSDK": "true"
  }
}

步骤 2： 打开 requirements.psd1 并添加 SDK 依赖项：

@{
    'AzureFunctions.PowerShell.Durable.SDK' = '2.*'
}

2.* 说明符可确保从 PowerShell 库获取最新的稳定 2.x 版本。

步骤 3： 将以下行添加到文件末尾 profile.ps1 ：

Import-Module AzureFunctions.PowerShell.Durable.SDK -ErrorAction Stop

创建自己的函数

基本的 Durable Functions 应用包含三个函数：

对于每个函数，打开命令面板并选择Azure Functions：创建函数，然后提供提示的值：

1. 调度器函数

打开 HelloOrchestrator/run.ps1 以查看编排器。 每次对Invoke-ActivityFunction的调用都会触发Hello的活动函数。

2. 活动函数

打开 Hello/run.ps1 以查看它采用名称作为输入并返回问候语。 活动函数是执行数据库调用或计算等操作的位置。

3. 客户端函数（HTTP 启动程序）

打开 HttpStart/run.ps1 ，验证它使用 Start-NewOrchestration 启动新的编排，并通过 New-OrchestrationCheckStatusResponse 返回包含监视 URL 的 HTTP 响应。

现在，你有一个Durable Functions应用，可以在本地运行并部署到Azure。

在本地测试函数

使用 Azure Functions Core Tools，可以在本地开发计算机上运行 Azure Functions 项目。 当你首次在 Visual Studio 中启动某个函数时，系统会提示你安装这些工具。

1. 若要测试函数，请在 Hello 活动函数代码（在 Hello/run.ps1 中）中设置断点。 选择 F5 或者在命令面板中选择“调试: 开始调试”以启动函数应用项目。 Core Tools 的输出会显示在终端面板中。

   注释

   有关调试的详细信息，请参阅 Durable Functions 诊断。

2. Durable Functions需要存储帐户才能运行。 可以使用 Azurite 存储模拟器进行本地开发，或者在出现提示时创建Azure存储帐户。 如果Visual Studio Code提示选择存储帐户，请选择选择存储帐户。

3. 在提示符下提供以下信息，以在 Azure 中创建新的存储帐户。

   提示	Action	说明
   选择订阅	选择你的订阅名称。	您的 Azure 订阅。
   选择存储帐户	选择“创建新存储帐户”。
   输入新存储帐户的名称	输入唯一名称。	要创建的存储帐户的名称
   选择资源组	输入唯一名称。	要创建的资源组名称。
   选择位置	选择 Azure 区域。	选择离你近的区域。

4. 在终端面板中，复制 HTTP 触发的函数的 URL 终结点。

5. 使用浏览器或 HTTP 测试工具向 URL 终结点发送 HTTP POST 请求。

   将最后一个段替换为协调器函数的名称 (HelloOrchestrator)。 URL 应类似于 http://localhost:7071/api/orchestrators/HelloOrchestrator。

   响应是 HTTP 函数的初始结果。 它让你知道持久业务流程已成功启动。 它尚未显示编排的最终结果。 响应中包括了几个有用的 URL。 现在，查询业务流程的状态。

6. 复制 statusQueryGetUri 的 URL 值，将其粘贴到浏览器的地址栏中，然后执行请求。 还可以继续使用 HTTP 测试工具发出 GET 请求。

   请求将查询业务流程实例的状态。 应会看到一个响应，其中显示了已完成的实例，并显示持久函数的输出：

   {
       "name": "HelloOrchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

7. 若要停止调试，请在 Visual Studio Code 中选择“Shift+F5”。

验证函数在本地计算机上是否正常运行后，即可将项目发布到Azure。

登录到 Azure

必须先登录到 Azure，然后才能创建 Azure 资源或发布应用。

1. 如果你尚未登录，请在活动栏中选择 Azure 图标。 然后在“资源”下，选择“登录到 Azure”。

   

   如果你已登录并可以看到你的现有订阅，请转到下一部分。 如果你没有 Azure 帐户，请选择“创建 Azure 帐户”。 学生可以选择“创建面向学生的 Azure 帐户”。

2. 在浏览器中出现提示时，请选择你的 Azure 帐户，并使用你的 Azure 帐户凭据登录。 如果创建新帐户，可以在创建帐户后登录。

3. 成功登录后，可以关闭新的浏览器窗口。 属于你的 Azure 帐户的订阅显示在边栏中。

在 Azure 中创建函数应用

在本部分中，您将在 Flex Consumption 计划中创建一个函数应用，并在您的 Azure 订阅中创建相关资源。 许多资源创建决策都是根据默认行为为你做出的。 要更好地控制已创建的资源，必须改为使用高级选项创建函数应用。

1. 在Visual Studio Code中，选择 F1 以打开命令面板。 在命令提示符 (>) 中，输入并选择 Azure Functions：在 Azure 中创建函数应用。

2. 根据提示提供以下信息：

   提示	Action
   选择订阅	选择要使用的 Azure 订阅。 如果“资源”下只有一个订阅可见，则不会出现提示符。
   输入新的函数应用名称	在 URL 路径中输入一个全局唯一且有效的名称。 系统将对你输入的名称进行验证，以确保其在 Azure Functions 中是唯一的。
   选择新资源的存放位置	选择 Azure 区域。 为了获得更好的性能，请选择你附近的区域。 仅显示弹性消耗计划支持的区域。
   选择运行时堆栈	选择当前本地运行的语言版本。
   选择资源身份验证类型	选择 托管标识，这是连接到 默认主机存储帐户的最安全选项。

   在“Azure: 活动日志”面板中，Azure 扩展将显示在 Azure 中创建的各个资源的状态。

   

3. 创建函数应用时，系统将在你的 Azure 订阅中创建以下相关资源。 资源基于你为函数应用输入的名称命名。

   • 一个资源组：相关资源的逻辑容器。
   • 一个函数应用：提供用于执行函数代码的环境。 可以通过函数应用将函数分组为逻辑单元，以便在同一托管计划中更轻松地管理、部署和共享资源。
   • 一个 Azure 应用服务计划，用于定义函数应用的底层主机。
   • 一个标准 Azure 存储 帐户，函数主机使用它来维护有关函数应用的状态和其他信息。
   • 一个连接到函数应用的 Application Insights 实例，用于跟踪应用中函数的使用。
   • 用户分配的托管标识，添加到新的默认主机存储帐户中的存储 Blob 数据参与者角色。

   创建函数应用并应用部署包后会显示通知。

   小窍门

   默认情况下，将根据为函数应用输入的名称创建函数应用所需的Azure资源。 默认情况下，使用函数应用在同一个新资源组中创建资源。 如果要自定义关联资源的名称或重复使用现有资源，请使用高级创建选项发布项目。

将项目部署到 Azure

1. 在命令面板中，输入并选择“Azure Functions: Deploy to Function App”。

2. 选择你刚才创建的函数应用。 当系统提示覆盖以前的部署时，请选择“部署”，将函数代码部署到新的函数应用资源。

3. 部署完成后，选择“查看输出”，以查看创建和部署结果，其中包括已创建的 Azure 资源。 如果错过了通知，请选择右下角的铃铛图标再次查看。

   

在 Azure 中测试函数

1. 在Azure门户中（或使用Azure CLI），验证应用设置ExternalDurablePowerShellSDK是否设置为 true。 如果缺少，请在“设置>”下添加它，然后重启函数应用。

2. 从输出面板复制 HTTP 触发器的 URL。 URL 应采用以下格式：

   https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

3. 将 HTTP POST 请求发送到 URL。 您应该获得与本地测试时相同的状态响应。

如果编排未启动，请在 Azure 门户中的 Monitor>Log stream 下检查函数应用日志，以查找与 SDK 导入或存储连接相关的错误。

清理资源

如果你不再需要为完成本快速入门而创建的资源，为避免在 Azure 订阅中产生相关费用，请删除资源组和所有相关资源。

相关内容

• 常见的Durable Functions应用模式
• 独立 PowerShell SDK 指南
• Durable Functions 的诊断和监控
• 适用于 Azure Functions 的 PowerShell 开发人员参考