.NET SDK 的 Dapr 可插拔组件高级用法 on Dapr 文档库

在 .NET Dapr 可插拔组件中使用多个服务

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

一个可插拔组件可以托管多种类型的组件。您可能会这样做：

以减少集群中运行的sidecar数量
以便将可能共享库和实现的相关组件进行分组，例如：
- 一个既作为通用状态存储又作为
- 允许更具体操作的输出绑定。

每个Unix域套接字可以管理对每种类型的一个组件的调用。要托管多个相同类型的组件，您可以将这些类型分布在多个套接字上。SDK将每个套接字绑定到一个“服务”，每个服务由一个或多个组件类型组成。

注册多个服务

每次调用RegisterService()都会将一个套接字绑定到一组注册的组件，其中每种类型的组件每个服务可以注册一个。

var app = DaprPluggableComponentsApplication.Create();

app.RegisterService(
 "service-a",
 serviceBuilder =>
 {
 serviceBuilder.RegisterStateStore<MyDatabaseStateStore>();
 serviceBuilder.RegisterBinding<MyDatabaseOutputBinding>();
 });

app.RegisterService(
 "service-b",
 serviceBuilder =>
 {
 serviceBuilder.RegisterStateStore<AnotherStateStore>();
 });

app.Run();

class MyDatabaseStateStore : IStateStore
{
 // ...
}

class MyDatabaseOutputBinding : IOutputBinding
{
 // ...
}

class AnotherStateStore : IStateStore
{
 // ...
}

配置多个组件

配置Dapr以使用托管组件与任何单个组件相同 - 组件YAML引用关联的套接字。

#
# 此组件使用与套接字 `state-store-a` 关联的状态存储
#
apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: state-store-a
spec:
 type: state.service-a
 version: v1
 metadata: []

#
# 此组件使用与套接字 `state-store-b` 关联的状态存储
#
apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: state-store-b
spec:
 type: state.service-b
 version: v1
 metadata: []

.NET Dapr 插件组件的应用环境配置

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

.NET Dapr 插件组件应用可以配置依赖注入、日志记录和配置值，类似于 ASP.NET 应用。DaprPluggableComponentsApplication 提供了一组与 WebApplicationBuilder 类似的配置属性。

依赖注入

注册到服务的组件可以参与依赖注入。组件构造函数中的参数会在创建时被注入，前提是这些类型已在应用中注册。你可以通过 DaprPluggableComponentsApplication 提供的 IServiceCollection 来注册它们。

var app = DaprPluggableComponentsApplication.Create();

// 将 MyService 注册为 IService 的单例实现。
app.Services.AddSingleton<IService, MyService>();

app.RegisterService(
 "<service name>",
 serviceBuilder =>
 {
 serviceBuilder.RegisterStateStore<MyStateStore>();
 });

app.Run();

interface IService
{
 // ...
}

class MyService : IService
{
 // ...
}

class MyStateStore : IStateStore
{
 // 在创建 state 存储时注入 IService。
 public MyStateStore(IService service)
 {
 // ...
 }

 // ...
}

警告

不推荐使用 IServiceCollection.AddScoped()。因为此类实例的生命周期仅限于单个 gRPC 方法调用，这与组件实例的生命周期不一致。

日志记录

.NET Dapr 插件组件可以使用标准 .NET 日志机制。DaprPluggableComponentsApplication 提供了一个 ILoggingBuilder，可以通过它进行配置。

.NET Dapr 可插拔组件的生命周期

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

在 .NET Dapr 中，注册组件有两种方式：

组件作为单例运行，其生命周期由 SDK 管理
组件的生命周期由可插拔组件决定，可以是多实例或单例，视需要而定

单例组件

按类型注册的组件将作为单例运行：一个实例将为与该 socket 关联的所有配置组件提供服务。当仅存在一个该类型的组件并在 Dapr 应用程序之间共享时，这种方法是最佳选择。

var app = DaprPluggableComponentsApplication.Create();

app.RegisterService(
 "service-a",
 serviceBuilder =>
 {
 serviceBuilder.RegisterStateStore<SingletonStateStore>();
 });

app.Run();

class SingletonStateStore : IStateStore
{
 // ...
}

多实例组件

可以通过传递“工厂方法”来注册组件。对于与该 socket 关联的每个配置组件，该方法将被调用。该方法返回要与该组件关联的实例（无论是否共享）。当多个相同类型的组件可能配置有不同的元数据集时，或者当组件操作需要彼此隔离时，这种方法是最佳选择。

工厂方法会接收上下文信息，例如配置的 Dapr 组件的 ID，这些信息可用于区分不同的组件实例。

var app = DaprPluggableComponentsApplication.Create();

app.RegisterService(
 "service-a",
 serviceBuilder =>
 {
 serviceBuilder.RegisterStateStore(
 context =>
 {
 return new MultiStateStore(context.InstanceId);
 });
 });

app.Run();

class MultiStateStore : IStateStore
{
 private readonly string instanceId;

 public MultiStateStore(string instanceId)
 {
 this.instanceId = instanceId;
 }

 // ...
}