mirror of
https://github.com/coredns/coredns.git
synced 2025-11-01 10:43:17 -04:00
f8aa208cc0
Mmark recently became able to create manual pages. This removed the dependency on 'ronn' and just uses mmark (Go program). Re-hookup Makefile.doc to generate the correct header mmark needs to see and regenate them all. Spot checking a few pages suggest they look good and actually better than rendered with ronn, esp. lists in lists. Fixes #2757 Signed-off-by: Miek Gieben <miek@miek.nl>
50 lines
950 B
Groff
50 lines
950 B
Groff
.\" Generated by Mmark Markdown Processer - mmark.nl
|
|
.TH "COREDNS-LOADBALANCE" "7" "April 2019" "CoreDNS" "CoreDNS Plugins"
|
|
|
|
.SH LOADBALANCE
|
|
.SH NAME
|
|
.PP
|
|
\fIloadbalance\fP - randomize the order of A, AAAA and MX records.
|
|
|
|
.SH DESCRIPTION
|
|
.PP
|
|
The \fIloadbalance\fP will act as a round-robin DNS loadbalancer by randomizing the order of A, AAAA,
|
|
and MX records in the answer.
|
|
|
|
.PP
|
|
See Wikipedia
|
|
\[la]https://en.wikipedia.org/wiki/Round-robin_DNS\[ra] 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.
|
|
|
|
.SH SYNTAX
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
loadbalance [POLICY]
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.IP \(bu 4
|
|
\fBPOLICY\fP is how to balance, the default, and only option, is "round_robin".
|
|
|
|
|
|
.SH EXAMPLES
|
|
.PP
|
|
Load balance replies coming back from Google Public DNS:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
\&. {
|
|
loadbalance round\_robin
|
|
forward . 8.8.8.8 8.8.4.4
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|