06efc07f46
Almost 100% mechanical change, except the fact that import/import.md is moved to import/README.md No content changes. Signed-off-by: Miek Gieben <miek@miek.nl>
73 lines
1.6 KiB
Groff
73 lines
1.6 KiB
Groff
.\" generated with Ronn/v0.7.3
|
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
|
.
|
|
.TH "COREDNS\-FEDERATION" "7" "January 2019" "CoreDNS" "CoreDNS plugins"
|
|
.
|
|
.SH "NAME"
|
|
\fIfederation\fR \- enables federated queries to be resolved via the kubernetes plugin\.
|
|
.
|
|
.SH "DESCRIPTION"
|
|
Enabling this plugin allows Federated \fIhttps://kubernetes\.io/docs/tasks/federation/federation\-service\-discovery/\fR queries to be resolved via the kubernetes plugin\.
|
|
.
|
|
.P
|
|
Enabling \fIfederation\fR without also having \fIkubernetes\fR is a noop\.
|
|
.
|
|
.SH "SYNTAX"
|
|
.
|
|
.nf
|
|
|
|
federation [ZONES\.\.\.] {
|
|
NAME DOMAIN
|
|
upstream [ADDRESS\.\.\.]
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "\(bu" 4
|
|
Each \fBNAME\fR and \fBDOMAIN\fR defines federation membership\. One entry for each\. A duplicate \fBNAME\fR will silently overwrite any previous value\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBupstream\fR [\fBADDRESS\fR\.\.\.] defines the upstream resolvers used for resolving the \fBCNAME\fR target produced by this plugin\. If no \fBADDRESS\fR is given, CoreDNS will resolve External Services against itself\. \fBADDRESS\fR can be an IP, an IP:port, or a path to a file structured like resolv\.conf\.
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.SH "EXAMPLES"
|
|
Here we handle all service requests in the \fBprod\fR and \fBstage\fR federations\.
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
\&\. {
|
|
kubernetes cluster\.local
|
|
federation cluster\.local {
|
|
prod prod\.feddomain\.com
|
|
staging staging\.feddomain\.com
|
|
upstream
|
|
}
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Or slightly shorter:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
cluster\.local {
|
|
kubernetes
|
|
federation {
|
|
prod prod\.feddomain\.com
|
|
staging staging\.feddomain\.com
|
|
upstream
|
|
}
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
|