2c418b9fd5
* Fix spelling in coredns.1 and corefile.7 md files * Run make -f Makefile.doc Signed-off-by: Miek Gieben <miek@miek.nl>
60 lines
1.2 KiB
Groff
60 lines
1.2 KiB
Groff
.\" Generated by Mmark Markdown Processer - mmark.nl
|
|
.TH "COREDNS-FEDERATION" 7 "April 2019" "CoreDNS" "CoreDNS Plugins"
|
|
|
|
.SH "NAME"
|
|
.PP
|
|
\fIfederation\fP - enables federated queries to be resolved via the kubernetes plugin.
|
|
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
Enabling this plugin allows
|
|
Federated
|
|
\[la]https://kubernetes.io/docs/tasks/federation/federation-service-discovery/\[ra] queries to be
|
|
resolved via the kubernetes plugin.
|
|
|
|
.PP
|
|
Enabling \fIfederation\fP without also having \fIkubernetes\fP is a noop.
|
|
|
|
.SH "SYNTAX"
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
federation [ZONES...] {
|
|
NAME DOMAIN
|
|
upstream
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.IP \(bu 4
|
|
Each \fBNAME\fP and \fBDOMAIN\fP defines federation membership. One entry for each. A duplicate
|
|
\fBNAME\fP will silently overwrite any previous value.
|
|
.IP \(bu 4
|
|
\fB\fCupstream\fR resolve the \fB\fCCNAME\fR target produced by this plugin. CoreDNS
|
|
will resolve External Services against itself and needs the \fIforward\fP plugin to be active to do
|
|
so.
|
|
|
|
|
|
.SH "EXAMPLES"
|
|
.PP
|
|
Here we handle all service requests in the \fB\fCprod\fR and \fB\fCstage\fR federations.
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
\&. {
|
|
kubernetes cluster.local
|
|
federation cluster.local {
|
|
prod prod.feddomain.com
|
|
staging staging.feddomain.com
|
|
upstream
|
|
}
|
|
forward . 192.168.1.12
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|