在现有容器应用中配置 Dapr

Artículo
23/05/2025

可以根据运行时上下文使用各种参数和注释配置 Dapr。 Azure 容器应用中提供的 Dapr 配置被视为 应用程序范围 更改。在多修订模式下运行容器应用时，更改这些设置并不会创建新的修订。而是会重启所有现有修订版，以确保为它们配置了最新的值。

Azure 容器应用提供了三个通道，可通过该通道启用和配置 Dapr：

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

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

容器应用 CLI	模板字段	说明
`--enable-dapr`	`dapr.enabled`	在容器应用上启用 Dapr。
`--dapr-app-port`	`dapr.appPort`	应用程序正在侦听的端口，Dapr 将使用该端口与应用程序进行通信
`--dapr-app-protocol`	`dapr.appProtocol`	告知 Dapr 你的应用程序所使用的协议。有效选项为 `http` 或 `grpc`。默认设置为 `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`.
`--dapr-app-health-enabled`	`dapr.appHealth.enabled`	可选配置，用于使用布尔格式为容器应用启用应用运行状况检查。默认设置为 `false`.
`--dapr-app-health-path`	`dapr.appHealth.path`	在应用通道为 HTTP 时，设置 Dapr 为运行状况探测调用的路径。如果应用通道使用 gRPC，则忽略此值。默认设置为 `/healthz`.
`--dapr-app-health-probe-interval`	`dapr.appHealth.probeIntervalSeconds`	每次运行状况探测之间间隔的秒数。默认设置为 `3`.
`--dapr-app-health-probe-timeout`	`dapr.appHealth.probeTimeoutMilliseconds`	运行状况探测请求的超时（毫秒）。此值必须小于 `probeIntervalSeconds` 该值。默认设置为 `500`.
`--dapr-app-health-threshold`	`dapr.appHealth.threshold`	在应用被视为运行不正常之前的最大连续失败次数。默认设置为 `3`.
`--dapr-max-concurrency`	`dapr.maxConcurrency`	限制应用程序的并发。有效值为大于 `0`的任意数字。 `-1` 表示对并发没有限制。

使用 CLI

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

az containerapp dapr enable

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

使用 Bicep 或 ARM

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

肱二头肌
ARM

 dapr: {
   enabled: true
   appId: 'nodeapp'
   appProtocol: 'http'
   appPort: 3000
   httpReadBufferSize: 30
   httpMaxRequestSize: 10
   logLevel: 'debug'
   enableApiLogging: true
   appHealth: {
     enabled: true
     path: '/health'
     probeIntervalSeconds: 3
     probeTimeoutMilliseconds: 1000
     threshold: 3
   },
   maxConcurrency: 10
  }

  "dapr": {
    "enabled": true,
    "appId": "nodeapp",
    "appProtocol": "http",
    "appPort": 3000,
    "httpReadBufferSize": 30,
    "httpMaxRequestSize": 10,
    "logLevel": "debug",
    "enableApiLogging": true,
    "appHealth": {
      "enabled": true,
      "path": "/health",
      "probeIntervalSeconds": 3,
      "probeTimeoutMilliseconds": 1000,
      "threshold": 3,
    },
    "maxConcurrency": 10
  }