340 lines
7.2 KiB
Go
340 lines
7.2 KiB
Go
|
package redis
|
||
|
|
||
|
import (
|
||
|
"errors"
|
||
|
"net"
|
||
|
"strings"
|
||
|
"sync"
|
||
|
"time"
|
||
|
|
||
|
"github.com/go-redis/redis/internal"
|
||
|
"github.com/go-redis/redis/internal/pool"
|
||
|
)
|
||
|
|
||
|
//------------------------------------------------------------------------------
|
||
|
|
||
|
// FailoverOptions are used to configure a failover client and should
|
||
|
// be passed to NewFailoverClient.
|
||
|
type FailoverOptions struct {
|
||
|
// The master name.
|
||
|
MasterName string
|
||
|
// A seed list of host:port addresses of sentinel nodes.
|
||
|
SentinelAddrs []string
|
||
|
|
||
|
// Following options are copied from Options struct.
|
||
|
|
||
|
OnConnect func(*Conn) error
|
||
|
|
||
|
Password string
|
||
|
DB int
|
||
|
|
||
|
MaxRetries int
|
||
|
|
||
|
DialTimeout time.Duration
|
||
|
ReadTimeout time.Duration
|
||
|
WriteTimeout time.Duration
|
||
|
|
||
|
PoolSize int
|
||
|
PoolTimeout time.Duration
|
||
|
IdleTimeout time.Duration
|
||
|
IdleCheckFrequency time.Duration
|
||
|
}
|
||
|
|
||
|
func (opt *FailoverOptions) options() *Options {
|
||
|
return &Options{
|
||
|
Addr: "FailoverClient",
|
||
|
|
||
|
OnConnect: opt.OnConnect,
|
||
|
|
||
|
DB: opt.DB,
|
||
|
Password: opt.Password,
|
||
|
|
||
|
MaxRetries: opt.MaxRetries,
|
||
|
|
||
|
DialTimeout: opt.DialTimeout,
|
||
|
ReadTimeout: opt.ReadTimeout,
|
||
|
WriteTimeout: opt.WriteTimeout,
|
||
|
|
||
|
PoolSize: opt.PoolSize,
|
||
|
PoolTimeout: opt.PoolTimeout,
|
||
|
IdleTimeout: opt.IdleTimeout,
|
||
|
IdleCheckFrequency: opt.IdleCheckFrequency,
|
||
|
}
|
||
|
}
|
||
|
|
||
|
// NewFailoverClient returns a Redis client that uses Redis Sentinel
|
||
|
// for automatic failover. It's safe for concurrent use by multiple
|
||
|
// goroutines.
|
||
|
func NewFailoverClient(failoverOpt *FailoverOptions) *Client {
|
||
|
opt := failoverOpt.options()
|
||
|
opt.init()
|
||
|
|
||
|
failover := &sentinelFailover{
|
||
|
masterName: failoverOpt.MasterName,
|
||
|
sentinelAddrs: failoverOpt.SentinelAddrs,
|
||
|
|
||
|
opt: opt,
|
||
|
}
|
||
|
|
||
|
c := Client{
|
||
|
baseClient: baseClient{
|
||
|
opt: opt,
|
||
|
connPool: failover.Pool(),
|
||
|
|
||
|
onClose: func() error {
|
||
|
return failover.Close()
|
||
|
},
|
||
|
},
|
||
|
}
|
||
|
c.baseClient.init()
|
||
|
c.setProcessor(c.Process)
|
||
|
|
||
|
return &c
|
||
|
}
|
||
|
|
||
|
//------------------------------------------------------------------------------
|
||
|
|
||
|
type sentinelClient struct {
|
||
|
cmdable
|
||
|
baseClient
|
||
|
}
|
||
|
|
||
|
func newSentinel(opt *Options) *sentinelClient {
|
||
|
opt.init()
|
||
|
c := sentinelClient{
|
||
|
baseClient: baseClient{
|
||
|
opt: opt,
|
||
|
connPool: newConnPool(opt),
|
||
|
},
|
||
|
}
|
||
|
c.baseClient.init()
|
||
|
c.cmdable.setProcessor(c.Process)
|
||
|
return &c
|
||
|
}
|
||
|
|
||
|
func (c *sentinelClient) PubSub() *PubSub {
|
||
|
return &PubSub{
|
||
|
opt: c.opt,
|
||
|
|
||
|
newConn: func(channels []string) (*pool.Conn, error) {
|
||
|
return c.newConn()
|
||
|
},
|
||
|
closeConn: c.connPool.CloseConn,
|
||
|
}
|
||
|
}
|
||
|
|
||
|
func (c *sentinelClient) GetMasterAddrByName(name string) *StringSliceCmd {
|
||
|
cmd := NewStringSliceCmd("SENTINEL", "get-master-addr-by-name", name)
|
||
|
c.Process(cmd)
|
||
|
return cmd
|
||
|
}
|
||
|
|
||
|
func (c *sentinelClient) Sentinels(name string) *SliceCmd {
|
||
|
cmd := NewSliceCmd("SENTINEL", "sentinels", name)
|
||
|
c.Process(cmd)
|
||
|
return cmd
|
||
|
}
|
||
|
|
||
|
type sentinelFailover struct {
|
||
|
sentinelAddrs []string
|
||
|
|
||
|
opt *Options
|
||
|
|
||
|
pool *pool.ConnPool
|
||
|
poolOnce sync.Once
|
||
|
|
||
|
mu sync.RWMutex
|
||
|
masterName string
|
||
|
_masterAddr string
|
||
|
sentinel *sentinelClient
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) Close() error {
|
||
|
return d.resetSentinel()
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) Pool() *pool.ConnPool {
|
||
|
d.poolOnce.Do(func() {
|
||
|
d.opt.Dialer = d.dial
|
||
|
d.pool = newConnPool(d.opt)
|
||
|
})
|
||
|
return d.pool
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) dial() (net.Conn, error) {
|
||
|
addr, err := d.MasterAddr()
|
||
|
if err != nil {
|
||
|
return nil, err
|
||
|
}
|
||
|
return net.DialTimeout("tcp", addr, d.opt.DialTimeout)
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) MasterAddr() (string, error) {
|
||
|
d.mu.Lock()
|
||
|
defer d.mu.Unlock()
|
||
|
|
||
|
addr, err := d.masterAddr()
|
||
|
if err != nil {
|
||
|
return "", err
|
||
|
}
|
||
|
|
||
|
if d._masterAddr != addr {
|
||
|
d.switchMaster(addr)
|
||
|
}
|
||
|
|
||
|
return addr, nil
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) masterAddr() (string, error) {
|
||
|
// Try last working sentinel.
|
||
|
if d.sentinel != nil {
|
||
|
addr, err := d.sentinel.GetMasterAddrByName(d.masterName).Result()
|
||
|
if err == nil {
|
||
|
addr := net.JoinHostPort(addr[0], addr[1])
|
||
|
internal.Logf("sentinel: master=%q addr=%q", d.masterName, addr)
|
||
|
return addr, nil
|
||
|
}
|
||
|
|
||
|
internal.Logf("sentinel: GetMasterAddrByName name=%q failed: %s", d.masterName, err)
|
||
|
d._resetSentinel()
|
||
|
}
|
||
|
|
||
|
for i, sentinelAddr := range d.sentinelAddrs {
|
||
|
sentinel := newSentinel(&Options{
|
||
|
Addr: sentinelAddr,
|
||
|
|
||
|
DialTimeout: d.opt.DialTimeout,
|
||
|
ReadTimeout: d.opt.ReadTimeout,
|
||
|
WriteTimeout: d.opt.WriteTimeout,
|
||
|
|
||
|
PoolSize: d.opt.PoolSize,
|
||
|
PoolTimeout: d.opt.PoolTimeout,
|
||
|
IdleTimeout: d.opt.IdleTimeout,
|
||
|
})
|
||
|
|
||
|
masterAddr, err := sentinel.GetMasterAddrByName(d.masterName).Result()
|
||
|
if err != nil {
|
||
|
internal.Logf("sentinel: GetMasterAddrByName master=%q failed: %s", d.masterName, err)
|
||
|
sentinel.Close()
|
||
|
continue
|
||
|
}
|
||
|
|
||
|
// Push working sentinel to the top.
|
||
|
d.sentinelAddrs[0], d.sentinelAddrs[i] = d.sentinelAddrs[i], d.sentinelAddrs[0]
|
||
|
d.setSentinel(sentinel)
|
||
|
|
||
|
addr := net.JoinHostPort(masterAddr[0], masterAddr[1])
|
||
|
return addr, nil
|
||
|
}
|
||
|
|
||
|
return "", errors.New("redis: all sentinels are unreachable")
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) switchMaster(masterAddr string) {
|
||
|
internal.Logf(
|
||
|
"sentinel: new master=%q addr=%q",
|
||
|
d.masterName, masterAddr,
|
||
|
)
|
||
|
_ = d.Pool().Filter(func(cn *pool.Conn) bool {
|
||
|
return cn.RemoteAddr().String() != masterAddr
|
||
|
})
|
||
|
d._masterAddr = masterAddr
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) setSentinel(sentinel *sentinelClient) {
|
||
|
d.discoverSentinels(sentinel)
|
||
|
d.sentinel = sentinel
|
||
|
go d.listen(sentinel)
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) resetSentinel() error {
|
||
|
var err error
|
||
|
d.mu.Lock()
|
||
|
if d.sentinel != nil {
|
||
|
err = d._resetSentinel()
|
||
|
}
|
||
|
d.mu.Unlock()
|
||
|
return err
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) _resetSentinel() error {
|
||
|
err := d.sentinel.Close()
|
||
|
d.sentinel = nil
|
||
|
return err
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) discoverSentinels(sentinel *sentinelClient) {
|
||
|
sentinels, err := sentinel.Sentinels(d.masterName).Result()
|
||
|
if err != nil {
|
||
|
internal.Logf("sentinel: Sentinels master=%q failed: %s", d.masterName, err)
|
||
|
return
|
||
|
}
|
||
|
for _, sentinel := range sentinels {
|
||
|
vals := sentinel.([]interface{})
|
||
|
for i := 0; i < len(vals); i += 2 {
|
||
|
key := vals[i].(string)
|
||
|
if key == "name" {
|
||
|
sentinelAddr := vals[i+1].(string)
|
||
|
if !contains(d.sentinelAddrs, sentinelAddr) {
|
||
|
internal.Logf(
|
||
|
"sentinel: discovered new sentinel=%q for master=%q",
|
||
|
sentinelAddr, d.masterName,
|
||
|
)
|
||
|
d.sentinelAddrs = append(d.sentinelAddrs, sentinelAddr)
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
func (d *sentinelFailover) listen(sentinel *sentinelClient) {
|
||
|
var pubsub *PubSub
|
||
|
for {
|
||
|
if pubsub == nil {
|
||
|
pubsub = sentinel.PubSub()
|
||
|
|
||
|
if err := pubsub.Subscribe("+switch-master"); err != nil {
|
||
|
internal.Logf("sentinel: Subscribe failed: %s", err)
|
||
|
pubsub.Close()
|
||
|
d.resetSentinel()
|
||
|
return
|
||
|
}
|
||
|
}
|
||
|
|
||
|
msg, err := pubsub.ReceiveMessage()
|
||
|
if err != nil {
|
||
|
if err != pool.ErrClosed {
|
||
|
internal.Logf("sentinel: ReceiveMessage failed: %s", err)
|
||
|
pubsub.Close()
|
||
|
}
|
||
|
d.resetSentinel()
|
||
|
return
|
||
|
}
|
||
|
|
||
|
switch msg.Channel {
|
||
|
case "+switch-master":
|
||
|
parts := strings.Split(msg.Payload, " ")
|
||
|
if parts[0] != d.masterName {
|
||
|
internal.Logf("sentinel: ignore addr for master=%q", parts[0])
|
||
|
continue
|
||
|
}
|
||
|
addr := net.JoinHostPort(parts[3], parts[4])
|
||
|
|
||
|
d.mu.Lock()
|
||
|
if d._masterAddr != addr {
|
||
|
d.switchMaster(addr)
|
||
|
}
|
||
|
d.mu.Unlock()
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
func contains(slice []string, str string) bool {
|
||
|
for _, s := range slice {
|
||
|
if s == str {
|
||
|
return true
|
||
|
}
|
||
|
}
|
||
|
return false
|
||
|
}
|