在本地环境中配置 Dapr

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

现在您已经安装了 Dapr CLI，可以使用 CLI 在本地计算机上配置 Dapr。

Dapr 作为一个附属进程与您的应用程序一起运行。在自托管模式下，这意味着它在您的本地计算机上作为一个进程运行。通过配置 Dapr，您可以：

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

Dapr 的配置过程包括：

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

步骤 1：打开具有管理员权限的终端

如果您在运行 Docker 命令时使用 sudo，或者安装路径是 /usr/local/bin（默认安装路径），则需要在此快速入门中使用 sudo。

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

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

步骤 2：运行 init CLI 命令

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

dapr init

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

sudo dapr init

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

  1. 导航到 Docker Desktop > Settings > Advanced。
  2. 选中 允许使用默认 Docker 套接字（需要密码） 复选框。

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

dapr init

预期输出：

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

步骤 3：验证 Dapr 版本

dapr --version

输出：

CLI version: 1.15.1
Runtime version: 1.15.5

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

如前所述，dapr init 命令启动了几个容器，这些容器将帮助您开始使用 Dapr。通过 daprio/dapr、openzipkin/zipkin 和 redis 镜像验证您是否有容器实例在运行：

docker ps

输出：

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

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

  • Redis 容器进行状态管理和消息传递。
  • Zipkin 容器用于收集跟踪。

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

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

输出：

bin components config.yaml


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

explorer "$env:USERPROFILE\.dapr"

如果使用命令行，运行：

explorer "%USERPROFILE%\.dapr"

结果：


精简初始化

要安装没有任何默认配置文件或 Docker 容器的 CLI，请使用 --slim 标志。了解更多关于 init 命令及其标志的信息。

dapr init --slim
下一步：使用 Dapr API >>