如何为指定Dapr Actor配置对应的状态存储组件？

背景 #

我已在Azure容器应用环境中配置了若干Dapr Actor，希望为不同Actor分配不同的Azure存储账户来存储状态。目前已定义了2个Dapr状态组件，且确认这些组件可被Azure Container App访问，同时已按照官方文档要求将组件metadata中的actorStateStore设置为true，使其可作为Actor的状态存储。

问题 #

在Actor代码中使用StateManager时，无法指定具体使用哪个状态组件，示例代码如下：

internal interface IUserCodeActor : IActor
{
    Task CreateAsync
    (
        UserCodeContract userCodeContract
    );
}

internal sealed class UserCodeActor : Actor, IUserCodeActor
{
    private const string DefaultStateName = "user_code_state";
    
    public UserCodeActor(ActorHost actorHost) : base(actorHost)
    {
    }

    public async Task CreateAsync
    (
        UserCodeContract userCodeContract
    )
    {
        //  --> 这里会使用哪个存储？能否指定？
        await StateManager.SetStateAsync
        (
            DefaultStateName,
            new UserCodeState
            {
                UserCode = userCodeContract.UserCode.Value,
                ClientId = userCodeContract.ClientId.Value,
                DeviceCode = userCodeContract.DeviceCode.Value
            }
        );

        await StateManager.SaveStateAsync();
    }
}

提问 #

如何为指定的Actor配置对应的状态存储组件？

要为不同Dapr Actor指定不同的状态存储组件，需要通过组件命名+Actor配置映射的方式实现，具体步骤如下：

1. 为状态组件设置唯一名称 #

确保两个Azure存储状态组件有不同的名称，比如分别命名为azure-storage-actor-state-1和azure-storage-actor-state-2，每个组件的metadata中保留actorStateStore: true配置。

2. 通过配置绑定组件与Actor #

Dapr支持两种方式为特定Actor类型指定状态存储组件：

方式一：使用Dapr配置文件（config.yaml） #

在Dapr配置文件中添加actors配置段，针对不同Actor类型指定对应的状态存储组件名称：

apiVersion: dapr.io/v1alpha1
kind: Configuration
metadata:
  name: daprConfig
spec:
  actors:
    actorStateStore: azure-storage-actor-state-1  # 默认状态存储
    entities:
      - name: UserCodeActor
        stateStore: azure-storage-actor-state-2  # 为UserCodeActor指定专属存储
      - name: AnotherActor
        stateStore: azure-storage-actor-state-1  # 其他Actor使用默认或指定存储

将此配置文件部署到Azure容器应用环境中，确保Dapr sidecar能加载该配置。

方式二：使用环境变量 #

在Azure Container App中部署时，可通过环境变量为特定Actor指定状态存储：

• 针对单个Actor类型：设置DAPR_ACTORS_ENTITIES_{ACTOR_NAME}_STATESTORE，比如DAPR_ACTORS_ENTITIES_USERCODEACTOR_STATESTORE=azure-storage-actor-state-2
• 默认状态存储：设置DAPR_ACTORS_ACTORSTATESTORE=azure-storage-actor-state-1

3. 代码无需修改 #

配置完成后，Actor代码中的StateManager会自动使用配置中指定的状态存储组件，原代码可保持不变。

内容的提问来源于stack exchange，提问作者Kzryzstof