95 lines
2.9 KiB
Go
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
|
|
}
|