用途:Edge Config 把 JSON 配置存放在 S3,按固定节奏轮询进服务器内存,让服务端行为可在运行时调整,无需重新部署,典型场景包括负载削减、功能灰度和运维开关。每个配置有独立 S3 文件,位于 admin 存储桶的 admin/ 前缀下,彼此隔离,一个解析失败不影响其他配置。
主要能力:通过 createEdgeConfigStore<T> 工厂提供通用的 S3 读写、轮询与状态跟踪;提供配置注册表 registerEdgeConfig、startAllEdgeConfigPolling、stopAllEdgeConfigPolling;get() 同步读取内存缓存、无 I/O;refresh() 重新拉取;writeToSource() 写 S3 并立即更新本地缓存;getStatus() 返回健康与时间信息。已有配置示例:请求拦截,S3 键为 admin/request-block-config.json。
使用方式:新增配置需定义 Zod schema,创建 store 模块并调用 registerEdgeConfig,在 init.ts 加入副作用导入,可选在 adminS3Config.ts 增加键常量,随后在业务代码中读取。启动时每个 store 先 await refresh() 完成首次 S3 拉取,再用 setInterval 按 pollIntervalMs 轮询,随后才接收流量;关闭时清除所有定时器。写好配置后可通过 writeToSource 写入 S3。
限制与行为:任何 S3 失败(网络、鉴权、错误 JSON、schema 不匹配)都会把运行时配置重置为 defaultValue(),不会保留陈旧数据;NoSuchKey 视为正常空状态而非错误。这种失败开放设计保证基础设施故障不会阻塞请求,S3 不可用时配置退化为默认的安全空状态。单元测试可通过 s3Client 依赖注入注入 mock。具体价格与收费资料暂未提供。