.\" Generated by Mmark Markdown Processer - mmark.nl
.TH "COREDNS-FEDERATION" 7 "July 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
}

.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.


.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
    }
    forward . 192.168.1.12
}

.fi
.RE