Dapr 边车（daprd）概述

Dapr 边车进程概述

Dapr 使用边车模式，这意味着 Dapr API 在一个单独的进程中运行和暴露，该进程称为 Dapr 边车，与您的应用并行运行。Dapr 边车进程名为 daprd，根据托管环境的不同，以不同的方式启动。

Dapr 边车暴露：

当应用在其配置的端口上可访问时，Dapr 边车将达到就绪状态。在应用启动/初始化期间，应用无法访问 Dapr 组件。

边车 API 通过本地 http 或 gRPC 端点从您的应用调用。

自托管模式下使用 dapr run

当 Dapr 以自托管模式安装时，daprd 二进制文件会被下载并放置在用户主目录下（Linux/macOS 为 $HOME/.dapr/bin，Windows 为 %USERPROFILE%\.dapr\bin\）。

在自托管模式下，运行 Dapr CLI 的 run 命令 会使用提供的应用可执行文件启动 daprd 可执行文件。这是在本地开发和测试等场景中运行 Dapr 边车的推荐方式。

您可以在 Dapr run 命令参考 中找到 CLI 暴露的用于配置边车的各种参数。

Kubernetes 集群中使用 dapr-sidecar-injector

在 Kubernetes 上，Dapr 控制平面包含 dapr-sidecar-injector 服务，该服务监视带有 dapr.io/enabled 注解的新 Pod，并在 Pod 内注入一个包含 daprd 进程的容器。在这种情况下，边车参数可以通过注解传递，如此表中的 Kubernetes 注解 列所述。

原生边车（Kubernetes 1.28+）

默认情况下，daprd 作为常规容器与您的应用一起注入。使用 Kubernetes 原生边车（KEP-753），daprd 改为作为带有 restartPolicy: Always 的初始化容器注入。有关行为和生命周期语义的详细信息，请参阅 Kubernetes 边车容器文档。

通过 Helm 全局启用原生边车：

dapr_sidecar_injector:
  nativeSidecar: true

或通过注解按 Pod 启用：

annotations:
  dapr.io/enabled: "true"
  dapr.io/enable-native-sidecar: "true"

直接运行边车

在大多数情况下，您不需要显式运行 daprd，因为边车由 CLI（自托管模式）或 dapr-sidecar-injector 服务（Kubernetes）启动。对于高级用例（调试、脚本部署等），可以直接启动 daprd 进程。

有关所有可用参数的详细列表，请运行 daprd --help 或参阅此表，该表概述了 daprd 参数与 CLI 参数和 Kubernetes 注解的关联方式。

示例

  1. 通过指定唯一 ID 在应用旁边启动边车。

    注意： --app-id 是必填字段，且不能包含点。

    daprd --app-id myapp

  2. 指定应用正在监听的端口

    daprd --app-id myapp --app-port 5000

  3. 如果您使用多个自定义资源并希望指定资源定义文件的位置，请使用 --resources-path 参数：

    daprd --app-id myapp --resources-path <PATH-TO-RESOURCES-FILES>

  4. 如果您将组件和其他资源（例如，弹性策略、订阅或配置）组织到单独的文件夹或共享文件夹中，可以指定多个资源路径：

    daprd --app-id myapp --resources-path <PATH-1-TO-RESOURCES-FILES> --resources-path <PATH-2-TO-RESOURCES-FILES>

  5. 运行应用时启用 Prometheus 指标收集

    daprd --app-id myapp --enable-metrics

  6. 仅监听 IPv4 和 IPv6 回环地址

    daprd --app-id myapp --dapr-listen-addresses '127.0.0.1,[::1]'