配置存储组件规格

• 1: Azure App Configuration
• 2: PostgreSQL
• 3: Redis

1 - Azure App Configuration

组件格式

要设置 Azure App Configuration 配置存储，需创建一个类型为 configuration.azure.appconfig 的组件。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: <NAME>
spec:
  type: configuration.azure.appconfig
  version: v1
  metadata:
  - name: host # 当使用 Azure 身份验证机制时应使用 host。
    value: <HOST>
  - name: connectionString # 当使用 Azure 身份验证机制时不应使用 connectionString。
    value: <CONNECTIONSTRING>
  - name: maxRetries
    value: # 可选
  - name: retryDelay
    value: # 可选
  - name: maxRetryDelay
    value: # 可选
  - name: azureEnvironment # 可选，默认为 AZUREPUBLICCLOUD
    value: "AZUREPUBLICCLOUD"
  # 请参阅下方的身份验证部分以了解所有选项
  - name: azureTenantId # 可选
    value: "[your_service_principal_tenant_id]"
  - name: azureClientId # 可选
    value: "[your_service_principal_app_id]"
  - name: azureCertificateFile # 可选
    value : "[pfx_certificate_file_fully_qualified_local_path]"
  - name: subscribePollInterval # 可选
    value: #可选 [期望格式示例 - 24h]

规范元数据字段

注意：必须指定 host 或 connectionString 其中之一。

使用连接字符串进行身份验证

使用连接字符串访问 App Configuration 实例，该字符串可在 Azure 门户中获取。由于连接字符串包含凭据信息，应将其视为密钥并使用密钥存储。

使用 Microsoft Entra ID 进行身份验证

Azure App Configuration 配置存储组件还支持通过 Microsoft Entra ID 进行身份验证。在启用此组件之前：

• 阅读向 Azure 进行身份验证文档。
• 创建 Microsoft Entra ID 应用程序（也称为服务主体）。
• 或者，为你的应用程序平台创建托管标识。

设置 Azure App Configuration

你需要一个 Azure 订阅来设置 Azure App Configuration。

1. 启动 Azure App Configuration 创建流程。必要时登录。

2. 点击创建开始部署你的 Azure App Configuration 实例。

3. 实例创建完成后，获取主机（终端节点）或连接字符串：

   • 对于主机：导航至资源的概览并复制终端节点。
   • 对于连接字符串：导航至设置 > 访问密钥并复制你的连接字符串。

4. 将你的主机或连接字符串添加到 Dapr 可应用的 azappconfig.yaml 文件中。

   将 host 键设置为 [终端节点]或将 connectionString 键设置为你之前保存的值。

   Note

   在生产级应用程序中，遵循密钥管理说明以安全地管理你的密钥。

Azure App Configuration 请求元数据

在 Azure App Configuration 中，你可以使用标签为同一键定义不同的值。例如，你可以为开发环境和生产环境定义一个具有不同值的单个键。你可以指定在连接到 App Configuration 时加载哪个标签

Azure App Configuration 存储组件支持以下可选的 label 元数据属性：

label：要检索的配置的标签。如果不存在，配置存储将返回指定键和空标签的配置。

标签可以通过请求 URL 中的查询参数来填充：

GET curl http://localhost:<daprPort>/v1.0/configuration/<store-name>?key=<key name>&metadata.label=<label value>

相关链接

• Dapr 组件的基本架构
• 配置构建块

2 - PostgreSQL

组件格式

要设置 PostgreSQL 配置存储，请创建类型为 configuration.postgresql 的组件

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: <NAME>
spec:
  type: configuration.postgresql
  version: v1
  metadata:
    # Connection string
    - name: connectionString
      value: "host=localhost user=postgres password=example port=5432 connect_timeout=10 database=config"
    # Name of the table which holds configuration information
    - name: table
      value: "[your_configuration_table_name]" 
    # Individual connection parameters - can be used instead to override connectionString parameters
    #- name: host
    #  value: "localhost"
    #- name: hostaddr
    #  value: "127.0.0.1"
    #- name: port
    #  value: "5432"
    #- name: database
    #  value: "my_db"
    #- name: user
    #  value: "postgres"
    #- name: password
    #  value: "example"
    #- name: sslRootCert
    #  value: "/path/to/ca.crt"
    # Timeout for database operations, in seconds (optional)
    #- name: timeoutInSeconds
    #  value: 20
    # Name of the table where to store the state (optional)
    #- name: tableName
    #  value: "state"
    # Name of the table where to store metadata used by Dapr (optional)
    #- name: metadataTableName
    #  value: "dapr_metadata"
    # Cleanup interval in seconds, to remove expired rows (optional)
    #- name: cleanupIntervalInSeconds
    #  value: 3600
    # Maximum number of connections pooled by this component (optional)
    #- name: maxConns
    #  value: 0
    # Max idle time for connections before they're closed (optional)
    #- name: connectionMaxIdleTime
    #  value: 0
    # Controls the default mode for executing queries. (optional)
    #- name: queryExecMode
    #  value: ""
    # Uncomment this if you wish to use PostgreSQL as a state store for actors (optional)
    #- name: actorStateStore
    #  value: "true"

