在本地环境中初始化 Dapr

使用 dapr init 获取 Dapr 边车二进制文件并在本地安装

既然您已经安装了 Dapr CLI，请使用该 CLI 在您的本地机器上初始化 Dapr。

Dapr 作为边车与您的应用程序一起运行。在自托管模式下，这意味着它是您本地机器上的一个进程。通过初始化 Dapr，您可以：

  • 获取并在本地安装 Dapr 边车二进制文件。
  • 创建一个开发环境，以简化使用 Dapr 的应用程序开发。

Dapr 初始化包括：

  1. 运行 Redis 容器实例，用作本地状态存储和消息代理。
  2. 运行 Zipkin 容器实例以实现可观测性。
  3. 创建一个默认组件文件夹，其中包含上述组件的定义。
  4. 运行 Dapr placement 服务容器实例以支持本地 Actor。
  5. 运行 Dapr scheduler 服务容器实例以进行作业调度。

步骤 1：打开提升权限的终端

如果满足以下条件，您将需要在此快速入门中使用 sudo：

  • 您使用 sudo 运行 Docker 命令，或
  • 安装路径是 /usr/local/bin（默认安装路径）。

以管理员身份运行 Windows Terminal 或命令提示符。

  1. 右键单击 Windows Terminal 或命令提示符图标。
  2. 选择以管理员身份运行。

步骤 2：运行 init CLI 命令

安装最新的 Dapr 运行时二进制文件：

dapr init

如果您使用 sudo 运行 Docker 命令，则需要使用：

sudo dapr init

如果您在带有 Docker 的 Mac OS Silicon 上安装，可能需要执行以下变通方法，以便在不使用 Kubernetes 的情况下启用 dapr init 与 Docker 通信。

  1. 导航到 Docker Desktop > Settings > Advanced。
  2. 选择**允许使用默认 Docker socket（需要密码）**复选框。

安装最新的 Dapr 运行时二进制文件：

dapr init

预期输出：

如果您遇到有关 Docker 未安装或运行的任何错误消息，请查看故障排除指南。

步骤 3：验证 Dapr 版本

dapr --version

输出：

CLI version: 1.17.1
Runtime version: 1.17.7

步骤 4：验证容器正在运行

如前所述，dapr init 命令会启动多个容器，帮助您开始使用 Dapr。验证您是否有运行 daprio/dapr、openzipkin/zipkin 和 redis 镜像的容器实例：

docker ps

输出：

步骤 5：验证组件目录已初始化

在 dapr init 时，CLI 还会创建一个默认组件文件夹，其中包含多个 YAML 文件，定义了状态存储、发布订阅和 Zipkin。Dapr 边车将读取这些组件并使用：

  • Redis 容器进行状态管理和消息传递。
  • Zipkin 容器收集追踪数据。

通过打开组件目录进行验证：

  • 在 Windows 上，位于 %UserProfile%\.dapr
  • 在 Linux/MacOS 上，位于 ~/.dapr
ls $HOME/.dapr

输出：

bin components config.yaml


您可以使用 PowerShell 或命令行进行验证。如果使用 PowerShell，请运行：

explorer "$env:USERPROFILE\.dapr"

如果使用命令行，请运行：

explorer "%USERPROFILE%\.dapr"

结果：

Slim 初始化

要在不安装任何默认配置文件或 Docker 容器的情况下安装 CLI，请使用 --slim`` 标志。[了解更多关于 init` 命令及其标志的信息。](https://dapr.website.cncfstack.com/zh-hans/reference/cli/dapr-init/)

dapr init --slim

其他工具（可选）

Diagrid Dashboard for Dapr Workflow

如果您计划构建 Dapr Workflow 应用程序，可以安装 Diagrid Dashboard 以在本地开发期间可视化工作流状态：

使用 Docker 启动 Diagrid Dashboard 容器：

docker run -p 8080:8080 ghcr.io/diagridio/diagrid-dashboard:latest
下一步：使用 Dapr API >>