Files
go-sms-V2/internal/config/etcd_watcher.go
T

109 lines
3.2 KiB
Go

package config
import (
"context"
"fmt"
"strings"
"time"
clientv3 "go.etcd.io/etcd/client/v3"
"go.uber.org/zap"
)
// ETCDWatcher 配置热更新(Day 12):监听 ETCD prefix,变更即全量合并并回调。
//
// 键模型(prefix 下每个键对应一个配置项,/ 转为 . 层级):
//
// /config/go-sms/log/level = debug → log.level=debug
// /config/go-sms/rate_limit/capacity=5 → rate_limit.capacity=5
//
// 变更策略:任一 put/delete 触发全量重拉 prefix → 覆盖加载 → 校验 → 回调;
// 校验失败保留旧配置并告警(不会带病生效)。
type ETCDWatcher struct {
client *clientv3.Client
prefix string
source string // 底稿配置文件路径
reload func(cfg *Config)
logger *zap.Logger
lastSnap string // 上次覆盖集快照(变更检测,轮询幂等)
}
// NewETCDWatcher 创建 watcher;reload 在每次成功合并后回调(异步 goroutine 中调用)。
func NewETCDWatcher(client *clientv3.Client, prefix, sourcePath string, reload func(*Config), lg *zap.Logger) *ETCDWatcher {
if lg == nil {
lg = zap.NewNop()
}
return &ETCDWatcher{client: client, prefix: prefix, source: sourcePath, reload: reload, logger: lg}
}
// Run 阻塞监听直至 ctx 取消:watch 实时事件 + 5s 兜底轮询(防 watch 静默失联)。
func (w *ETCDWatcher) Run(ctx context.Context) error {
w.apply(ctx, "startup")
ticker := time.NewTicker(5 * time.Second) // 兜底轮询:变更检测幂等
defer ticker.Stop()
ch := w.client.Watch(ctx, w.prefix, clientv3.WithPrefix())
for {
select {
case <-ctx.Done():
return nil
case <-ticker.C:
w.apply(ctx, "poll")
case resp, ok := <-ch:
if !ok || resp.Canceled { // watch 通道断开:重建
w.logger.Warn("etcd_watch_disconnected_retrying")
select {
case <-ctx.Done():
return nil
case <-time.After(3 * time.Second):
}
ch = w.client.Watch(ctx, w.prefix, clientv3.WithPrefix())
w.apply(ctx, "rewatch")
continue
}
if len(resp.Events) > 0 {
w.apply(ctx, "watch")
}
}
}
}
// apply 全量拉取 prefix → 覆盖加载 → 校验 → 回调。
func (w *ETCDWatcher) apply(ctx context.Context, trigger string) {
getCtx, cancel := context.WithTimeout(ctx, 5*time.Second)
resp, err := w.client.Get(getCtx, w.prefix, clientv3.WithPrefix())
cancel()
if err != nil {
w.logger.Warn("etcd_config_get_failed", zap.String("trigger", trigger), zap.Error(err))
return
}
if len(resp.Kvs) == 0 {
return // 无覆盖键:保持文件配置
}
overrides := make(map[string]string, len(resp.Kvs))
for _, kv := range resp.Kvs {
key := strings.TrimPrefix(string(kv.Key), w.prefix)
key = strings.TrimSuffix(strings.ReplaceAll(key, "/", "."), ".")
overrides[key] = string(kv.Value)
}
// 变更检测:快照一致则跳过(轮询幂等,不重复回调/刷日志)
snap := fmt.Sprint(overrides)
if snap == w.lastSnap {
return
}
cfg, err := LoadWithOverrides(w.source, overrides)
if err != nil {
w.logger.Warn("etcd_config_invalid_keep_old", zap.String("trigger", trigger), zap.Error(err))
return
}
w.lastSnap = snap
w.reload(cfg)
w.logger.Info("config_reloaded",
zap.String("trigger", trigger), zap.Int("override_keys", len(overrides)))
}
// fmt 保持引用(键规范化注释)。