loadbalance

README

loadbalance

Name

loadbalance - randomize the order of A, AAAA and MX records.

Description

The loadbalance will act as a round-robin DNS loadbalancer by randomizing the order of A, AAAA, and MX records in the answer.

See Wikipedia about the pros and cons on this setup. It will take care to sort any CNAMEs before any address records, because some stub resolver implementations (like glibc) are particular about that.

Syntax

loadbalance [POLICY]

• POLICY is how to balance, the default, and only option, is "round_robin".

Examples

Load balance replies coming back from Google Public DNS:

. {
    loadbalance round_robin
    forward . 8.8.8.8 8.8.4.4
}

Documentation

Overview

Package loadbalance is plugin for rewriting responses to do "load balancing"

Package loadbalance shuffles A, AAAA and MX records.

Index

• type RoundRobin
  • func (rr RoundRobin) Name() string
  • func (rr RoundRobin) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)
• type RoundRobinResponseWriter
  • func (r *RoundRobinResponseWriter) Write(buf []byte) (int, error)
  • func (r *RoundRobinResponseWriter) WriteMsg(res *dns.Msg) error

Types

type RoundRobin

type RoundRobin struct {
	Next plugin.Handler
}

RoundRobin is plugin to rewrite responses for "load balancing".

func (RoundRobin) Name

func (rr RoundRobin) Name() string

Name implements the Handler interface.

func (RoundRobin) ServeDNS

func (rr RoundRobin) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

ServeDNS implements the plugin.Handler interface.

type RoundRobinResponseWriter

type RoundRobinResponseWriter struct{ dns.ResponseWriter }

RoundRobinResponseWriter is a response writer that shuffles A, AAAA and MX records.

func (*RoundRobinResponseWriter) Write

func (r *RoundRobinResponseWriter) Write(buf []byte) (int, error)

Write implements the dns.ResponseWriter interface.

func (*RoundRobinResponseWriter) WriteMsg

func (r *RoundRobinResponseWriter) WriteMsg(res *dns.Msg) error

WriteMsg implements the dns.ResponseWriter interface.