可插拔组件概述

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

可插拔组件是指那些不包含在运行时中的组件，与 dapr init 中的内置组件相对。您可以配置 Dapr 使用这些可插拔组件，它们利用构建块 API，但注册方式与内置 Dapr 组件不同。

可插拔组件与内置组件

Dapr 提供了两种注册和创建组件的方法：

运行时中包含的内置组件，可以在components-contrib 仓库中找到。
独立部署和注册的可插拔组件。

这两种注册选项虽然都利用了 Dapr 的构建块 API，但实现过程不同。

组件详情	内置组件	可插拔组件
语言	只能用 Go 编写	可以用任何支持 gRPC 的语言编写
运行位置	作为 Dapr 运行时可执行文件的一部分	作为 pod 中的独立进程或容器运行，与 Dapr 本身分开运行。
与 Dapr 的注册方式	包含在 Dapr 代码库中	通过 Unix 域套接字（使用 gRPC）与 Dapr 注册
分发	随 Dapr 版本发布。组件的新功能与 Dapr 版本保持一致	独立于 Dapr 本身分发。可以在需要时添加新功能，并遵循自己的发布周期。
组件激活方式	Dapr 启动运行组件（自动）	用户启动组件（手动）

为什么创建可插拔组件？

在以下场景中，可插拔组件非常有用：

您需要一个私有组件。
您希望将组件与 Dapr 的发布过程分开。
您对 Go 不太熟悉，或者用 Go 实现组件并不理想。

特性

实现可插拔组件

要实现可插拔组件，您需要在组件中实现一个 gRPC 服务。实现 gRPC 服务需要三个步骤：

如何：实现可插拔组件

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

在本指南中，您将学习实现可插拔组件的原因和方法。要了解如何配置和注册可插拔组件，请参阅如何：注册可插拔组件。

实现可插拔组件

要实现可插拔组件，需在组件中实现 gRPC 服务。实现 gRPC 服务需要三个步骤：

找到 proto 定义文件

每个支持的服务接口（如状态存储、发布订阅、绑定、密钥存储）都提供了 proto 定义。

目前支持以下组件 API：

状态存储
发布订阅
绑定
密钥存储

组件	类型	gRPC 定义	内置参考实现	文档
状态存储	`state`	state.proto	Redis	概念, 如何, API 规范
发布订阅	`pubsub`	pubsub.proto	Redis	概念, 如何, API 规范
绑定	`bindings`	bindings.proto	Kafka	概念, 输入如何, 输出如何, API 规范
密钥存储	`secretstores`	secretstore.proto	Hashicorp/Vault	概念, 如何-secrets, API 规范

以下是可插拔组件状态存储的 gRPC 服务定义片段（[state.proto]）：

// StateStore 服务为状态存储组件提供 gRPC 接口。
service StateStore {
 // 使用给定的元数据初始化状态存储组件。
 rpc Init(InitRequest) returns (InitResponse) {}
 // 返回已实现的状态存储功能列表。
 rpc Features(FeaturesRequest) returns (FeaturesResponse) {}
 // Ping 状态存储。用于活跃性目的。
 rpc Ping(PingRequest) returns (PingResponse) {}
 
 // 从状态存储中删除指定的键。
 rpc Delete(DeleteRequest) returns (DeleteResponse) {}
 // 从给定的键获取数据。
 rpc Get(GetRequest) returns (GetResponse) {}
 // 设置指定键的值。
 rpc Set(SetRequest) returns (SetResponse) {}

 // 一次删除多个键。
 rpc BulkDelete(BulkDeleteRequest) returns (BulkDeleteResponse) {}
 // 一次检索多个键。
 rpc BulkGet(BulkGetRequest) returns (BulkGetResponse) {}
 // 一次设置多个键的值。
 rpc BulkSet(BulkSetRequest) returns (BulkSetResponse) {}
}

StateStore 服务接口总共公开了 9 个方法：

可插拔组件 on Dapr 文档库

可插拔组件概述

可插拔组件与内置组件

为什么创建可插拔组件？

特性

实现可插拔组件

如何：实现可插拔组件

实现可插拔组件

找到 proto 定义文件