在容器应用中启用 Dapr

可以根据运行时上下文使用各种参数和注释配置 Dapr。 Azure 容器应用提供了三种可以启用 Dapr 的通道:

下表概述了当前支持的可在 Azure 容器应用中启用 Dapr 的 Dapr 挎斗配置列表:

容器应用 CLI 模板字段 说明
--enable-dapr dapr.enabled 在容器应用上启用 Dapr。
--dapr-app-port dapr.appPort 应用程序正在侦听的端口,Dapr 将使用该端口与应用程序进行通信
--dapr-app-protocol dapr.appProtocol 告知 Dapr 你的应用程序所使用的协议。 有效选项为 httpgrpc。 默认值为 http
--dapr-app-id dapr.appId 容器应用的唯一 Dapr 标识符(用于服务发现、状态封装)和发布/订阅使用者 ID。
--dapr-max-request-size dapr.httpMaxRequestSize 设置请求正文 http 和 grpc 服务器的最大大小,以处理大型文件的上传。 默认值为 4 MB。
--dapr-read-buffer-size dapr.httpReadBufferSize 设置发送多 KB 标头时要处理的 http 标头读取缓冲区的最大大小。 默认值为 4 KB。
--dapr-api-logging dapr.enableApiLogging 支持查看从应用程序到 Dapr sidecar 的 API 调用。
--dapr-log-level dapr.logLevel 设置 Dapr sidecar 的日志级别。 允许的值:debug、error、info、warn。 默认为 info

使用 CLI

可以使用 Azure CLI 在容器应用上启用 Dapr。

az containerapp dapr enable

有关详细信息和示例,请参阅参考文档。

使用 Bicep 或 ARM

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

 dapr: {
   enabled: true
   appId: 'nodeapp'
   appProtocol: 'http'
   appPort: 3000
 }

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

使用 Azure 门户

还可以通过容器应用的门户视图启用 Dapr。

注意

在开始之前,请确保你已经创建了自己的 Dapr 组件。 可以通过门户中的容器应用环境连接 Dapr 组件。

导航到 Azure 门户中的容器应用,然后选择左侧菜单中“设置”下的“Dapr”

Screenshot showing where to enable Dapr in your container app via the Azure portal view.

默认情况下,Dapr 处于禁用状态。 选择“启用”以展开 Dapr 设置。

Screenshot of Dapr being disabled by default and where to click to enable it.

输入组件应用 ID 并选择适当的标题。 在“组件”标题下选择链接以将 Dapr 组件添加到容器应用环境并对其进行管理(如果适用)。

Screenshot showing some basic settings for enabling Dapr on the container app.

后续步骤

尝试按照以下教程之一的说明使用 Dapr 和 Azure 容器应用: