Files

95 lines
2.9 KiB
Go

package util
import (
"context"
"fmt"
"os"
"time"
clientv3 "go.etcd.io/etcd/client/v3"
)
const (
// WorkerKeyPrefix ETCD WorkerID 注册键前缀。
WorkerKeyPrefix = "/go-sms/workers/"
// workerLeaseTTL 注册租约时长;依赖 KeepAlive 自动续期,
// 进程退出(client.Close)后约 TTL 内自动释放 WorkerID。
workerLeaseTTL = 60 * time.Second
)
// registrar WorkerID 注册后端抽象(单测注入 mock;生产为 ETCD)。
type registrar interface {
// TryCreate 尝试创建带 TTL 的键;键已存在返回 false。
TryCreate(ctx context.Context, key, value string, ttl time.Duration) (bool, error)
}
// AcquireWorkerID 从注册后端抢注最小的空闲 WorkerID([0, max])。
// 多副本同时启动时,ETCD 事务保证同一 ID 仅被一个持有者抢到。
func AcquireWorkerID(ctx context.Context, reg registrar, max int) (int, error) {
if max < 0 || max > MaxWorkerID {
max = MaxWorkerID
}
host, _ := os.Hostname()
for id := 0; id <= max; id++ {
ok, err := reg.TryCreate(ctx, fmt.Sprintf("%s%d", WorkerKeyPrefix, id), host, workerLeaseTTL)
if err != nil {
return 0, fmt.Errorf("util: 注册 WorkerID 失败: %w", err)
}
if ok {
return id, nil
}
}
return 0, fmt.Errorf("util: 无可用 WorkerID(0..%d 均被占用)", max)
}
// WorkerIDFromETCD 连接 ETCD 抢注 WorkerID(雪花 ID 多实例部署入口)。
// 返回的 client 由调用方持有:持有期间租约自动续期(ID 不被抢走),
// 进程退出时 Close() 即释放(约 TTL 后可被其他实例复用)。
func WorkerIDFromETCD(ctx context.Context, endpoints []string) (int, *clientv3.Client, error) {
cli, err := clientv3.New(clientv3.Config{
Endpoints: endpoints,
DialTimeout: 5 * time.Second,
})
if err != nil {
return 0, nil, fmt.Errorf("util: 连接 ETCD 失败: %w", err)
}
id, err := AcquireWorkerID(ctx, &etcdRegistrar{client: cli}, int(MaxWorkerID))
if err != nil {
_ = cli.Close()
return 0, nil, err
}
return id, cli, nil
}
// etcdRegistrar 基于 ETCD 租约 + 事务的 registrar 实现。
type etcdRegistrar struct {
client *clientv3.Client
}
// TryCreate:Grant 租约 → KeepAlive 自动续期 → Txn 仅当键不存在时写入。
func (r *etcdRegistrar) TryCreate(ctx context.Context, key, value string, ttl time.Duration) (bool, error) {
lease, err := r.client.Grant(ctx, int64(ttl.Seconds()))
if err != nil {
return false, err
}
// 后台续期直至 client 关闭;消费 channel 否则续期会停滞
kach, kerr := r.client.KeepAlive(context.Background(), lease.ID)
if kerr != nil {
return false, kerr
}
go func() {
for range kach { // client.Close 后 channel 关闭,goroutine 退出
}
}()
resp, err := r.client.Txn(ctx).
If(clientv3.Compare(clientv3.CreateRevision(key), "=", 0)).
Then(clientv3.OpPut(key, value, clientv3.WithLease(lease.ID))).
Commit()
if err != nil {
return false, err
}
return resp.Succeeded, nil
}