你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 Azure Functions 的 Dapr 扩展

项目
02/06/2024

重要

适用于 Azure Functions 的 Dapr 扩展目前为预览版，仅在 Azure 容器应用环境中受支持。

适用于 Azure Functions 的 Dapr 扩展是一组工具和服务，使开发人员能够轻松地将 Azure Functions 与分散式应用程序运行时（Dapr）平台集成。

Azure Functions 是事件驱动的计算服务，它提供一组触发器和绑定，可轻松与其他 Azure 服务连接。 Dapr 提供了一组构建基块和最佳做法，用于生成分布式应用程序，包括微服务、状态管理、发布/订阅消息传送等。

借助 Dapr 和 Functions 之间的集成，可以生成对 Dapr 或外部系统的事件做出响应的函数。

操作	方向	类型
在 Dapr 输入绑定上触发	不可用	daprBindingTrigger
在 Dapr 服务调用上触发	不可用	daprServiceInvocationTrigger
在 Dapr 主题订阅上触发	不可用	daprTopicTrigger
拉取执行的 Dapr 状态	位于	daprState
拉取执行的 Dapr 机密	位于	daprSecret
将值保存到 Dapr 状态	出	daprState
调用另一个 Dapr 应用	出	daprInvoke
将消息发布到 Dapr 主题	出	daprPublish
将值发送到 Dapr 输出绑定	出	daprBinding

安装扩展

你安装的扩展 NuGet 包取决于你在函数应用中使用的 C# 模式进程内或独立工作进程：

进程内
隔离进程

通过安装 NuGet 包版本 0.17.0-preview01 可获得此扩展。

使用 .NET CLI：

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr --prerelease

通过安装 NuGet 包版本 0.17.0-preview01 将扩展添加到项目。

使用 .NET CLI：

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr --prerelease

安装捆绑包

预览版捆绑包 v4.x

可以通过在 host.json 文件中添加或替换以下代码，添加预览版扩展：

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Dapr 启用

可以根据运行时上下文使用各种[自变量和注释][dapr-args] 配置 Dapr。可以通过两个通道为 Azure Functions 配置 Dapr：

基础结构即代码 (IaC) 模板，如 Bicep 或 Azure 资源管理器 (ARM) 模板
Azure 门户

使用 IaC 模板时，请在容器应用资源定义的 properties 部分中指定以下参数。

Bicep
ARM

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

上述 Dapr 配置值被视为应用程序范围的更改。在多修订版模式下运行容器应用时，更改这些设置不会创建新的修订版，而是会重启所有现有修订版，以确保为它们配置了最新的值。

使用 Azure 门户配置 Dapr 时，导航到函数应用并从左侧菜单中选择“Dapr”：

Screenshot demonstrating where to find Dapr enablement for a Function App in the Azure portal.

Dapr 端口和侦听器

从 Dapr 触发函数时，扩展会自动公开端口 3001 以侦听来自 Dapr sidecar 的传入请求。

重要

仅当在函数应用中定义了 Dapr 触发器时，才会公开和侦听端口 3001。使用 Dapr 时，sidecar 会在完成实例化之前等待从定义的端口接收响应。除非有触发器，否则请不要定义dapr.io/port注释或 --app-port。这样做可能会从 Dapr sidecar 锁定应用程序。

如果仅使用输入和输出绑定，则无需公开或定义端口 3001。

默认情况下，当 Azure Functions 尝试与 Dapr 通信时，它会通过从环境变量 DAPR_HTTP_PORT 解析的端口来调用 Dapr。如果该变量为 null，则默认为端口 3500。

可以通过在绑定（或属性）的 function.json 中设置 DaprAddress 属性来替代输入和输出绑定使用的 Dapr 地址。默认情况下，它使用 http://localhost:{DAPR_HTTP_PORT}。

函数应用仍然为 HTTP 触发器等内容公开另一个端口和终结点，在本地默认为 7071，但在容器中默认为 80。

绑定类型

.NET 支持的绑定类型取决于扩展版本和 C# 执行模式，可以是以下类型之一：

进程内类库
隔离进程

进程内类库是编译的 C# 函数，该函数在与 Functions 运行时相同的进程中运行。

Dapr 扩展支持的参数类型如下表所示。

绑定	参数类型
Dapr 触发器	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Dapr 输入	daprState daprSecret
Dapr 输出	daprState daprInvoke daprPublish daprBinding

有关使用这些类型的示例，请参阅扩展的 GitHub 存储库。