规范元数据字段

使用连接字符串进行身份验证

使用 PostgreSQL 连接字符串进行身份验证时，以下元数据选项是必需的。

使用单独的连接参数进行身份验证

除了使用连接字符串外，您还可以选择指定单独的连接参数。这些参数等同于标准 PostgreSQL 连接参数。

使用 Microsoft Entra ID 进行身份验证

支持使用 Microsoft Entra ID 对 Azure Database for PostgreSQL 进行身份验证。可以使用 Dapr 支持的所有身份验证方法，包括客户端凭据（“服务主体”）和托管标识。

使用 AWS IAM 进行身份验证

支持使用 AWS IAM 对所有版本的 PostgreSQL 类型组件进行身份验证。 连接字符串中指定的用户必须是数据库中已存在的用户，并且是被授予 rds_iam 数据库角色的 AWS IAM 启用用户。 身份验证基于 AWS 身份验证配置文件，或提供的 AccessKey/SecretKey。 AWS 身份验证令牌将在其过期时间之前通过 AWS 动态轮换。

其他元数据选项

设置 PostgreSQL 作为配置存储

1. 启动 PostgreSQL 数据库

2. 连接到 PostgreSQL 数据库并按照以下架构设置配置表：

   字段	数据类型	可为空	详情
   KEY	VARCHAR	N	保存配置属性的 "Key"
   VALUE	VARCHAR	N	保存配置属性的 Value
   VERSION	VARCHAR	N	保存配置属性的版本
   METADATA	JSON	Y	将 Metadata 保存为 JSON

   CREATE TABLE IF NOT EXISTS table_name (
     KEY VARCHAR NOT NULL,
     VALUE VARCHAR NOT NULL,
     VERSION VARCHAR NOT NULL,
     METADATA JSON
   );
   

3. 在配置表上创建 TRIGGER。创建 TRIGGER 的示例函数如下：

   CREATE OR REPLACE FUNCTION notify_event() RETURNS TRIGGER AS $$
       DECLARE 
           data json;
           notification json;
   
       BEGIN
   
           IF (TG_OP = 'DELETE') THEN
               data = row_to_json(OLD);
           ELSE
               data = row_to_json(NEW);
           END IF;
   
           notification = json_build_object(
                             'table',TG_TABLE_NAME,
                             'action', TG_OP,
                             'data', data);
           PERFORM pg_notify('config',notification::text);
           RETURN NULL; 
       END;
   $$ LANGUAGE plpgsql;
   

4. 创建触发器，数据封装在标记为 data 的字段中：

   notification = json_build_object(
     'table',TG_TABLE_NAME,
     'action', TG_OP,
     'data', data
   );
   

5. 订阅配置通知时，应使用作为 pg_notify 属性提及的通道

6. 由于这是一个通用创建的触发器，请将此触发器映射到 配置表

   CREATE TRIGGER config
   AFTER INSERT OR UPDATE OR DELETE ON configtable
       FOR EACH ROW EXECUTE PROCEDURE notify_event();
   

7. 在订阅请求中添加一个额外的元数据字段，键为 pgNotifyChannel，值应设置为 pg_notify 中提及的相同 通道名称。根据上面的示例，应将其设置为 config

curl -l 'http://<host>:<dapr-http-port>/configuration/mypostgresql/subscribe?key=<keyname1>&key=<keyname2>&metadata.pgNotifyChannel=<channel name>'

相关链接

• Dapr 组件的基本架构
• 配置构建块

3 - Redis

组件格式

要设置 Redis 配置存储，需创建一个类型为 configuration.redis 的组件。有关如何创建和应用配置存储配置，请参阅此指南。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: <NAME>
spec:
  type: configuration.redis
  version: v1
  metadata:
  - name: redisHost
    value: <address>:6379
  - name: redisPassword
    value: **************
  - name: useEntraID
    value: "true"
  - name: enableTLS
    value: <bool>

规格元数据字段

设置 Redis

Dapr 可以使用任何 Redis 实例：容器化的、在本地开发机器上运行的，或托管的云服务。

• 自托管
• Kubernetes
• AWS
• Azure
• GCP

Redis Sentinel 配置

当使用 Redis Sentinel 实现高可用时，将 redisType 设置为 "node"，使用 failover: "true" 启用故障转移模式，并提供 sentinel 主节点名称。可以在 redisHost 字段中指定多个 sentinel 地址，用逗号分隔，以实现冗余。

```yaml
apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: redis-pubsub
spec:
  type: pubsub.redis
  version: v1
  metadata:
  - name: redisHost
    value: "sentinel1:26379,sentinel2:26379,sentinel3:26379"
  - name: redisType
    value: "node"
  - name: failover
    value: "true"
  - name: sentinelMasterName
    value: "mymaster"
```

相关链接

• Dapr 组件的基本架构
• 阅读如何：从存储管理配置，了解如何将 Redis 用作配置存储的说明。
• 配置构建块