Dapr 快速入门指南 on Dapr 文档库

安装 Dapr CLI

Mon, 01 Jan 0001 00:00:00 +0000

Dapr CLI 是执行各种 Dapr 相关任务的主要工具。您可以使用它来：

运行带有 Dapr 边车的应用程序。
查看边车日志。
列出正在运行的服务。
运行 Dapr 仪表板。

Dapr CLI 可在自托管和 Kubernetes 环境中使用。

开始之前

请在 Docker Desktop 的高级选项中确认已启用默认的 Docker socket。如果您在 Windows 上使用 WSL 集成，则此选项不可用。

步骤 1：安装 Dapr CLI

从终端安装

将最新的 Linux Dapr CLI 安装到 /usr/local/bin：

在本地环境中配置 Dapr

Mon, 01 Jan 0001 00:00:00 +0000

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

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

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

Dapr 的配置过程包括：

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

Kubernetes 开发环境

要在本地或远程 Kubernetes 集群中配置 Dapr 进行开发（包括上面列出的 Redis 和 Zipkin 容器），请参阅如何在 Kubernetes 上配置 Dapr 进行开发

Docker

推荐的开发环境需要 Docker。虽然您可以在没有 Docker 依赖的情况下配置 Dapr，但本指南的下一步假设您使用推荐的 Docker 开发环境。

您也可以安装 Podman 代替 Docker。阅读更多关于使用 Podman 配置 Dapr的信息。

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

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

使用 Dapr API

Mon, 01 Jan 0001 00:00:00 +0000

在本指南中，您将通过运行 sidecar 并直接调用状态管理 API 来模拟应用程序的操作。在使用 Dapr CLI 运行 Dapr 之后，您将：

保存一个状态对象。
读取/获取状态对象。
删除状态对象。

了解更多关于状态构建块及其工作原理的概念文档。

前置条件

安装 Dapr CLI。
运行 dapr init。

步骤 1: 运行 Dapr sidecar

dapr run 命令通常会运行您的应用程序和一个 Dapr sidecar。在这种情况下，由于您直接与状态管理 API 交互，它只运行 sidecar。

启动一个 Dapr sidecar，它将在端口 3500 上监听一个名为 myapp 的空白应用程序：

dapr run --app-id myapp --dapr-http-port 3500

由于上述命令没有定义自定义组件文件夹，Dapr 使用在 dapr init 流程中创建的默认组件定义。

步骤 2: 保存状态

使用一个对象更新状态。新的状态将如下所示：

[
 {
 "key": "name",
 "value": "Bruce Wayne"
 }
]

注意，状态中包含的每个对象都有一个 key，其值为 name。您将在下一步中使用该 key。

使用以下命令保存一个新的状态对象：

curl -X POST -H "Content-Type: application/json" -d '[{ "key": "name", "value": "Bruce Wayne"}]' http://localhost:3500/v1.0/state/statestore

Invoke-RestMethod -Method Post -ContentType 'application/json' -Body '[{ "key": "name", "value": "Bruce Wayne"}]' -Uri 'http://localhost:3500/v1.0/state/statestore'

步骤 3: 获取状态

使用状态管理 API 和 key name 检索您刚刚存储在状态中的对象。在同一个终端窗口中，运行以下命令：