Bindings on Dapr 文档库

bindings 概述

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

通过 Dapr 的 bindings API，您可以利用外部系统的事件来触发应用程序，并与外部系统交互。使用 bindings API，您可以：

避免连接到消息系统并进行轮询的复杂性（如队列和消息总线）。
专注于业务逻辑，而不是系统交互的实现细节。
使您的代码不依赖于特定的 SDK 或库。
处理重试和故障恢复。
在运行时可以切换不同的 bindings。
构建具有特定环境 bindings 设置的可移植应用程序，而无需更改代码。

例如，通过 bindings，您的应用程序可以响应传入的 Twilio/SMS 消息，而无需：

添加或配置第三方 Twilio SDK
担心从 Twilio 轮询（或使用 WebSockets 等）

在上图中：

输入 binding 触发您应用程序上的一个方法。
在组件上执行输出 binding 操作，例如 "create"。

bindings 的开发独立于 Dapr 运行时。您可以查看并贡献 bindings。

注意

如果您正在使用 HTTP Binding，建议使用service-invocation 代替。阅读如何：使用 HTTP 调用非 Dapr 端点以获取更多信息。

输入 bindings

通过输入 bindings，您可以在外部资源发生事件时触发您的应用程序。请求中可以发送可选的负载和元数据。

以下概述视频和演示展示了 Dapr 输入 binding 的工作原理。

要接收来自输入 binding 的事件：

操作指南：使用输入绑定触发应用程序

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

当外部资源发生事件时，您可以通过输入绑定来触发您的应用程序。外部资源可以是队列、消息管道、云服务、文件系统等。请求中可以发送可选的负载和元数据。

输入绑定非常适合用于事件驱动的处理、数据管道或一般的事件响应和后续处理。Dapr输入绑定允许您：

在不需要特定SDK或库的情况下接收事件
在不更改代码的情况下替换绑定
专注于业务逻辑而不是事件资源的实现

本指南使用Kafka绑定作为示例。您可以从绑定组件列表中找到您偏好的绑定规范。在本指南中：

示例调用/binding端点，使用checkout作为要调用的绑定名称。
负载需要放在data字段中，可以是任何可序列化为JSON的值。
operation字段指定绑定需要执行的操作。例如，Kafka绑定支持create操作。
- 您可以查看每个输出绑定支持的操作（特定于每个组件）。

注意

如果您还没有尝试过，试试绑定快速入门，快速了解如何使用绑定API。

创建绑定

创建一个binding.yaml文件，并保存到应用程序目录中的components子文件夹中。

创建一个名为checkout的新绑定组件。在metadata部分中，配置以下与Kafka相关的属性：

您将发布消息的主题
代理

在创建绑定组件时，指定绑定的支持direction。

使用dapr run命令的--resources-path标志指向您的自定义资源目录。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: checkout
spec:
 type: bindings.kafka
 version: v1
 metadata:
 # Kafka代理连接设置
 - name: brokers
 value: localhost:9092
 # 消费者配置：主题和消费者组
 - name: topics
 value: sample
 - name: consumerGroup
 value: group1
 # 发布者配置：主题
 - name: publishTopic
 value: sample
 - name: authRequired
 value: false
 - name: direction
 value: input

要部署到Kubernetes集群中，运行kubectl apply -f binding.yaml。

操作指南：使用输出绑定与外部资源交互

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

使用输出绑定，您可以与外部资源进行交互。在调用请求中，您可以发送可选的负载和元数据。

本指南以Kafka绑定为例。您可以从绑定组件列表中选择您偏好的绑定规范。在本指南中：

示例中调用了/binding端点，使用checkout作为要调用的绑定名称。
负载放在必需的data字段中，可以是任何JSON可序列化的值。
operation字段指定绑定需要执行的操作。例如，Kafka绑定支持create操作。
- 您可以查看每个输出绑定支持的操作（特定于每个组件）。

注意

如果您还没有尝试过，请尝试绑定快速入门，以快速了解如何使用bindings API。

创建绑定

创建一个binding.yaml文件，并将其保存到应用程序目录中的components子文件夹中。

创建一个名为checkout的新绑定组件。在metadata部分中，配置以下与Kafka相关的属性：

您将发布消息的主题
代理

在创建绑定组件时，指定绑定的支持direction。

使用dapr run的--resources-path标志指向您的自定义资源目录。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: checkout
spec:
 type: bindings.kafka
 version: v1
 metadata:
 # Kafka代理连接设置
 - name: brokers
 value: localhost:9092
 # 消费者配置：主题和消费者组
 - name: topics
 value: sample
 - name: consumerGroup
 value: group1
 # 发布者配置：主题
 - name: publishTopic
 value: sample
 - name: authRequired
 value: false
 - name: direction
 value: output

要将以下binding.yaml文件部署到Kubernetes集群中，运行kubectl apply -f binding.yaml。