发布/订阅代理
关于为 Dapr 发布/订阅设置不同消息代理的指导
Dapr 支持与发布/订阅消息总线的集成,为应用程序提供创建事件驱动、松耦合架构的能力,生产者通过主题向消费者发送事件。
Dapr 允许为每个应用程序配置多个具名的发布/订阅组件。每个组件都有一个名称,用于在发布消息主题时识别。阅读 API 参考 了解如何发布和订阅主题的详细信息。
发布/订阅组件是可扩展的。支持的组件列表在这里,实现可以在 components-contrib 仓库中找到。
组件文件
发布/订阅通过 Component
文件描述:
apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
name: pubsub
namespace: default
spec:
type: pubsub.<NAME>
version: v1
metadata:
- name: <KEY>
value: <VALUE>
- name: <KEY>
value: <VALUE>
...
发布/订阅的类型由 type
字段指定,连接字符串和其他元数据等属性放在 .metadata
部分。尽管元数据值可以包含明文的 secret,建议您通过 secretKeyRef
使用 secret 存储 来管理这些 secret。
主题创建
根据您使用的发布/订阅消息总线及其配置,主题可能会自动创建。即使消息总线支持自动主题创建,在生产环境中禁用它是一种常见的治理实践。您可能仍需要使用 CLI、管理控制台或请求表单手动创建应用程序所需的主题。虽然所有发布/订阅组件都支持 consumerID
元数据,但如果您未提供,运行时会自动生成一个消费者 ID。所有组件元数据字段值可以使用 模板化元数据值,这些值在 Dapr sidecar 启动时解析。例如,您可以选择使用 {namespace}
作为 consumerGroup
,以便在不同命名空间中使用相同的 appId
使用相同的主题,如本文所述。
访问本指南获取配置和使用发布/订阅组件的说明。
相关链接
1 - HowTo: 配置具有多个命名空间的 Pub/Sub 组件
使用 Dapr Pub/Sub 与多个命名空间
在某些情况下,应用程序可能会跨多个命名空间分布,并通过 PubSub 共享队列或主题。在这种情况下,需要在每个命名空间中配置 PubSub 组件。
注意
命名空间是 Dapr 用于限定应用程序和组件范围的概念。本示例使用 Kubernetes 命名空间,但 Dapr 组件命名空间范围可以在任何支持的平台上使用。阅读
How-To: 将组件限定到一个或多个应用程序 以获取有关限定组件的更多信息。
本示例使用 PubSub 示例。Redis 安装和订阅者位于 namespace-a
,而发布者 UI 位于 namespace-b
。即使 Redis 安装在另一个命名空间,或者您使用托管云服务如 Azure ServiceBus、AWS SNS/SQS 或 GCP PubSub,该解决方案也同样适用。
以下是使用命名空间的示例图。

下表显示了哪些资源部署到哪些命名空间:
资源 | namespace-a | namespace-b |
---|
Redis 主节点 | ✅ | ❌ |
Redis 副本 | ✅ | ❌ |
Dapr 的 PubSub 组件 | ✅ | ✅ |
Node 订阅者 | ✅ | ❌ |
Python 订阅者 | ✅ | ❌ |
React UI 发布者 | ❌ | ✅ |
注意
所有 pub/sub 组件都支持通过
命名空间或组件范围 将 pub/sub 主题限制到特定应用程序。
前提条件
设置 namespace-a
创建命名空间并切换 kubectl 使用它。
kubectl create namespace namespace-a
kubectl config set-context --current --namespace=namespace-a
在 namespace-a
上安装 Redis(主节点和从节点),按照这些说明。
现在,配置 deploy/redis.yaml
,确保主机名包含 namespace-a
。
apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
name: pubsub
spec:
type: pubsub.redis
version: v1
metadata:
- name: "redisHost"
value: "redis-master.namespace-a.svc:6379"
- name: "redisPassword"
value: "YOUR_PASSWORD"
将资源部署到 namespace-a
:
kubectl apply -f deploy/redis.yaml
kubectl apply -f deploy/node-subscriber.yaml
kubectl apply -f deploy/python-subscriber.yaml
设置 namespace-b
创建命名空间并切换 kubectl 使用它。
kubectl create namespace namespace-b
kubectl config set-context --current --namespace=namespace-b
将资源部署到 namespace-b
,包括 Redis 组件:
kubectl apply -f deploy/redis.yaml
kubectl apply -f deploy/react-form.yaml
现在,找到 react-form 的 IP 地址,在浏览器中打开它并向每个主题(A、B 和 C)发布消息。
kubectl get service -A
确认订阅者接收到消息。
切换回 namespace-a
:
kubectl config set-context --current --namespace=namespace-a
找到 POD 名称:
kubectl get pod # 复制 POD 名称并在下一个命令中使用。
显示日志:
kubectl logs node-subscriber-XYZ node-subscriber
kubectl logs python-subscriber-XYZ python-subscriber
在浏览器上发布的消息应显示在相应订阅者的日志中。Node.js 订阅者接收类型为 “A” 和 “B” 的消息,而 Python 订阅者接收类型为 “A” 和 “C” 的消息。
清理
kubectl delete -f deploy/redis.yaml --namespace namespace-a
kubectl delete -f deploy/node-subscriber.yaml --namespace namespace-a
kubectl delete -f deploy/python-subscriber.yaml --namespace namespace-a
kubectl delete -f deploy/react-form.yaml --namespace namespace-b
kubectl delete -f deploy/redis.yaml --namespace namespace-b
kubectl config set-context --current --namespace=default
kubectl delete namespace namespace-a
kubectl delete namespace namespace-b
相关链接