使用 Dapr 的内置 API

前一步中运行了 dapr init 命令后, 您的本地环境有 Dapr sidecar 二进制文件以及默认组件定义的 状态管理 和 消息代理 (都使用 Redis)。 现在您可以通过使用 Dapr CLI 来运行 Dapr sidecar 并尝试使用状态API来存储和检索状态,从而尝试 Dapr 提供的一些功能。 你可以在 这些文档中了解更多关于状态构建块及其工作原理的信息。

您现在将运行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 步:保存状态

We will now update the state with an object. The new state will look like this:

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

Notice, the object contained in the state has a key assigned with the value name. You will use the key in the next step.

Run the command shown below to store the new state.


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 步:获取状态

Now get the object you just stored in the state by using the state management API with the 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
Next step: Define a component >>
Last modified January 1, 0001