...

Package dnssrv

import "github.com/go-kit/kit/sd/dnssrv"
Overview
Index

Overview ▾

Package dnssrv provides an Instancer implementation for DNS SRV records.

Variables

ErrPortZero is returned by the resolve machinery when a DNS resolver returns an SRV record with its port set to zero.

var ErrPortZero = errors.New("resolver returned SRV record with port 0")

type Instancer

Instancer yields instances from the named DNS SRV record. The name is resolved on a fixed schedule. Priorities and weights are ignored.

type Instancer struct {
    // contains filtered or unexported fields
}

func NewInstancer

func NewInstancer(
    name string,
    ttl time.Duration,
    logger log.Logger,
) *Instancer

NewInstancer returns a DNS SRV instancer.

func NewInstancerDetailed

func NewInstancerDetailed(
    name string,
    refresh *time.Ticker,
    lookup Lookup,
    logger log.Logger,
) *Instancer

NewInstancerDetailed is the same as NewInstancer, but allows users to provide an explicit lookup refresh ticker instead of a TTL, and specify the lookup function instead of using net.LookupSRV.

func (*Instancer) Deregister

func (in *Instancer) Deregister(ch chan<- sd.Event)

Deregister implements Instancer.

func (*Instancer) Register

func (in *Instancer) Register(ch chan<- sd.Event)

Register implements Instancer.

func (*Instancer) Stop

func (in *Instancer) Stop()

Stop terminates the Instancer.

type Lookup

Lookup is a function that resolves a DNS SRV record to multiple addresses. It has the same signature as net.LookupSRV.

type Lookup func(service, proto, name string) (cname string, addrs []*net.SRV, err error)