Redis

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

组件格式

要配置 Redis 锁，需要创建一个类型为 lock.redis 的组件。请参阅本指南了解如何创建锁。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: lock.redis
 version: v1
 metadata:
 - name: redisHost
 value: <HOST>
 - name: redisPassword #可选。
 value: <PASSWORD>
 - name: useEntraID
 value: <bool> # 可选。允许值：true, false。
 - name: enableTLS
 value: <bool> # 可选。允许值：true, false。
 - name: failover
 value: <bool> # 可选。允许值：true, false。
 - name: sentinelMasterName
 value: <string> # 可选
 - name: maxRetries
 value: # 可选
 - name: maxRetryBackoff
 value: # 可选
 - name: failover
 value: # 可选
 - name: sentinelMasterName
 value: # 可选
 - name: redeliverInterval
 value: # 可选
 - name: processingTimeout
 value: # 可选
 - name: redisType
 value: # 可选
 - name: redisDB
 value: # 可选
 - name: redisMaxRetries
 value: # 可选
 - name: redisMinRetryInterval
 value: # 可选
 - name: redisMaxRetryInterval
 value: # 可选
 - name: dialTimeout
 value: # 可选
 - name: readTimeout
 value: # 可选
 - name: writeTimeout
 value: # 可选
 - name: poolSize
 value: # 可选
 - name: poolTimeout
 value: # 可选
 - name: maxConnAge
 value: # 可选
 - name: minIdleConns
 value: # 可选
 - name: idleCheckFrequency
 value: # 可选
 - name: idleTimeout
 value: # 可选

警告

上面的示例中，secret 是以明文字符串形式使用的。建议使用 secret 存储来保存这些 secret，如此处所述。

规格元数据字段

字段	必需	详细信息	示例
redisHost	Y	Redis 主机的连接字符串	`localhost:6379`, `redis-master.default.svc.cluster.local:6379`
redisPassword	N	Redis 主机的密码。无默认值。可以是 `secretKeyRef` 以使用 secret 引用	`""`, `"KeFg23!"`
redisUsername	N	Redis 主机的用户名。默认为空。确保您的 Redis 服务器版本为 6 或更高，并正确创建了 ACL 规则。	`""`, `"default"`
useEntraID	N	为 Azure Cache for Redis 实现 EntraID 支持。启用此功能之前： `redisHost` 名称必须以 `"server:port"` 的形式指定必须启用 TLS 在创建 Redis 实例 > Azure Cache for Redis下了解有关此设置的更多信息	`"true"`, `"false"`
enableTLS	N	如果 Redis 实例支持带有公共证书的 TLS，可以配置为启用或禁用。默认为 `"false"`	`"true"`, `"false"`
maxRetries	N	放弃前的最大重试次数。默认为 `3`	`5`, `10`
maxRetryBackoff	N	每次重试之间的最大退避时间。默认为 `2` 秒；`"-1"` 禁用退避。	`3000000000`
failover	N	启用故障转移配置的属性。需要设置 sentinelMasterName。redisHost 应为哨兵主机地址。请参阅 Redis Sentinel 文档。默认为 `"false"`	`"true"`, `"false"`
sentinelMasterName	N	哨兵主名称。请参阅 Redis Sentinel 文档	`"mymaster"`
redeliverInterval	N	检查待处理消息以重新传递的间隔。默认为 `"60s"`。`"0"` 禁用重新传递。	`"30s"`
processingTimeout	N	消息必须待处理的时间量，然后才尝试重新传递。默认为 `"15s"`。`"0"` 禁用重新传递。	`"30s"`
redisType	N	Redis 的类型。有两个有效值，一个是单节点模式的 `"node"`，另一个是 Redis 集群模式的 `"cluster"`。默认为 `"node"`。	`"cluster"`
redisDB	N	连接到 Redis 后选择的数据库。如果 `"redisType"` 是 `"cluster"`，此选项将被忽略。默认为 `"0"`。	`"0"`
redisMaxRetries	N	`maxRetries` 的别名。如果同时设置了两个值，则忽略 `maxRetries`。	`"5"`
redisMinRetryInterval	N	Redis 命令每次重试之间的最小退避时间。默认为 `"8ms"`；`"-1"` 禁用退避。	`"8ms"`
redisMaxRetryInterval	N	`maxRetryBackoff` 的别名。如果同时设置了两个值，则忽略 `maxRetryBackoff`。	`"5s"`
dialTimeout	N	建立新连接的拨号超时时间。默认为 `"5s"`。	`"5s"`
readTimeout	N	套接字读取的超时时间。如果达到，Redis 命令将因超时而失败，而不是阻塞。默认为 `"3s"`，`"-1"` 表示无超时。	`"3s"`
writeTimeout	N	套接字写入的超时时间。如果达到，Redis 命令将因超时而失败，而不是阻塞。默认为 readTimeout。	`"3s"`
poolSize	N	最大套接字连接数。默认是每个 CPU 10 个连接，由 runtime.NumCPU 报告。	`"20"`
poolTimeout	N	如果所有连接都忙，客户端在返回错误前等待连接的时间量。默认是 readTimeout + 1 秒。	`"5s"`
maxConnAge	N	客户端退役（关闭）连接的连接年龄。默认是不关闭老化连接。	`"30m"`
minIdleConns	N	为避免与创建新连接相关的性能下降，保持打开的最小空闲连接数。默认为 `"0"`。	`"2"`
idleCheckFrequency	N	空闲连接清理器进行空闲检查的频率。默认为 `"1m"`。`"-1"` 禁用空闲连接清理器。	`"-1"`
idleTimeout	N	客户端关闭空闲连接的时间量。应小于服务器的超时时间。默认为 `"5m"`。`"-1"` 禁用空闲超时检查。	`"10m"`

设置 Redis

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

锁组件规格 on Dapr 文档库

Redis

组件格式

警告

规格元数据字段

设置 Redis