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

如何操作：配置状态存储和发布/订阅消息代理

为 Dapr 配置状态存储和发布/订阅消息代理组件

为了启动和运行状态和发布/订阅构建块，需要两个组件：

用于持久化和恢复的状态存储组件。
作为发布/订阅的消息代理组件，用于异步式的消息传递。

支持的组件的完整列表可以在这里找到：

本页的其余部分描述了如何使用 Redis 启动和运行。

Self-hosted mode

当在自托管模式下初始化时，Dapr 会自动运行一个 Redis 容器并设置所需的 yaml 文件. 您可以跳过此页并跳转到下一步

创建 Redis 存储

Dapr 可以使用任何 Redis 实例–无论是在本地开发机器上的容器化的还是在托管云服务上的。如果您已经有了 Redis 存储，请转到配置部分。

作为初始化过程的一部分，Dapr CLI 会自动在自托管环境中安装 Redis。你已经准备就绪，可以跳到下一个步骤

您可以使用 Helm 在我们的 Kubernetes 集群中快速创建 dapr 实例。此方法需要安装 Helm v3。

安装 Redis 到您的集群：
```
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm install redis bitnami/redis
```
请注意，您将需要大于5的 Redis 版本, 这是 Dapr 的发布/订阅功能所要求的。如果你打算将 Redis 仅仅作为状态存储（而不用于发布/订阅），则可以使用较低的版本。

运行 kubectl get pods 来查看现在正在集群中运行的 Redis 容器。

$ kubectl get pods
NAME             READY   STATUS    RESTARTS   AGE
redis-master-0   1/1     Running   0          69s
redis-replicas-0    1/1     Running   0          69s
redis-replicas-1    1/1     Running   0          22s

请注意，主机名是 redis-master.default.svc.cluster.local:6379，并自动创建了 Kubernetes secret，redis。

此方法需要 Azure 订阅。

打开 Azure Portal 来启动 Azure Redis Cache 创建流程。如有必要，请登录。
填写必要的信息
- Dapr 发布/订阅使用 Redis streams ，这是由Redis 5.0引入的。如果您想使用 Azure Redis Cache 来处理发布/订阅，请确保将版本设置为 (PREVIEW) 6。
点击"创建"来启动 Redis 实例的部署。
你需要 Redis 实例的主机名，你可以从 Azure 中的"概述"中检索。它看起来像 xxxxxx.redis.cache.windows.net:6380。注意这一点，以备后用。
创建实例后，您需要获取访问密钥。导航到 “设置 “下的 “访问密钥”，创建一个 Kubernetes secret 来存储你的 Redis 密码。
```
kubectl create secret generic redis --from-literal=redis-password=*********
```

访问 AWS Redis 以部署 Redis 实例
注意 AWS 门户中的 Redis 主机名，以便以后使用。

创建一个 Kubernetes secret 来存储您的 Redis 密码：

kubectl create secret generic redis --from-literal=redis-password=*********

访问 GCP Cloud MemoryStore 来部署一个 MemoryStore 实例
记下 GCP 门户中的 Redis 主机名，以便以后使用。

创建一个 Kubernetes secret 来存储您的 Redis 密码：

kubectl create secret generic redis --from-literal=redis-password=*********

配置 Dapr 组件

Dapr 使用组件来定义用于构建块功能的资源。这些步骤将介绍如何将上面创建的资源连接到 Dapr 以进行状态和发布/订阅。

在自托管模式下，组件文件在以下位置自动创建：

Windows: %USERPROFILE%\.dapr\components\
Linux/MacOS: $HOME/.dapr/components

对于 Kubernetes 来说，文件可以在任何目录下创建，因为它们是用 kubectl 应用的。

创建状态存储组件

创建名为 redis-state.yaml 的文件，并粘贴以下内容：

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: statestore
  namespace: default
spec:
  type: state.redis
  version: v1
  metadata:
  - name: redisHost
    value: <REPLACE WITH HOSTNAME FROM ABOVE - for Redis on Kubernetes it is redis-master.default.svc.cluster.local:6379>
  - name: redisPassword
    secretKeyRef:
      name: redis
      key: redis-password
  # uncomment below for connecting to redis cache instances over TLS (ex - Azure Redis Cache)
  # - name: enableTLS
  #   value: true

这个例子使用了在用上述说明设置集群时创建的 kubernetes secret。

Other stores

如果使用 Redis 以外的其他状态存储，请参考支持的状态存储，了解要设置哪些选项。

创建发布/订阅消息代理组件

创建名为 redis-pubsub.yaml 的文件, 并粘贴以下内容:

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: pubsub
  namespace: default
spec:
  type: pubsub.redis
  version: v1
  metadata:
  - name: redisHost
    value: <REPLACE WITH HOSTNAME FROM ABOVE - for Redis on Kubernetes it is redis-master.default.svc.cluster.local:6379>
  - name: redisPassword
    secretKeyRef:
      name: redis
      key: redis-password
 # uncomment below for connecting to redis cache instances over TLS (ex - Azure Redis Cache)
  # - name: enableTLS
  #   value: true

此示例使用在使用上述说明设置集群时创建的 kubernetes secret。

Other stores

如果使用 Redis 以外的发布/订阅消息代理，请参考支持的发布/订阅消息代理，了解要设置哪些选项。

硬编码密码（不推荐）

仅用于开发目的，你可以跳过创建 kubernetes secret，直接将密码放入 Dapr 组件文件中。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: statestore
  namespace: default
spec:
  type: state.redis
  version: v1
  metadata:
  - name: redisHost
    value: <HOST>
  - name: redisPassword
    value: <PASSWORD>
  # uncomment below for connecting to redis cache instances over TLS (ex - Azure Redis Cache)
  # - name: enableTLS
  #   value: true

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: pubsub
  namespace: default
spec:
  type: pubsub.redis
  version: v1
  metadata:
  - name: redisHost
    value: <HOST>
  - name: redisPassword
    value: <PASSWORD>
  # uncomment below for connecting to redis cache instances over TLS (ex - Azure Redis Cache)
  # - name: enableTLS
  #   value: true

默认情况下，当你运行 dapr init 时，Dapr CLI 会创建一个本地的 Redis 实例。但是，如果要配置不同的 Redis 实例，则可以：

更新现有的组件文件或在默认的组件目录下创建新的组件文件。
- Linux/MacOS: $HOME/.dapr/components
- Windows: %USERPROFILE%\.dapr\components
在你的应用程序文件夹中创建一个新的 components 目录，其中包含 YAML 文件，并提供 dapr run 命令的路径，标志为--components-path。

Self-hosted slim mode

如果你在 <a href="https://v1-5.docs.dapr.io/zh-hans/operations/hosting/self-hosted/self-hosted-no-docker/">Slim 模式</a>下初始化了 Dapr (不使用 Docker)，你需要手动创建默认目录， 或者始终使用 <code>--components-path</code> 指定组件目录。

运行 kubectl apply -f <FILENAME> 同时适用于状态文件和发布订阅文件：

kubectl apply -f redis-state.yaml
kubectl apply -f redis-pubsub.yaml

下一步

试用 Dapr 快速入门

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.