The documentation you are viewing is for Dapr v1.7 which is an older version of Dapr. For up-to-date documentation, see the latest version.

使用 Dapr 的内置 API

After running the dapr init command in the previous step, your local environment has the Dapr sidecar binaries as well as default component definitions for both state management and a message broker (both using Redis). 现在您可以通过使用 Dapr CLI 来运行 Dapr sidecar 并尝试使用状态API来存储和检索状态,从而尝试 Dapr 提供的一些功能。 You can learn more about the state building block and how it works in these docs.

您现在将运行sidecar并直接调用 API (模拟应用程序将做什么)。

第 1 步:运行Dapr sidecar

One of the most useful Dapr CLI commands is dapr run. 此命令与sidecar一起启动一个应用程序。 为了本教程的目的,您将在没有应用程序的情况下运行sidecar。

运行以下命令以启动 Dapr sidecar,它将在端口 3500 上监听名为 myapp 的空白应用程序:

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

使用此命令,没有定义自定义组件文件夹。因此Dapr 使用在 init 流中创建的默认组件定义(这些定义可以在 $HOME/.dapr/components 在 Linux 或 MacOS 上,在 %USERPROFILE%\.dapr\components在 Windows)。 这些告诉 Dapr 使用本地的 Redis Docker 容器作为状态存储和消息代理。

第 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 来获取你刚刚存储在状态中的对象。


用上面运行的同一个Dapr实例运行:

curl http://localhost:3500/v1.0/state/statestore/name

用上面运行的同一个Dapr实例运行:

Invoke-RestMethod -Uri 'http://localhost:3500/v1.0/state/statestore/name'

第 4 步:查看状态如何在 Redis 中存储

您可以在 Redis 容器中看到并验证Dapr 正在使用它作为状态存储。 运行以下命令来使用Redis CLI:

docker exec -it dapr_redis redis-cli

列出redis keys以查看Dapr如何创建一个键值对(您提供给 dapr run 的app-id 作为key的前缀):

keys *
1) "myapp||name"

查看运行时状态值:

hgetall "myapp||name"
1) "data"
2) "\"Bruce Wayne\""
3) "version"
4) "1"

退出redis-cli,使用

exit
下一步: 定义一个组件 >>