50 lines
1.4 KiB
Go
50 lines
1.4 KiB
Go
// Package valkey connects to the Valkey session store.
|
|
//
|
|
// Timeouts are constants: every authenticated request reads a session, so
|
|
// they bound how long a request can wait when the store is slow. Command
|
|
// retries are disabled and a connection is dialled once for the same reason:
|
|
// a request that cannot reach the store fails fast with 503 instead of
|
|
// waiting through a backoff. On the compose stand Docker DNS takes seconds
|
|
// to give up on a stopped container, so one dial attempt is already bounded
|
|
// only by dialTimeout.
|
|
package valkey
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
"time"
|
|
|
|
"github.com/redis/go-redis/v9"
|
|
)
|
|
|
|
const (
|
|
dialTimeout = time.Second
|
|
ioTimeout = time.Second
|
|
poolSize = 10
|
|
noRetries = -1
|
|
singleAttempt = 1
|
|
)
|
|
|
|
// NewClient connects to url (redis:// scheme) and pings the server. Errors
|
|
// never include the URL, which carries the password.
|
|
func NewClient(ctx context.Context, url string) (*redis.Client, error) {
|
|
opts, err := redis.ParseURL(url)
|
|
if err != nil {
|
|
return nil, errors.New("session store url is invalid")
|
|
}
|
|
opts.DialTimeout = dialTimeout
|
|
opts.ReadTimeout = ioTimeout
|
|
opts.WriteTimeout = ioTimeout
|
|
opts.PoolSize = poolSize
|
|
opts.MaxRetries = noRetries
|
|
opts.DialerRetries = singleAttempt
|
|
|
|
client := redis.NewClient(opts)
|
|
if err := client.Ping(ctx).Err(); err != nil {
|
|
_ = client.Close()
|
|
return nil, fmt.Errorf("ping session store at %s: %w", opts.Addr, err)
|
|
}
|
|
return client, nil
|
|
}
|